Event Notifications CLI

A interface de linha de comando (CLI) do IBM Cloud oferece recursos adicionais para ofertas de serviços. A CLI do IBM Cloud suporta uma estrutura de plug-ins para ampliar sua capacidade. É possível instalar o plug-in da CLI do Event Notifications por meio do repositório de plug-ins da IBM Cloud. Com o plug-in da CLI do serviço “ Event Notifications ”, você pode gerenciar facilmente as instâncias do serviço “ Event Notifications ” usando os comandos da CLI disponíveis.

Pré-requisitos

Ao acessar o site IBM Cloud CLI, você será notificado quando houver atualizações disponíveis. Certifique-se de manter a CLI atualizada para que seja possível usar os comandos e sinalizadores que estão disponíveis para o plug-in da CLI do Event Notifications.

Cartão de referência rápida IBM Cloud.

Observação: as versões do plugin CLI anteriores à 1.15.2 estão obsoletas

Instalar a CLI do Event Notifications

Instale o plug-in da CLI do Event Notifications usando o comando plugin install .

ibmcloud plugin install en

Event Notifications Comandos da CLI

Observação O comando CLI Plugin init será preterido no futuro

ibmcloud en en-list

Lista as instâncias na região de destino definida. Você pode recuperar o GUID da sua instância a partir das instâncias listadas.

ibmcloud en en-list

ibmcloud event-notifications environment variables set

Defina a região na qual você trabalhará configurando a região de destino do IBM Cloud (ibmcloud target -r ) ou exportando o endpoint regional por meio da variável IBMCLOUD_EN_ENDPOINT; por exemplo, use o seguinte para Sydney:

  • exportar IBMCLOUD_EN_ENDPOINT= https://au-syd.event-notifications.cloud.ibm.com/event-notifications

  • Exporte a variável IBMCLOUD_EN_ENDPOINT para definir o endpoint público da região Event Notifications.

    • Dallas: https://us-south.event-notifications.cloud.ibm.com/event-notifications
    • Londres: https://eu-gb.event-notifications.cloud.ibm.com/event-notifications
    • Sydney: https://au-syd.event-notifications.cloud.ibm.com/event-notifications
    • Frankfurt: https://eu-de.event-notifications.cloud.ibm.com/event-notifications
    • Madri: https://eu-es.event-notifications.cloud.ibm.com/event-notifications
    • Osaka: https://jp-osa.event-notifications.cloud.ibm.com/event-notifications
    • Tóquio: https://jp-tok.event-notifications.cloud.ibm.com/event-notifications
    • Toronto: https://ca-tor.event-notifications.cloud.ibm.com/event-notifications
    • São Paulo: https://br-sao.event-notifications.cloud.ibm.com/event-notifications
    • Montreal: https://ca-mon.event-notifications.cloud.ibm.com/event-notifications
    • Washington, D.C.: https://us-east.event-notifications.cloud.ibm.com/event-notifications
    • Chennai: https://in-che.event-notifications.cloud.ibm.com/event-notifications
    • Mumbai: https://in-mum.event-notifications.cloud.ibm.com/event-notifications
  • Exporte a variável IBMCLOUD_EN_ENDPOINT para definir o endpoint privado da região Event Notifications.

    • Dallas: https://private.us-south.event-notifications.cloud.ibm.com/event-notifications
    • Londres: https://private.eu-gb.event-notifications.cloud.ibm.com/event-notifications
    • Sydney: https://private.au-syd.event-notifications.cloud.ibm.com/event-notifications
    • Frankfurt: https://private.eu-de.event-notifications.cloud.ibm.com/event-notifications
    • Madri: https://private.eu-es.event-notifications.cloud.ibm.com/event-notifications
    • Osaka: https://private.jp-osa.event-notifications.cloud.ibm.com/event-notifications
    • Tóquio: https://private.jp-tok.event-notifications.cloud.ibm.com/event-notifications
    • Toronto: https://private.ca-tor.event-notifications.cloud.ibm.com/event-notifications
    • São Paulo: https://private.br-sao.event-notifications.cloud.ibm.com/event-notifications
    • Montreal: https://private.ca-mon.event-notifications.cloud.ibm.com/event-notifications
    • Washington, D.C.: https://private.us-east.event-notifications.cloud.ibm.com/event-notifications
    • Chennai: https://private.in-che.event-notifications.cloud.ibm.com/event-notifications
    • Mumbai: https://private.in-mum.event-notifications.cloud.ibm.com/event-notifications
  • Exporte a variável EVENT_NOTIFICATIONS_API_KEY para configurar a instância do Event Notifications apikey.

EVENT_NOTIFICATIONS_API_KEY pode ser sua chave API IBM Cloud ou a chave API de credenciais de serviço da sua instância Event Notifications.

Origens

Operar na IBM Cloud Event Notifications fonte.

ibmcloud event-notifications source create

  • Ação: Criar Source.

Atualmente, a CLI oferece suporte apenas à criação de fontes de API.

ibmcloud event-notifications sources-create --instance-id INSTANCE-ID --name NAME [--description DESCRIPTION] [--enabled ENABLED] [--store-notifications STORE-NOTIFICATIONS]
  • Parâmetros a serem fornecidos:
--instance-id INSTANCE-ID (string)

O identificador exclusivo da IBM Cloud instância Event Notifications. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

--name NAME (int64)

O nome a ser fornecido para a fonte da API.

O valor padrão é . O comprimento máximo é de 255 es caracteres. O comprimento mínimo é de 1 es caracteres. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*()]*/.

--description DESCRIPTION (string)

A descrição para a origem. Opcional.

O valor padrão é ``. O comprimento máximo é 255 caracteres. O comprimento mínimo é de 0 caracteres. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*()]*/.

--enabled ENABLED (booleano)

O sinalizador booleano para ativar ou desativar a fonte. Opcional.

O valor é definido como true para ativar a fonte e false para desativar a fonte.

--store-notifications (bool)

Habilitar a visualização da carga útil dos eventos recebidos para fins de solução de problemas.

O valor padrão é false.

ibmcloud event-notifications source update

  • Ação: Atualizar Source.
ibmcloud event-notifications source-update --instance-id INSTANCE-ID --id ID [--name NAME] [--description DESCRIPTION] [--enabled ENABLED] [--store-notifications STORE-NOTIFICATIONS]
  • Parâmetros a serem fornecidos:
--instance-id (string)

Identificador exclusivo da IBM Cloud instância Event Notifications. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

--name (int64)

Nome da fonte da API.

O valor padrão é ``. O comprimento máximo é 255 caracteres. O comprimento mínimo é de 1 caracteres. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*()]*/.

--description (int64)

Fonte da API Descrição

O valor padrão é ``. O comprimento máximo é 255 caracteres. O comprimento mínimo é de 0 caracteres. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*()]*/.

--enabled (booleano)

Sequência de pesquisa para filtragem de resultados.

O valor é definido como true para ativar a fonte e false para desativar a fonte.

--store-notifications (bool)

permite visualizar a carga útil dos eventos de entrada para solução de problemas.

O valor padrão é false.

--id (string)

Identificador único para a Origem. Obrigatório.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z0-9-:_]*/.

ibmcloud event-notifications source list

  • Ação: Listar todos os Source.
ibmcloud event-notifications sources [--limit LIMIT] [--offset OFFSET] [--search SEARCH] --instance-id INSTANCE-ID
  • Parâmetros a serem fornecidos:
--limit LIMIT (int64)

O limite de página para resultados paginados.

O valor máximo é 100. O valor mínimo é 1.

--offset OFFSET (int64)

O deslocamento para resultados paginados.

O valor mínimo é 0.

--search SEARCH (string)

A sequência de pesquisa para filtragem de resultados.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 0 caracteres. O valor deve corresponder à expressão regular /[a-zA-Z0-9]/.

--instance-id INSTANCE-ID (string)

O identificador exclusivo da IBM Cloud instância Event Notifications. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

[--force]

Ative para forçar a exclusão de recursos (para ignorar o prompt de confirmação).

ibmcloud event-notifications source get

  • Ação: Seja específico Source.
ibmcloud event-notifications source --id ID --instance-id INSTANCE-ID
  • Parâmetros a serem fornecidos:
--id ID (string)

Identificador único para a Origem. Obrigatório.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z0-9-:_]*/.

--offset OFFSET

O deslocamento para resultados paginados.

--search SEARCH

A sequência de pesquisa para filtragem de resultados.

--instance-id INSTANCE-ID (string)

O identificador exclusivo da IBM Cloud instância Event Notifications. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

[--force]

Ative para forçar a exclusão de recursos (para ignorar o prompt de confirmação).

ibmcloud event-notifications source delete

  • Ação: Excluir o site específico Source.
ibmcloud event-notifications source-delete  --instance-id INSTANCE-ID --id ID
  • Parâmetros a serem fornecidos:
--id ID (string)

Identificador único para a Origem. Obrigatório.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z0-9-:_]*/.

--instance-id INSTANCE-ID (string)

O identificador exclusivo da IBM Cloud instância Event Notifications. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

[--force]

Ative para forçar a exclusão de recursos (para ignorar o prompt de confirmação).

Destinos

Operar em IBM Cloud Event Notifications destination.

ibmcloud event-notifications destination create

  • Ação: Criar um destino.
ibmcloud event-notifications destination-create --instance-id INSTANCE-ID --name NAME --type TYPE [--description DESCRIPTION] [--collect-failed-events COLLECT-FAILED-EVENTS] [--config CONFIG] [--certificate CERTIFICATE] [--certificate-content-type CERTIFICATE-CONTENT-TYPE] [--icon16x16 ICON16X16] [--icon16x16-content-type ICON16X16-CONTENT-TYPE] [--icon16x162x ICON16X162X] [--icon16x162x-content-type ICON16X162X-CONTENT-TYPE] [--icon32x32 ICON32X32] [--icon32x32-content-type ICON32X32-CONTENT-TYPE] [--icon32x322x ICON32X322X] [--icon32x322x-content-type ICON32X322X-CONTENT-TYPE] [--icon128x128 ICON128X128] [--icon128x128-content-type ICON128X128-CONTENT-TYPE] [--icon128x1282x ICON128X1282X] [--icon128x1282x-content-type ICON128X1282X-CONTENT-TYPE]
  • Parâmetros a serem fornecidos:
--instance-id (string)

O identificador exclusivo da IBM Cloud instância Event Notifications.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

--name NAME (string)

O nome do destino. Obrigatório.

O comprimento máximo é de 255 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/.

--type TYPE (string)

O tipo do destino. As opções disponíveis são webhook, push_android, push_ios, push_chrome, push_firefox, push_huawei, push_safari, ibmce, ibmcos, msteams, pagerduty, servicenow, slack, smtp_custom, sms_custom, event_streams. Obrigatório.

Os valores permitidos são: webhook, push_android, push_ios,push_chrome,push_firefox,push_huawei,push_safari,ibmce, ibmcos,msteams,pagerduty,servicenow,slack,smtp_custom,sms_custom,event_streams. O comprimento mínimo é de 1 caractere.

--collect-failed-events (bool)

Se deve coletar o evento de falha no bucket Cloud Object Storage.

O valor padrão é false.

--description DESCRIPTION (string)

A descrição do destino.

O valor padrão é . O comprimento máximo é de 255 es caracteres. O comprimento mínimo é de 0 es caracteres. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/.

--certificate CERTIFICATE (string)

O caminho do arquivo de certificado a ser fornecido. O tipo de arquivo permitido é o certificado p8 e p12. Forneça o local do arquivo para passar o certificado.

--certificate-content-type CERTIFICATE-CONTENT-TYPE (string)

O tipo de conteúdo do certificado a ser configurado no caso do destino IOS. O valor padrão é ``. As opções disponíveis são: p8 ou p12.

--config CONFIG ( DestinationConfig exemplos )

A configuração necessária para definir os parâmetros específicos do destino.

Se você criar um destino sem um --config, o destino será criado, mas não funcionará até que você o configure.

--icon16x16 (io.ReadCloser)
Ícone do Safari 16x16.

O comprimento máximo é de 5000 caracteres. O comprimento mínimo é de 1 caractere.

--icon16x16-content-type (string)

O tipo de conteúdo do Icon16x16.

--icon16x162x (io.ReadCloser)

Ícone do Safari 16x16@2x.

The maximum length is 5000 characters. The minimum length is 1 character.

--icon16x162x-content-type (string)

O tipo de conteúdo do Icon16x162x.

--icon32x32 (io.ReadCloser)

Ícone do Safari 32x32.

The maximum length is 5000 characters. The minimum length is 1 character.

--icon32x32-content-type (string)

O tipo de conteúdo do Icon32x32.

--icon32x322x (io.ReadCloser)

Ícone do Safari 32x32@2x.

The maximum length is 5000 characters. The minimum length is 1 character.

--icon32x322x-content-type (string)

O tipo de conteúdo do Icon32x322x.

--icon128x128 (io.ReadCloser)

Ícone do Safari 128x128.

The maximum length is 5000 characters. The minimum length is 1 character.

--icon128x128-content-type (string)

O tipo de conteúdo de Icon128x128.

--icon128x1282x (io.ReadCloser)

Ícone do Safari 128x128@2x.

The maximum length is 5000 characters. The minimum length is 1 character.

--icon128x1282x-content-type (string)

O tipo de conteúdo do Icon128x1282x.

{
   "params" : {
      "url" : "exampleString",
      "verb" : "get",
      "custom_headers" : { },
      "sensitive_headers" : [ "exampleString" ]
   }
}

Observação: o Event Notifications Destination Cloud Functions foi descontinuado e não é mais compatível com a categoria de destinos.

Exemplos

  • O exemplo a seguir mostra o formato do objeto DestinationConfig para o destino iOS (push_ios) com o certificado P8. Defina o parâmetro booleano pre_prod como true para configurar o destino como destino de pré-produção; caso contrário, defina o valor como false:
   {
      "params" : {
         "cert_type" : "p8",
         "is_sandbox" : true,
         "key_id": "production",
         "team_id": "1234",
         "bundle_id": "test1",
         "pre_prod" : "true" // Set to true in case of configuring Destination as pre-prod Destination (pre_prod destination can only be configured for Standard plan)
      }
   }
   ```


- O exemplo a seguir mostra o formato do objeto ` `DestinationConfig` ` para o destino ` iOS ` (push_ios) com o certificado ` P12 `. Defina o parâmetro booleano `pre_prod` como *true* para configurar o destino como destino de pré-produção; caso contrário, defina o valor como *false*.

```json
   {
      "params" : {
         "cert_type" : "p12",
         "is_sandbox" : true,
         "password": "apnspasswordvalue",
         "pre_prod" : "true" true // Set to true in case of configuring Destination as pre-prod Destination (pre_prod destination can only be configured for Standard plan)
      }
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `DestinationConfig` ` para o destino Chrome (push_chrome). Defina o parâmetro booleano `pre_prod` como *true* para configurar o destino como destino de pré-produção; caso contrário, defina o valor como *false*.

```json
   {
      "params" : {
         "api_key": "chromeapikey",
         "website_url" : "https://testwebsite.com",
         "pre_prod" : "true" true // Set to true in case of configuring Destination as pre-prod Destination (pre_prod destination can only be configured for Standard plan)
      }
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `DestinationConfig` ` para o destino ` Firefox ` (push_firefox). Defina o parâmetro booleano `pre_prod` como *true* para configurar o destino como destino de pré-produção; caso contrário, defina o valor como *false*.

```json
   {
      "params" : {
         "website_url" : "https://testwebsite.com",
         "pre_prod" : "true" // Set to true in case of configuring Destination as pre-prod Destination (pre_prod destination can only be configured for Standard plan)
      }
   }
   ```

- O exemplo a seguir mostra o formato do objeto `DestinationConfig` para o destino Slack (slack) com o tipo incoming_webhook.

```json
   {
      "params" : {
         "type" : "incoming_webhook",
         "url" : "https://hooks.slack.com/services/G0gyhsush/TYodsjhs/GHTbfidsimkk"
      }
   }
   ```

- O exemplo a seguir mostra o formato do objeto `DestinationConfig` para o destino Slack (slack) com o tipo direct_message.

```json
   {
      "params" : {
         "type" : "direct_message",
         "token" : "vhdwvecwefwefewivcweivcwiwiciwcvwicwec"
      }
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `DestinationConfig` ` para o destino Safari (`push_safari`). Defina o parâmetro booleano `pre_prod` como *true* para configurar o destino como destino de pré-produção; caso contrário, defina o valor como *false*.

```json
   {
      "params": {
         "cert_type":"p12",
         "certificate_name":"Users/Testuser/Documents/safari.p12",
         "password":"safarinew",
         "url_format_string":"https://test.com",
         "website_name":"testwebsite",
         "website_push_id":"test",
         "website_url":"https://test.com",
         "pre_prod" : "true" // Set to true in case of configuring Destination as pre-prod Destination (pre_prod destination can only be configured for Standard plan)
      }
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `DestinationConfig` ` para o destino MS Teams (msteams).

```json
   {
      "params" : {
         "url" : "https://xyz.webhook.office.com"
      }
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `DestinationConfig` ` para o destino ` PagerDuty(pagerduty )`.

   Recomenda-se usar apenas a chave Routing ao criar o destino. A chave da API está obsoleta e não estará disponível para uso no futuro.
   {: attention}

   ```json
   {
      "params" : {
         "routing_key" : "routingkeytoconnecttoPD",
         "api_key" : "cffunctionnamespaceserviceidapikey"
      }
   }
   ```


- O exemplo a seguir mostra o formato do objeto ` `DestinationConfig` ` para o Webhook (webhook).

```json
   {
      "params" : {
         "url" : "exampleString",
         "verb" : "get",
         "custom_headers" : { },
         "sensitive_headers" : [ "exampleString" ]
      }
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `DestinationConfig` ` para o destino Android (push_android).

```json
   {
      "params" : {
         "project_id" : "6232305230320",
         "private_key" : "36e21epfweort823or8rt832pr8p2r832pr82pr382r8f",
         "client_email" : "testuser.123@gmail.com",
         "pre_prod" : true // Set to true in case of configuring Destination as pre-prod Destination (pre_prod destination can only be configured for Standard plan)
      }
   }
   ```


- O exemplo a seguir mostra o formato do objeto ` `DestinationConfig` ` para o destino ` ServiceNow(servicenow )`.

```json
   {
      "params" : {
         "client_id" : "359705ceddd100eyfewyyw1f0f9e1c96",
         "client_secret": "testsecrets",
         "username": "testuser",
         "password": "user_password",
         "instance_name": "testinstancenje"
      }
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `DestinationConfig` ` para o destino ` Code Engine ` (ibmce).

   código motor tipo de destino: aplicativo

   ```json
   {
      "params" : {
         "type" : "application",
         "url" : "https://codeengine.test.com",
         "verb" : "get",
         "custom_headers" : { },
         "sensitive_headers" : [ "exampleString" ]
      }
   }
   ```

   código engine destination type: job

   ```json
   {
      "params" : {
         "type" : "job",
         "job_name" : "custom-job",
         "project_crn" : "crn:v1:bluemix:public:codeengine:us-south:a/e7e5820aeccb40efb78fd69a7858ef23:xxxxxxxxxxxxxx::"
      }
   }
   ```


- O exemplo a seguir mostra o formato do objeto ` `DestinationConfig` ` para o destino ` IBM Cloud Object Storage ` (ibmcos).

```json
   {
      "params" : {
         "bucket_name" : "cos-destination-en-bucket",
         "instance_id" : "42e13636e-0548-41a0-a178-e95be28464773",
         "endpoint" : "https://s3.us-west.cloud-object-storage.appdomain.cloud"
      }
   }
   ```


- O exemplo a seguir mostra o formato do objeto ` `DestinationConfig` ` para o destino Huawei (push_huawei).

```json
   {
      "params" : {
         "client_id" : "359705ceddd100eyfew",
         "client_secret": "testsecrets",
         "pre_prod" : true // Set to true in case of configuring Destination as pre-prod Destination (pre_prod destination can only be configured for Standard plan)
      }
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `DestinationConfig` ` para o destino “E-mail personalizado” (smtp_custom). No caso do destino Custom Email Sandbox (smtp_custom_sandbox), os parâmetros de Destination Configuration não são necessários.

   Processo Para fazer a configuração e a verificação do domínio personalizado: <https://cloud.ibm.com/docs/event-notifications?topic=event-notifications-en-destinations-custom-email#en-destinations-custom-email-verify>

   ```json
   {
      "params" : {
         "domain": "mailx.com"
      }
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `DestinationConfig` ` para o destino ` Event Streams ` (event_streams).

```json
   {
      "params" : {
        "crn": "crn:v1:bluemix:public:messagehub:us-south:a/9f007405a9fe4a5d9345fa8c13357373:a292db6e-af78-4c0b-b3db-7d6794b637g::",
        "endpoint": "https://n6627w6t7dgeh2cfgd.svc09.us-south.eventstreams.cloud.ibm.com",
        "topic": "demo_topic"
      }
   }
   ```

- O exemplo a seguir mostra o formato do objeto “ `DestinationConfig` ” para o destino “ App Configuration ” (app_configuration).

```json
   {
      "params" : {
        "type": "features",
        "crn": "crn:v1:bluemix:public:apprapp:us-south:a/4a74f2c31f554afc88156b73a1d577c6:dbxxxx93-0xxa-4xx5-axcf-c2faxxxd::",
        "environment_id": "stage",
        "feature_id": "test"
      }
   }
   ```

Observação: É possível criar um destino de SMS personalizado sem um “ `DestinationConfig` ”, mas ele não funcionará até que os números personalizados necessários sejam explicitamente solicitados e configurados. Para solicitar números personalizados, consulte “[Números personalizados para SMS](/docs/event-notifications?topic=event-notifications-en-destinations-sms-custom#en-destinations-sms-custom-numbers) ”.

### ibmcloud event-notifications destination list {: #en-cli-destination-list-command}

- **Ação:** Listar todos os `Destination`.

```sh {: pre}
ibmcloud event-notifications destinations [--limit LIMIT] [--offset OFFSET] [--search SEARCH] --instance-id INSTANCE-ID
  • Parâmetros a serem fornecidos:
--limit LIMIT (int64)

O limite de página para resultados paginados.

O valor máximo é 100. O valor mínimo é 1.

--offset OFFSET (int64)

O deslocamento para resultados paginados.

O valor mínimo é 0.

--search SEARCH (string)

A sequência de pesquisa para filtragem de resultados.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 0 caracteres. O valor deve corresponder à expressão regular /[a-zA-Z0-9]/.

--instance-id (string)

O identificador exclusivo da IBM Cloud instância Event Notifications.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

ibmcloud event-notifications destination get

  • Ação: Seja específico Destination.
ibmcloud event-notifications destination --id ID --instance-id INSTANCE-ID
  • Parâmetros a serem fornecidos:
--id ID (string)

O identificador exclusivo para destino. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

--instance-id INSTANCE-ID (string)

O identificador exclusivo da IBM Cloud instância Event Notifications. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

ibmcloud event-notifications destination update

  • Ação: Atualizar o arquivo existente Destination.
ibmcloud event-notifications destination-update --instance-id INSTANCE-ID --id ID [--name NAME] [--description DESCRIPTION] [--collect-failed-events COLLECT-FAILED-EVENTS] [--config CONFIG] [--certificate CERTIFICATE] [--certificate-content-type CERTIFICATE-CONTENT-TYPE] [--icon16x16 ICON16X16] [--icon16x16-content-type ICON16X16-CONTENT-TYPE] [--icon16x162x ICON16X162X] [--icon16x162x-content-type ICON16X162X-CONTENT-TYPE] [--icon32x32 ICON32X32] [--icon32x32-content-type ICON32X32-CONTENT-TYPE] [--icon32x322x ICON32X322X] [--icon32x322x-content-type ICON32X322X-CONTENT-TYPE] [--icon128x128 ICON128X128] [--icon128x128-content-type ICON128X128-CONTENT-TYPE] [--icon128x1282x ICON128X1282X] [--icon128x1282x-content-type ICON128X1282X-CONTENT-TYPE]
  • Parâmetros a serem fornecidos:
--instance-id (string)
Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.
O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador único para o Destino. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

--name (string)

Nome do Destino.

O comprimento máximo é de 255 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/.

--description (string)

Descrição do Destino.

O comprimento máximo é de 255 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/.

--collect-failed-events (bool)

Se deve coletar o evento de falha no bucket Cloud Object Storage.

O valor padrão é false.

--config (DestinationConfig)

Carga útil descrevendo uma configuração de destino.

Forneça uma opção de cadeia de caracteres JSON ou especifique um arquivo JSON para leitura, fornecendo uma opção de caminho de arquivo que comece com @, por exemplo, --config=@path/to/file.json.

--certificate (io.ReadCloser)

Certificado para APNS.

O comprimento máximo é de 5000 caracteres. O comprimento mínimo é de 1 caractere.

--certificate-content-type (string)

O tipo de conteúdo do Certificado.

--icon16x16 (io.ReadCloser)

Ícone do Safari 16x16.

O comprimento máximo é de 5000 caracteres. O comprimento mínimo é de 1 caractere.

--icon16x16-content-type (string)

O tipo de conteúdo do Icon16x16.

--icon16x162x (io.ReadCloser)

Ícone do Safari 16x16@2x.

O comprimento máximo é de 5000 caracteres. O comprimento mínimo é de 1 caractere.

--icon16x162x-content-type (string)

O tipo de conteúdo do Icon16x162x.

--icon32x32 (io.ReadCloser)

Ícone do Safari 32x32.

O comprimento máximo é de 5000 caracteres. O comprimento mínimo é de 1 caractere.

--icon32x32-content-type (string)

O tipo de conteúdo do Icon32x32.

--icon32x322x (io.ReadCloser)

Ícone do Safari 32x32@2x.

O comprimento máximo é de 5000 caracteres. O comprimento mínimo é de 1 caractere.

--icon32x322x-content-type (string)

O tipo de conteúdo do Icon32x322x.

--icon128x128 (io.ReadCloser)

Ícone do Safari 128x128.

O comprimento máximo é de 5000 caracteres. O comprimento mínimo é de 1 caractere.

--icon128x128-content-type (string)

O tipo de conteúdo de Icon128x128.

--icon128x1282x (io.ReadCloser)

Ícone do Safari 128x128@2x.

O comprimento máximo é de 5000 caracteres. O comprimento mínimo é de 1 caractere.

--icon128x1282x-content-type (string)

O tipo de conteúdo do Icon128x1282x.

ibmcloud event-notifications destination delete

  • Ação: Excluir o arquivo existente Destination``.
ibmcloud event-notifications destination-delete --id ID --instance-id INSTANCE-ID [--force]
  • Parâmetros a serem fornecidos:
--id ID (string)

O identificador exclusivo para destino. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

--instance-id INSTANCE-ID (string)

O identificador exclusivo da IBM Cloud instância Event Notifications. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

[--force] (booleano)

Ative para forçar a exclusão de recursos (para ignorar o prompt de confirmação).

ibmcloud event-notifications enabled-countries

Obter detalhes do país habilitado do destino do SMS.

ibmcloud event-notifications enabled-countries --instance-id INSTANCE-ID --id ID

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador único para o Destino. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

Exemplo

ibmcloud event-notifications enabled-countries \
    --instance-id=exampleString \
    --id=exampleString

ibmcloud event-notifications test-destination

Teste um destino.

ibmcloud event-notifications test-destination --instance-id INSTANCE-ID --id ID

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador único para o Destino. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

Exemplo

ibmcloud event-notifications test-destination \
    --instance-id=exampleString \
    --id=exampleString

ibmcloud event-notifications email-sandbox-destination-update

Atualize o destino da sandbox para produção com domínio personalizado.

ibmcloud event-notifications email-sandbox-destination-update --instance-id INSTANCE-ID --id ID --domain DOMAIN

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `32` caracteres. O comprimento mínimo é de `32` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/`.
--id (string)

Identificador único para o Destino. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$/.

--domain (string)

Domínio de e-mail. Obrigatório.

O comprimento máximo é de 250 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /.*/.

Exemplo

ibmcloud event-notifications email-sandbox-destination-update \
    --instance-id=exampleString \
    --id=exampleString \
    --domain=exampleString

ibmcloud event-notifications verify-destination-update

Verifique os registros SPF e DKIM do domínio personalizado.

ibmcloud event-notifications verify-destination-update --instance-id INSTANCE-ID --id ID --type TYPE

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador único para o Destino. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

--type (string)

Tipo de verificação. Obrigatório.

O comprimento máximo é de 20 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-z]/.

Exemplo

ibmcloud event-notifications verify-destination-update \
    --instance-id exampleString \
    --id exampleString \
    --type exampleString

Tópicos

Operar no tópico IBM Cloud tópico Event Notifications.

ibmcloud event-notifications topic create

  • Ação: Criar um novo Topic.
ibmcloud event-notifications topic-create --name NAME [--description DESCRIPTION] [--sources SOURCES] --instance-id INSTANCE-ID
  • Parâmetros a serem fornecidos:
--name NAME (string)

Nome do tópico. Obrigatório.

O comprimento máximo é de 255 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*()]*/.

--description DESCRIPTION (string)

Descrição do tópico.

O valor padrão é ``. O comprimento máximo é 255 caracteres. O comprimento mínimo é de 0 caracteres. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*()]*/.

--instance-id INSTANCE-ID (string)

Identificador exclusivo da IBM Cloud instância Event Notifications. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

[--sources SOURCES] (TopicCreateSourcesItem[])

Lista de fontes com suas configurações de filtro a serem anexadas a este tópico. Esta não é apenas uma lista de IDs de fonte — cada entrada inclui o ID da fonte e as regras de filtragem que determinam quais eventos dessa fonte são encaminhados para este tópico. Consulte os exemplos para ver a estrutura completa.

Exemplo

  • O exemplo a seguir mostra o formato do objeto TopicCreateSourcesItem[] para a fonte Periodic Timer.
    [
       {
          "id" : "exampleString",
          "rules" : [
             {
                "enabled" : true,
                "event_schedule_filter": {
                   "starts_at": "2024-12-23T12:00:00.000Z",
                   "ends_at": "2024-12-23T20:00:00.000Z",
                   "expression": "* * * * *"
                   }
             }
          ]
       }
    ]
   ```

- O exemplo a seguir mostra o formato do objeto ` `TopicCreateSourcesItem[]` `.

```json
   [
      {
         "id" : "exampleString",
         "rules" : [
            {
               "enabled" : true,
               "event_type_filter" : "$.*",
               "notification_filter" : "exampleString"
            }
         ]
      }
   ]
   ```

- O exemplo a seguir mostra o formato do objeto ` `TopicUpdateSourcesItem[]` `.

```json
   [
      {
         "id" : "exampleString",
         "rules" : [
            {
               "enabled" : true,
               "event_type_filter": "$.notification_event_info.event_type == \'cert_manager\'",
               "notification_filter" : "$.notification.findings[0].severity == \'MODERATE\'",
               "rule_id" : "exampleString"
            }
         ]
      }
   ]
   ```

### ibmcloud event-notifications topic list {: #en-cli-topic-list-command}

- **Ação:** Listar todos os `Topic`.

```sh {: pre}
ibmcloud event-notifications topics [--limit LIMIT] [--offset OFFSET] [--search SEARCH] --instance-id INSTANCE-ID
  • Parâmetros a serem fornecidos:
--limit LIMIT (int64)

O limite de página para resultados paginados.

O valor máximo é 100. O valor mínimo é 1.

--offset OFFSET (int64)

O deslocamento para resultados paginados.

O valor mínimo é 0.

--search SEARCH (string)

A sequência de pesquisa para filtragem de resultados.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 0 caracteres. O valor deve corresponder à expressão regular /[a-zA-Z0-9]/.

--instance-id INSTANCE-ID (string)

O identificador exclusivo da IBM Cloud instância Event Notifications. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

ibmcloud event-notifications topic get

  • Ação: Seja específico Topic.
ibmcloud event-notifications topic --id ID [--include INCLUDE] --instance-id INSTANCE-ID
  • Parâmetros a serem fornecidos:
--id ID (string)

Identificador único para o Tópico. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--include INCLUDE (string)

Incluir subtópicos.

O valor padrão é ``. O comprimento máximo é 20 caracteres. O comprimento mínimo é de 0 caracteres. O valor deve corresponder à expressão regular /[a-z]/.

--instance-id INSTANCE-ID (string)

O identificador exclusivo da IBM Cloud instância Event Notifications. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

ibmcloud event-notifications topic update

  • Ação: Atualizar o arquivo existente Topic.
ibmcloud event-notifications topic-replace --id ID [--name NAME] [--description DESCRIPTION] [--sources SOURCES] --instance-id INSTANCE-ID
  • Parâmetros a serem fornecidos:
--instance-id (string)

Identificador exclusivo da IBM Cloud instância Event Notifications.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

--id (string)

Identificador único para o Tópico. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--name (string)

Nome do tópico.

O comprimento máximo é de 255 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*()]*/.

--description (string)

Descrição do tópico.

O valor padrão é ``. O comprimento máximo é 255 caracteres. O comprimento mínimo é de 0 caracteres. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*()]*/.

--sources (TopicUpdateSourcesItem[])

Lista de novas fontes com suas configurações de filtro a serem adicionadas a este tópico. Esta não é apenas uma lista de IDs de fonte — cada entrada inclui o ID da fonte e as regras de filtragem que determinam quais eventos dessa fonte são encaminhados para este tópico. Consulte os exemplos para ver a estrutura completa.

Essa opção adiciona apenas novas fontes. As fontes já associadas ao tópico não podem ser substituídas nem atualizadas — elas só podem ser excluídas e adicionadas novamente. Para modificar os filtros de origem, remova primeiro a origem do tópico e, em seguida, adicione-a novamente com a nova configuração do filtro.

ibmcloud event-notifications topic delete

  • Ação: Excluir o arquivo existente Topic``.
ibmcloud event-notifications topic-delete --id ID --instance-id INSTANCE-ID [--force]
  • Parâmetros a serem fornecidos:
--id ID (string)

Identificador único para o Tópico. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--instance-id INSTANCE-ID (string)

O identificador exclusivo da IBM Cloud instância Event Notifications. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

[--force] (booleano)

Ative para forçar a exclusão de recursos (para ignorar o prompt de confirmação).

Assinaturas

Operar com a assinatura IBM Cloud assinatura Event Notifications.

ibmcloud event-notifications subscription create

  • Ação: Criar um novo Subscription.
ibmcloud event-notifications subscription-create --instance-id INSTANCE-ID --name NAME --destination-id DESTINATION-ID --topic-id TOPIC-ID [--description DESCRIPTION] [--attributes ATTRIBUTES]
  • Parâmetros a serem fornecidos:
--name NAME (string)

O nome a ser configurado para Assinatura.

O comprimento máximo é de 50 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/.

--instance-id INSTANCE-ID (string)

O identificador exclusivo da IBM Cloud instância Event Notifications.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

--description DESCRIPTION (string)

A descrição a ser definida para Assinatura.

O valor padrão é ``. O comprimento máximo é 255 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/.

--destination-id DESTINATION-ID (string)

O ID de destino a ser definido para assinatura.

O comprimento máximo é de 150 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--topic-id TOPIC-ID (string)

O ID de tópico a ser configurado para assinatura.

O comprimento máximo é de 150 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--attributes ATTRIBUTES (SubscriptionCreateAttributes)

Os atributos a serem definidos para a assinatura.

Exemplos

  • O exemplo a seguir mostra o formato do objeto SubscriptionCreateAttributes para o webhook.
   {
      "signing_enabled" : true,
      "template_id_notification": "a59f6e38-7a48-xxxx-b665-3724axx58b13"
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `SubscriptionCreateAttributes` ` para SMS.

```json
   {
      "invited" :["+1xxxxxxxxxx", "+1xxxxxxxxxx"]
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `SubscriptionCreateAttributes` ` para um e-mail do tipo ` IBM `.

```json
   {
      "invited" :["entest@gmail.com"],
      "add_notification_payload": true,
      "reply_to_mail": "en@ibm.com",
      "reply_to_name": "EYS ORG",
      "from_name":"ABC ORG"
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `SubscriptionCreateAttributes` ` para o destino do Slack com o tipo `incoming_webhook`.

```json
   {
      "attachment_color" : "#FF0000",
      "template_id_notification": "a59f6e38-7a48-xxxx-b665-3724axx58b13",
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `SubscriptionCreateAttributes` ` para o tipo de destino do Slack como `direct_message`.

```json
{
   "channels" : [{ "id": "GHIUIFJHGGH"},{"id": "TSFDIDFOFNF"}],
   "template_id_notification": "a59f6e38-7a48-xxxx-b665-3724axx58b13",
}
  • O exemplo a seguir mostra o formato do objeto SubscriptionCreateAttributes para ServiceNow.
   {
      "assigned_to" : "serviceuser@gmail.com",
      "assignment_group" : "incidentgroup"
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `SubscriptionCreateAttributes` ` para e-mails personalizados.

```json
   {
      "invited" :["entest@gmail.com"],
      "add_notification_payload": true,
      "reply_to_mail": "en@ibm.com",
      "reply_to_name": "EYS ORG",
   }
   ```
- O exemplo a seguir mostra o formato do objeto `SubscriptionCreateAttributes` para o Custom Email Sandbox.

```json
   {
      "invited" :["entest@gmail.com"],
      "add_notification_payload": true,
      "reply_to_mail": "en@ibm.com",
      "reply_to_name": "EYS ORG",
      "from_name":"ABC ORG",
      "from_email":"Testuser@mailx.com",
      "template_id_notification": "a59f6e38-7a48-xxxx-b665-3724afc58b13",
      "template_id_invitation": "f1ef32fb-b7dd-4405-xxxx-7b6719cee8aa"
   }
   ```
   - O exemplo a seguir mostra o formato do objeto ` `SubscriptionCreateAttributes` ` para o Pagerduty/ Event Streams.

   ```json
   {
      "template_id_notification": "a59f6e38-7a48-xxxx-b665-3724afc58b13",
   }
   ```
   - O exemplo a seguir mostra o formato do objeto ` `SubscriptionCreateAttributes` ` para ` App Configuration `. Ao criar ou atualizar uma assinatura para um destino **App Configuration** destino, o objeto `attributes` tem uma regra específica:
      - Você deve **incluir **`feature_flag_enabled` **ou **`template_id_notification`
      - **Não** é possível incluir as duas propriedades ao mesmo tempo

      Isso garante que seja criada uma assinatura para o caso de uso correto — seja **para avaliação de sinalizadores de recurso**, seja **para criação de modelos de notificação**, mas não para ambos ao mesmo tempo.

   ```json
   {
      "template_id_notification": "e40843c8-xxxx-4717-xxxx-f923f2786a34",
   }
   ```
   ```json
   {
      "feature_flag_enabled": false,
   }
   ```

### ibmcloud event-notifications subscription list {: #en-cli-subscription-list-command}

- **Ação:** Listar todos os `Subscription`.

```sh {: pre}
ibmcloud event-notifications subscriptions [--offset OFFSET] [--limit LIMIT] [--search SEARCH] --instance-id INSTANCE-ID
  • Parâmetros a serem fornecidos:
--limit LIMIT (int64)

O limite de página para resultados paginados.

O valor máximo é 100. O valor mínimo é 1.

--offset OFFSET (int64)

O deslocamento para resultados paginados.

O valor mínimo é 0.

--search SEARCH (string)

A sequência de pesquisa para filtragem de resultados.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 0 caracteres. O valor deve corresponder à expressão regular /[a-zA-Z0-9]/.

--instance-id INSTANCE-ID (string)

O identificador exclusivo da IBM Cloud instância Event Notifications. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

ibmcloud event-notifications subscription get

  • Ação: Seja específico Subscription.
ibmcloud event-notifications subscription --id ID --instance-id INSTANCE-ID
  • Parâmetros a serem fornecidos:
--id ID (string)

Identificador único para a Assinatura. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--instance-id INSTANCE-ID (string)

O identificador exclusivo da IBM Cloud instância Event Notifications. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

ibmcloud event-notifications subscription delete

  • Ação: Excluir o arquivo existente Subscription``.
ibmcloud event-notifications subscription-delete --id ID --instance-id INSTANCE-ID [--force]
  • Parâmetros a serem fornecidos:
--id ID (string)

Identificador único para a Assinatura. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--instance-id INSTANCE-ID (string)

O identificador exclusivo da IBM Cloud instância Event Notifications. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

[--force] (booleano)

Ative para forçar a exclusão de recursos (para ignorar o prompt de confirmação).

ibmcloud event-notifications subscription update

  • Ação: Atualizar o arquivo existente Subscription.
ibmcloud event-notifications subscription-update --instance-id INSTANCE-ID --id ID [--name NAME] [--description DESCRIPTION] [--attributes ATTRIBUTES]
  • Parâmetros a serem fornecidos:
--id ID (string)

Identificador único para a Assinatura. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

[--name NAME] (string)

A descrição atualizada a ser definida para Assinatura.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z0-9-:_]*/.

--instance-id INSTANCE-ID (string)

O identificador exclusivo da IBM Cloud instância Event Notifications. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/.

[--description DESCRIPTION] (string)

A descrição atualizada a ser definida para Assinatura.

O valor padrão é ``. O comprimento máximo é 100 caracteres. O comprimento mínimo é de 0 caracteres. O valor deve corresponder à expressão regular /[a-zA-Z0-9-:_]*/.

[-attributes ATTRIBUTES] (SubscriptionUpdateAttributes)

Os atributos a serem configurados para assinatura

Exemplos

  • O exemplo a seguir mostra o formato do objeto SubscriptionUpdateAttributes para o Webhook.
   {
      "signing_enabled": true
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `SubscriptionUpdateAttributes` ` para uma mensagem SMS do ` IBM `.

```json
   {
      "invited": {
         "add": ["+8xxxxxxxxxx"],
         "remove": ["+1xxxxxxxxxx", "+91xxxxxxxxxx"]
      },
      "subscribed": {
         "remove": ["+1xxxxxxxxxx", "+91xxxxxxxxxx"]
      },
      "unsubscribed": {
         "remove": ["+1xxxxxxxxxx", "+91xxxxxxxxxx"]
      }
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `SubscriptionUpdateAttributes` ` para um e-mail do tipo ` IBM `.

```json
   {
      "invited": {
         "add": ["example1@gmail.com"],
         "remove": []
      },
      "subscribed": {
         "remove": ["example2@gmail.com"]
      },
      "unsubscribed": {
         "remove": ["example3@gmail.com"]
      },
      "reply_to_mail": "example@ibm.com",
      "reply_to_name": "USA news",
      "from_name": "IBM",
      "add_notification_payload": true
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `SubscriptionUpdateAttributes` ` para e-mails personalizados.

```json
   {
      "invited": {
         "add": ["example1@gmail.com"],
         "remove": []
      },
      "subscribed": {
         "remove": ["example2@gmail.com"]
      },
      "unsubscribed": {
         "remove": ["example3@gmail.com"]
      },
      "reply_to_mail": "example@ibm.com",
      "reply_to_name": "USA news",
      "from_name": "IBM",
      "from_email": "test@email.com",
      "add_notification_payload": true,
      "template_id_notification": "a59f6e38-7a48-xxxx-b665-3724afc58b13",
      "template_id_invitation": "f1ef32fb-b7dd-4405-xxxx-7b6719cee8aa"
   }
   ```

- O exemplo a seguir mostra o formato do objeto `SubscriptionUpdateAttributes` para o Custom Email Sandbox.

```json
   {
      "invited": {
         "add": ["example1@gmail.com"],
         "remove": []
      },
      "subscribed": {
         "remove": ["example2@gmail.com"]
      },
      "unsubscribed": {
         "remove": ["example3@gmail.com"]
      },
      "reply_to_mail": "example@ibm.com",
      "reply_to_name": "USA news",
      "add_notification_payload": true,
      "template_id_notification": "a59f6e38-7a48-xxxx-b665-3724afc58b13",
      "template_id_invitation": "f1ef32fb-b7dd-4405-xxxx-7b6719cee8aa"
   }
   ```

- O exemplo a seguir mostra o formato do objeto `SubscriptionUpdateAttributes` do Slack para o tipo `incoming_webhook`.

```json
   {
      "attachment_color" : "#FF0000",
      "template_id_notification": "a59f6e38-7a48-xxxx-b665-3724axx58b13",
   }
   ```

- O exemplo a seguir mostra o formato do objeto `SubscriptionUpdateAttributes` do Slack para o tipo `direct_message`.

```json
   {
      "channels": [{"id": "D01CFDTYBH", "operation": "add"}, {"id": "D01GHUTYBH", "operation": "remove"}],
      "template_id_notification": "a59f6e38-7a48-xxxx-b665-3724axx58b13",
   }
   ```

- O exemplo a seguir mostra o formato do objeto ` `SubscriptionUpdateAttributes` ` para o ServiceNow.

```json
   {
      "assigned_to" : "serviceuser@gmail.com",
      "assignment_group" : "incidentgroup"
   }
   ```

   - O exemplo a seguir mostra o formato do objeto ` `SubscriptionUpdateAttributes` ` para o Pagerduty/ Event Streams.

   ```json
   {
      "template_id_notification": "a59f6e38-7a48-xxxx-b665-3724axx58b13",
   }
   ```

   - O exemplo a seguir mostra o formato do objeto ` `SubscriptionCreateAttributes` ` para ` App Configuration `. Ao criar ou atualizar uma assinatura para um destino **App Configuration** destino, o objeto `attributes` tem uma regra específica:
      - Você deve **incluir **`feature_flag_enabled` **ou **`template_id_notification`
      - **Não** é possível incluir as duas propriedades ao mesmo tempo
               Isso garante que seja criada uma assinatura para o caso de uso correto — seja **para avaliação de sinalizadores de recurso**, seja **para criação de modelos de notificação**, mas não para ambos ao mesmo tempo.

   ```json
   {
      "template_id_notification": "e40843c8-xxxx-4717-xxxx-f923f2786a34",
   }
   ```
   ```json
   {
      "feature_flag_enabled": false,
   }
   ```

## Integrações {: #en-cli-integration}

Operar na integração IBM Cloud integração Event Notifications.

### integração de notificações de eventos do ibmcloud Criar {: #en-cli-integration-create-command}

```sh
ibmcloud event-notifications integration-create --instance-id INSTANCE-ID --type TYPE --metadata METADATA

Opções de comando

--instance-id (string)

Identificador exclusivo da IBM Cloud instância Event Notifications.

 O comprimento máximo é de `36` caracteres. O comprimento mínimo é de `36` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--type (string)

Tipo da integração collect_failed_events.

O comprimento máximo é de 50 caracteres. O comprimento mínimo é de 1 caracteres. O valor permitido é collect_failed_events.

--metadata (IntegrationCreateAttributes)

Esquema de integração para atualização

Metadados necessários para a integração.

Exemplos

  • O exemplo a seguir mostra o formato do objeto IntegrationCreateAttributes .
   {
      "endpoint": "https://s3.us-west.cloud-object-storage.appdomain.cloud",
      "crn": "crn:v1:bluemix:public:cloud-object-storage:global:xxxxxxx6db359a81a1dde8f44bxxxxxx:xxxxxxxx-1d48-xxxx-xxxx-xxxxxxxxxxxx::",
      "bucket_name": "cloud-object-storage"
   }
   ```

### substituir a integração de notificações de eventos do ibmcloud {: #en-cli-integration-update-command}

Substitua `Integration`.

```sh
ibmcloud event-notifications integration-replace --instance-id INSTANCE-ID --id ID --type Type --metadata METADATA

Opções de comando

--instance-id (string)

Identificador exclusivo da IBM Cloud instância Event Notifications.

 O comprimento máximo é de `36` caracteres. O comprimento mínimo é de `36` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--type (string)

Tipo de integração KMS/hs-crypto (obsoleto).

O comprimento máximo é de 50 caracteres. O comprimento mínimo é de 1 caracteres. Os valores permitidos são KMS e collect_failed_events. Observação: o tipo hs-crypto está obsoleto. Não haverá suporte para novos recursos de integração com o tipo hs-crypto.

--metadata (IntegrationReplaceAttributes)

Esquema de integração para atualização

Metadados necessários para a integração.

--id (string)

Identificador exclusivo para integração. Obrigatório.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z0-9-:_]*/.

Exemplos

  • O exemplo a seguir mostra o formato do objeto IntegrationReplaceAttributes para o kms.
   {
      "endpoint" : "https://qa.us-south.kms.cloud.ibm.com",
      "crn" : "crn of key protect",
      "root_key_id" : "root key id"
   }
   ```

### lista de integração de notificações de eventos do ibmcloud {: #en-cli-integration-list-command}

Listar todos os `Integrations`.

```sh
ibmcloud event-notifications integrations [--limit LIMIT] [--offset OFFSET] [--search SEARCH] --instance-id INSTANCE-ID

Opções de comando

--instance-id (string)

Identificador exclusivo da IBM Cloud instância Event Notifications.

 O comprimento máximo é de `36` caracteres. O comprimento mínimo é de `36` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--limit (int64)

Limite de página para resultados paginados.

O valor máximo é 100. O valor mínimo é 1.

--offset (int64)

deslocamento para resultados paginados.

O valor mínimo é 0.

--search (string)

Sequência de pesquisa para filtragem de resultados.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 0 caracteres. O valor deve corresponder à expressão regular /[a-zA-Z0-9]/.

ibmcloud event-notifications Integração get

Obter Integration específico.

ibmcloud event-notifications integration --id ID --instance-id INSTANCE-ID

Opções de comando

--instance-id (string)

Identificador exclusivo da IBM Cloud instância Event Notifications.

 O comprimento máximo é de `36` caracteres. O comprimento mínimo é de `36` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador exclusivo para integração. Obrigatório.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z0-9-:_]*/.

Modelos

IBM Cloud Event Notifications Modelos.

ibmcloud event-notifications template-create

Criar um novo modelo.

ibmcloud event-notifications template-create --instance-id INSTANCE-ID --name NAME --type TYPE --params PARAMS [--description DESCRIPTION]

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--name (string)

O modelo de mensagem. Obrigatório.

O comprimento máximo é de 255 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/.

--type (string)

O tipo de modelo. Obrigatório.

O comprimento máximo é de 24 caracteres. O comprimento mínimo é de 22 caracteres. O valor deve corresponder à expressão regular /^(smtp_custom.notification|smtp_custom.invitation)$/.

--params (TemplateConfig)

Carga útil que descreve uma configuração de modelo. Obrigatório.

Em vez disso, essa opção JSON pode ser fornecida definindo campos individuais com outras opções. Ela é mutuamente exclusiva em relação a essas opções.

Forneça uma opção de cadeia de caracteres JSON ou especifique um arquivo JSON para leitura, fornecendo uma opção de caminho de arquivo que comece com @, por exemplo, --params=@path/to/file.json.

--description (string)

A descrição do modelo.

O comprimento máximo é de 255 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/.

--params-body (string)

Corpo do modelo. Essa opção fornece um valor para um subcampo da opção JSON 'params'. Ela é mutuamente exclusiva dessa opção.

O comprimento máximo é de 20000 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /.*/.

--params-subject (string)

O assunto do modelo. Essa opção fornece um valor para um subcampo da opção JSON 'params'. Ela é mutuamente exclusiva dessa opção.

O comprimento máximo é de 1000 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /.*/.

Exemplos

  • O exemplo a seguir mostra o formato do objeto TemplateConfig para e-mail. O tipo suportado é smtp_custom.notification|smtp_custom.invitation
ibmcloud event-notifications template-create \
    --instance-id exampleString \
    --name exampleString \
    --type smtp_custom.notification \
    --params '{"body": "exampleString", "subject": "exampleString"}' \
    --description exampleString
  • O exemplo a seguir mostra o formato do objeto TemplateConfig para o Slack. O tipo suportado é slack.notification.
ibmcloud event-notifications template-create \
    --instance-id exampleString \
    --name exampleString \
    --type slack.notification \
    --params '{"body": "ewoJImJsb2NrcyI6IFsKCQl7CgkJCSJ0eXBlIjogInNlY3Rpb24iLAoJCQkidGV4dCI6IHsKCQkJCSJ0eXBlIjogIm1ya2R3biIsCgkJCQkidGV4dCI6ICJOZXcgUGFpZCBUaW1lIE9mZiByZXF1ZXN0IGZyb20gPGV4YW1wbGUuY29tfEZyZWQgRW5yaXF1ZXo+XG5cbjxodHRwczovL2V4YW1wbGUuY29tfFZpZXcgcmVxdWVzdD4iCgkJCX0KCQl9CgldCn0="}' \
    --description exampleString
  • O exemplo a seguir mostra o formato do objeto TemplateConfig para o Webhook. O tipo suportado é webhook.notification
ibmcloud event-notifications template-create \
    --instance-id exampleString \
    --name exampleString \
    --type webhook.notification \
    --params '{"body": "ewoJImJsb2NrcyI6IFsKCQl7CgkJCSJ0eXBlIjogInNlY3Rpb24iLAoJCQkidGV4dCI6IHsKCQkJCSJ0eXBlIjogIm1ya2R3biIsCgkJCQkidGV4dCI6ICJOZXcgUGFpZCBUaW1lIE9mZiByZXF1ZXN0IGZyb20gPGV4YW1wbGUuY29tfEZyZWQgRW5yaXF1ZXo+XG5cbjxodHRwczovL2V4YW1wbGUuY29tfFZpZXcgcmVxdWVzdD4iCgkJCX0KCQl9CgldCn0="}' \
    --description exampleString
  • O exemplo a seguir mostra o formato do objeto TemplateConfig para o Pagerduty. O tipo suportado é pagerduty.notification
ibmcloud event-notifications template-create \
    --instance-id exampleString \
    --name exampleString \
    --type pagerduty.notification \
    --params '{"body": "ewogICJwYXlsb2FkIjogewogICAgInN1bW1hcnkiOiAie3sgZGF0YS5hbGVydF9kZWZpbml0aW9uLm5hbWV9fSIsCiAgICAidGltZXN0YW1wIjogInt7dGltZX19IiwKICAgICJzZXZlcml0eSI6ICJpbmZvIiwKICAgICJzb3VyY2UiOiAie3sgc291cmNlIH19IgogIH0sCiAgImRlZHVwX2tleSI6ICJ7eyBpZCB9fSIsCiAge3sjZXF1YWwgZGF0YS5zdGF0dXMgInRyaWdnZXJlZCJ9fQogICJldmVudF9hY3Rpb24iOiAidHJpZ2dlciIKICAge3svZXF1YWx9fQoKICB7eyNlcXVhbCBkYXRhLnN0YXR1cyAicmVzb2x2ZWQifX0KICAiZXZlbnRfYWN0aW9uIjogInJlc29sdmUiCiAge3svZXF1YWx9fQoKICAge3sjZXF1YWwgZGF0YS5zdGF0dXMgImFja25vd2xlZGdlZCJ9fQogICAiZXZlbnRfYWN0aW9uIjogImFja25vd2xlZGdlIgogICB7ey9lcXVhbH19Cn0="}' \
    --description exampleString
  • O exemplo a seguir mostra o formato do objeto TemplateConfig para Event Streams. O tipo suportado é event_streams.notification
ibmcloud event-notifications template-create \
    --instance-id exampleString \
    --name exampleString \
    --type event_streams.notification \
    --params '{"body": "eyJuYW1lIjoie3tkYXRhLm5hbWV9fSIifQ=="}' \
    --description exampleString
  • O exemplo a seguir mostra o formato do objeto TemplateConfig para o trabalho Code Engine. O tipo suportado é ibmcejob.notification
ibmcloud event-notifications template-create \
    --instance-id exampleString \
    --name exampleString \
    --type ibmcejob.notification\
    --params '{"body": "ewogInJ1bl9lbnZfdmFyaWFibGVzIjogWwogICB7ICJuYW1lIjogInJlZ2lvbiIsICJ2YWx1ZSI6ICJ7e2RhdGEucmVnaW9ufX0iLCJ0eXBlIjogImxpdGVyYWwifSwKeyJuYW1lIjoiVkFSMSIsInR5cGUiOiJsaXRlcmFsIiwidmFsdWUiOiJ7e2RhdGEudmFyMX19In0sCnsibmFtZSI6IlZBUjIiLCJ0eXBlIjoibGl0ZXJhbCIsInZhbHVlIjoie3tkYXRhLnZhcjJ9fSJ9Cl0KfQ=="}' \
    --description exampleString
  • O exemplo a seguir mostra o formato do objeto TemplateConfig para Code Engine Application/Function (Aplicativo/Função). O tipo suportado é ibmceapp.notification
ibmcloud event-notifications template-create \
    --instance-id exampleString \
    --name exampleString \
    --type ibmceapp.notification\
    --params '{"body": "ewogICJ2YXIxIjogInt7ZGF0YS52YXIxfX0iLAogICJ2YXIyIjogInt7ZGF0YS52YXIyfX0iCn0="}' \
    --description exampleString
  • O exemplo a seguir mostra o formato do objeto TemplateConfig para App Configuration. O tipo suportado é app_configuration.notification
ibmcloud event-notifications template-create \
    --instance-id exampleString \
    --name exampleString \
    --type app_configuration.notification\
    --params '{"body": "eyJlbmFibGVkIjogZmFsc2V9Cg=="}' \
    --description exampleString

ibmcloud event-notifications templates

Listar todos os modelos. Observação: se a opção --all-pages não for definida, o comando recuperará apenas uma única página da coleção.

ibmcloud event-notifications templates --instance-id INSTANCE-ID [--limit LIMIT] [--offset OFFSET] [--search SEARCH]

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--limit (int64)

Limite de página para resultados paginados.

O valor padrão é 10. O valor máximo é 100. O valor mínimo é 1.

--offset (int64)

deslocamento para resultados paginados.

O valor padrão é 0. O valor mínimo é 0.

--search (string)

Sequência de pesquisa para filtragem de resultados.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z0-9]/.

--all-pages (bool)

Envie várias solicitações para exibir todas as páginas da coleção de modelos.

Exemplo

ibmcloud event-notifications templates \
    --instance-id exampleString \
    --limit 10 \
    --offset 0 \
    --search exampleString

ibmcloud event-notifications template

Obter detalhes de um modelo.

ibmcloud event-notifications template --instance-id INSTANCE-ID --id ID

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `32` caracteres. O comprimento mínimo é de `32` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/`.
--id (string)

Identificador exclusivo do modelo. Obrigatório.

O comprimento máximo é de 32 caracteres. O comprimento mínimo é de 32 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

Exemplo

ibmcloud event-notifications template \
    --instance-id=exampleString \
    --id=exampleString

ibmcloud event-notifications template-replace

Atualizar os detalhes de um modelo.

ibmcloud event-notifications template-replace --instance-id INSTANCE-ID --id ID [--name NAME] [--description DESCRIPTION] [--type TYPE] [--params PARAMS]

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador exclusivo do modelo. Obrigatório.

O comprimento máximo é de 32 caracteres. O comprimento mínimo é de 32 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--name (string)

Nome de modelo.

O comprimento máximo é de 255 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/.

--description (string)

Descrição do modelo.

O comprimento máximo é de 255 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/.

--type (string)

O tipo de modelo.

O comprimento máximo é de 24 caracteres. O comprimento mínimo é de 22 caracteres. O valor deve corresponder à expressão regular /^(smtp_custom.notification|smtp_custom.invitation)$/.

--params (TemplateConfig)

Carga útil que descreve uma configuração de modelo. Em vez disso, essa opção JSON pode ser fornecida definindo campos individuais com outras opções. Ela é mutuamente exclusiva em relação a essas opções.

Forneça uma opção de cadeia de caracteres JSON ou especifique um arquivo JSON para leitura, fornecendo uma opção de caminho de arquivo que comece com @, por exemplo, --params=@path/to/file.json.

Exemplos

ibmcloud event-notifications template-update \
    --instance-id exampleString \
    --id exampleString \
    --name exampleString \
    --description exampleString \
    --type exampleString \
    --params '{"body": "exampleString", "subject": "exampleString"}'

ibmcloud event-notifications template-delete

Excluir um modelo.

ibmcloud event-notifications template-delete --instance-id INSTANCE-ID --id ID

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador exclusivo do modelo. Obrigatório.

O comprimento máximo é de 32 caracteres. O comprimento mínimo é de 32 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

Exemplo

ibmcloud event-notifications template-delete \
    --instance-id exampleString \
    --id exampleString

ibmcloud event-notifications pre-defined-templates

Lista todos os modelos predefinidos.

Se a opção --all-pages não for definida, o comando recuperará apenas uma única página da coleção.

ibmcloud event-notifications pre-defined-templates --instance-id INSTANCE-ID --source SOURCE --type TYPE [--limit LIMIT] [--offset OFFSET] [--search SEARCH]

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `32` caracteres. O comprimento mínimo é de `32` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/`.
--source (string)

Tipo de fonte. Obrigatório.

O comprimento máximo é de 50 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /.*/.

--type (string)

Tipo de destino. Obrigatório.

O comprimento máximo é de 50 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /.*/.

--limit (int64)

Limite de página para resultados paginados.

O valor padrão é 10. O valor máximo é 100. O valor mínimo é 1.

--offset (int64)

deslocamento para resultados paginados.

O valor padrão é 0. O valor mínimo é 0.

--search (string)

Sequência de pesquisa para filtragem de resultados.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z0-9]/.

--all-pages (bool)

Envie várias solicitações para exibir todas as páginas da coleção para modelos predefinidos.

Exemplo

ibmcloud event-notifications pre-defined-templates \
    --instance-id=exampleString \
    --source=exampleString \
    --type=exampleString \
    --limit=10 \
    --offset=0 \
    --search=exampleString

Configurações de SMTP

Configurações de SMTP IBM Cloud Event Notifications.

ibmcloud event-notifications smtp-configuration-create

Crie uma nova configuração SMTP.

ibmcloud event-notifications smtp-configuration-create --instance-id INSTANCE-ID --name NAME --domain DOMAIN [--description DESCRIPTION]

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--name (string)

O nome da configuração SMTP. Obrigatório.

O comprimento máximo é de 250 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/.

--domain (string)

Nome de Domínio. Obrigatório.

O comprimento máximo é de 512 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /.*/.

--description (string)

Descrição da configuração do SMTP.

O comprimento máximo é de 250 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/.

Exemplo

ibmcloud event-notifications smtp-configuration-create \
    --instance-id=exampleString \
    --name=exampleString \
    --domain=exampleString \
    --description=exampleString

ibmcloud event-notifications smtp-configurations

Listar todas as configurações de SMTP. Observação: se a opção --all-pages não for definida, o comando recuperará apenas uma única página da coleção.

ibmcloud event-notifications smtp-configurations --instance-id INSTANCE-ID [--limit LIMIT] [--offset OFFSET] [--search SEARCH]

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--limit (int64)

Limite de página para resultados paginados.

O valor padrão é 10. O valor máximo é 100. O valor mínimo é 1.

--offset (int64)

deslocamento para resultados paginados.

O valor padrão é 0. O valor mínimo é 0.

--search (string)

Sequência de pesquisa para filtragem de resultados.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z0-9]/.

--all-pages (bool)

Envie várias solicitações para exibir todas as páginas da coleção de configurações de SMTP.

Exemplo

ibmcloud event-notifications smtp-configurations \
    --instance-id=exampleString \
    --limit=10 \
    --offset=0 \
    --search=exampleString

ibmcloud event-notifications smtp-user-create

Crie um novo usuário SMTP.

ibmcloud event-notifications smtp-user-create --instance-id INSTANCE-ID --id ID [--description DESCRIPTION] [--username-to-clone USERNAME-TO-CLONE]

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador exclusivo para SMTP. Obrigatório.

O comprimento máximo é de 32 caracteres. O comprimento mínimo é de 32 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--description (string)

Descrição da configuração do SMTP.

O comprimento máximo é de 250 caracteres. O comprimento mínimo é de 0 caracteres. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/.

--username-to-clone (string)

fornece o nome do usuário a ser clonado.

O comprimento máximo é de 20 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /^[a-z0-9]{18}\\d{2}$/.

Exemplo

ibmcloud event-notifications smtp-user-create \
    --instance-id=exampleString \
    --id=exampleString \
    --description=exampleString \
    --username-to-clone=exampleString

ibmcloud event-notifications smtp-users

Liste todos os usuários SMTP. Observação: se a opção --all-pages não for definida, o comando recuperará apenas uma única página da coleção.

ibmcloud event-notifications smtp-users --instance-id INSTANCE-ID --id ID [--limit LIMIT] [--offset OFFSET] [--search SEARCH]

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador exclusivo para SMTP. Obrigatório.

O comprimento máximo é de 32 caracteres. O comprimento mínimo é de 32 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--limit (int64)

Limite de página para resultados paginados.

O valor padrão é 10. O valor máximo é 100. O valor mínimo é 1.

--offset (int64)

deslocamento para resultados paginados.

O valor padrão é 0. O valor mínimo é 0.

--search (string)

Sequência de pesquisa para filtragem de resultados.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z0-9]/.

--all-pages (bool)

Envie várias solicitações para exibir todas as páginas da coleção dos usuários do SMTP.

Exemplo

ibmcloud event-notifications smtp-users \
    --instance-id=exampleString \
    --id=exampleString \
    --limit=10 \
    --offset=0 \
    --search=exampleString

ibmcloud event-notifications smtp-configuration

Obter detalhes de uma configuração de SMTP.

ibmcloud event-notifications smtp-configuration --instance-id INSTANCE-ID --id ID

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador exclusivo para SMTP. Obrigatório.

O comprimento máximo é de 32 caracteres. O comprimento mínimo é de 32 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

Exemplo

ibmcloud event-notifications smtp-configuration \
    --instance-id=exampleString \
    --id=exampleString

ibmcloud event-notifications smtp-configuration-update

Atualizar detalhes do SMTP.

ibmcloud event-notifications smtp-configuration-update --instance-id INSTANCE-ID --id ID [--name NAME] [--description DESCRIPTION]

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador exclusivo para SMTP. Obrigatório.

O comprimento máximo é de 32 caracteres. O comprimento mínimo é de 32 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--name (string)

Nome SMTP.

O comprimento máximo é de 250 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/.

--description (string)

Descrição do SMTP.

O comprimento máximo é de 250 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/.

Exemplo

ibmcloud event-notifications smtp-configuration-update \
    --instance-id=exampleString \
    --id=exampleString \
    --name=exampleString \
    --description=exampleString

ibmcloud event-notifications smtp-configuration-delete

Excluir uma configuração de SMTP.

ibmcloud event-notifications smtp-configuration-delete --instance-id INSTANCE-ID --id ID

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador exclusivo para SMTP. Obrigatório.

O comprimento máximo é de 32 caracteres. O comprimento mínimo é de 32 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

Exemplo

ibmcloud event-notifications smtp-configuration-delete \
    --instance-id=exampleString \
    --id=exampleString

ibmcloud event-notifications smtp-user

Obter detalhes de um usuário SMTP.

ibmcloud event-notifications smtp-user --instance-id INSTANCE-ID --id ID --user-id USER-ID

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador exclusivo para SMTP. Obrigatório.

O comprimento máximo é de 32 caracteres. O comprimento mínimo é de 32 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--user-id (string)

UserID. Obrigatório.

O comprimento máximo é de 256 caracteres. O comprimento mínimo é de 5 caracteres. O valor deve corresponder à expressão regular /.*/.

Exemplo

ibmcloud event-notifications smtp-user \
    --instance-id=exampleString \
    --id=exampleString \
    --user-id=exampleString

ibmcloud event-notifications smtp-user-update

Atualize os detalhes do usuário SMTP.

ibmcloud event-notifications smtp-user-update --instance-id INSTANCE-ID --id ID --user-id USER-ID [--description DESCRIPTION]

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador exclusivo para SMTP. Obrigatório.

O comprimento máximo é de 32 caracteres. O comprimento mínimo é de 32 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--user-id (string)

UserID. Obrigatório.

O comprimento máximo é de 256 caracteres. O comprimento mínimo é de 5 caracteres. O valor deve corresponder à expressão regular /.*/.

--description (string)

Descrição do usuário SMTP.

O comprimento máximo é de 250 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z 0-9-_\/.?:'";,+=!#@$%^&*() ]*/.

Exemplo

ibmcloud event-notifications smtp-user-update \
    --instance-id=exampleString \
    --id=exampleString \
    --user-id=exampleString \
    --description=exampleString

ibmcloud event-notifications smtp-user-delete

Excluir um usuário SMTP.

ibmcloud event-notifications smtp-user-delete --instance-id INSTANCE-ID --id ID --user-id USER-ID

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador exclusivo para SMTP. Obrigatório.

O comprimento máximo é de 32 caracteres. O comprimento mínimo é de 32 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--user-id (string)

UserID. Obrigatório.

O comprimento máximo é de 256 caracteres. O comprimento mínimo é de 5 caracteres. O valor deve corresponder à expressão regular /.*/.

Exemplo

ibmcloud event-notifications smtp-user-delete \
    --instance-id=exampleString \
    --id=exampleString \
    --user-id=exampleString

ibmcloud event-notifications smtp-allowed-ips

Obter detalhes de IPs permitidos para SMTP.

ibmcloud event-notifications smtp-allowed-ips --instance-id INSTANCE-ID --id ID

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador exclusivo para SMTP. Obrigatório.

O comprimento máximo é de 32 caracteres. O comprimento mínimo é de 32 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

Exemplo

ibmcloud event-notifications smtp-allowed-ips \
    --instance-id=exampleString \
    --id=exampleString

ibmcloud event-notifications smtp-allowed-ips-update

Observação: o suporte à lista de permissões herdada foi descontinuado. O suporte foi ativado por meio de restrições baseadas em contexto. Para obter informações detalhadas, consulte aqui: https://cloud.ibm.com/docs/event-notifications?topic=event-notifications-en-smtp-configurations#en-smtp-configurations-cbr

ibmcloud event-notifications verify-smtp-update

Verifique os registros SPF e DKIM do SMTP.

ibmcloud event-notifications verify-smtp-update --instance-id INSTANCE-ID --id ID --type TYPE

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--id (string)

Identificador exclusivo para SMTP. Obrigatório.

O comprimento máximo é de 32 caracteres. O comprimento mínimo é de 32 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--type (string)

SMTP Tipo de verificação. Obrigatório.

O comprimento máximo é de 20 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /.*/.

Exemplo

ibmcloud event-notifications verify-smtp-update \
    --instance-id=exampleString \
    --id=exampleString \
    --type=exampleString

Métricas

ibmcloud event-notifications metrics

Obter métricas.

ibmcloud event-notifications metrics ---instance-id INSTANCE-ID --gte GTE --lte LTE [--smtp-config-id SMTP-CONFIG-ID] [--destination-type DESTINATION-TYPE][--destination-id DESTINATION-ID] [--subscription-id SUBSCRIPTION-ID] [--source-id SOURCE-ID] [--email-to EMAIL-TO] [--notification-id NOTIFICATION-ID] [--subject SUBJECT]

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--gte (string)

GTE (maior que igual), registro de data e hora de início em UTC. Obrigatório.

O comprimento máximo é de 28 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[0-9]{1,4}-[0-9]{1,2}-[0-9]{1,2}T[0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}Z/.

--lte (string)

LTE (menor que igual), registro de data e hora final em UTC. Obrigatório.

O comprimento máximo é de 28 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[0-9]{1,4}-[0-9]{1,2}-[0-9]{1,2}T[0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}Z/.

--smtp-config-id (string)

ID de configuração do SMTP. Obrigatório ao consultar métricas para destinos da interface SMTP.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--destination-type (string)

Tipo de destino para o qual as métricas são solicitadas. Valor compatível: smtp_custom. Obrigatório ao consultar métricas para destinos de e-mail personalizados.

Os valores permitidos são: smtp_custom.

--destination-id (string)

Identificador único para o Destino.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--subscription-id (string)

Identificador único para a Assinatura.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--source-id (string)

Identificador único para a Origem.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z0-9-:_]*/.

--email-to (string)

ID do e-mail do destinatário.

O comprimento máximo é de 256 caracteres. O comprimento mínimo é de 0 caracteres. O valor deve corresponder à expressão regular /[A-Za-z0-9\\._%+\\-]+@[A-Za-z0-9\\.\\-]+\\.[A-Za-z]{2,}/.

--notification-id (string)

Notificação Id.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--subject (string)

assunto do e-mail.

O comprimento máximo é de 256 caracteres. O comprimento mínimo é de 0 caracteres. O valor deve corresponder à expressão regular /[a-zA-Z0-9]/.

Exemplo

ibmcloud event-notifications metrics \
    --instance-id=exampleString \
    --destination-type=smtp_custom \
    --gte=exampleString \
    --lte=exampleString \
    --destination-id=exampleString \
    --subscription-id=exampleString \
    --source-id=exampleString \
    --email-to=exampleString \
    --notification-id=exampleString \
    --subject=exampleString

ibmcloud event-notifications bounce-metrics

Obtenha métricas de rejeição.

ibmcloud event-notifications bounce-metrics --instance-id INSTANCE-ID --gte GTE --lte LTE [--smtp-config-id SMTP-CONFIG-ID] [--destination-type DESTINATION-TYPE] [--destination-id DESTINATION-ID] [--subscription-id SUBSCRIPTION-ID] [--source-id SOURCE-ID] [--email-to EMAIL-TO] [--notification-id NOTIFICATION-ID] [--subject SUBJECT] [--limit LIMIT] [--offset OFFSET]

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `32` caracteres. O comprimento mínimo é de `32` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/`.
--gte (string)

GTE (maior que igual), registro de data e hora de início em UTC. Obrigatório.

O comprimento máximo é de 28 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[0-9]{1,4}-[0-9]{1,2}-[0-9]{1,2}T[0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}Z/.

--lte (string)

LTE (menor que igual), registro de data e hora final em UTC. Obrigatório.

O comprimento máximo é de 28 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[0-9]{1,4}-[0-9]{1,2}-[0-9]{1,2}T[0-9]{1,2}:[0-9]{1,2}:[0-9]{1,2}Z/.

--smtp-config-id (string)

ID de configuração do SMTP. Obrigatório ao consultar métricas para destinos da interface SMTP.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--destination-type (string)

Tipo de destino para o qual as métricas são solicitadas. Valor compatível: smtp_custom. Obrigatório ao consultar métricas para destinos de e-mail personalizados.

Os valores permitidos são: smtp_custom.

--destination-id (string)

Identificador único para o Destino.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--subscription-id (string)

Identificador único para a Assinatura.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--source-id (string)

Identificador único para a Origem.

O comprimento máximo é de 100 caracteres. O comprimento mínimo é de 1 caractere. O valor deve corresponder à expressão regular /[a-zA-Z0-9-:_]*/.

--email-to (string)

ID do e-mail do destinatário.

O comprimento máximo é de 256 caracteres. O comprimento mínimo é de 0 caracteres. O valor deve corresponder à expressão regular /[A-Za-z0-9\\._%+\\-]+@[A-Za-z0-9\\.\\-]+\\.[A-Za-z]{2,}/.

--notification-id (string)

Notificação Id.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

--subject (string)

assunto do e-mail.

O comprimento máximo é de 256 caracteres. O comprimento mínimo é de 0 caracteres. O valor deve corresponder à expressão regular /[a-zA-Z0-9]/.

--limit (int64)

Limite de página para resultados paginados.

O valor padrão é 10. O valor máximo é 100. O valor mínimo é 1.

--offset (int64)

deslocamento para resultados paginados.

O valor padrão é 0. O valor mínimo é 0.

Exemplo

ibmcloud event-notifications bounce-metrics \
    --instance-id=exampleString \
    --destination-type=smtp_custom \
    --gte=exampleString \
    --lte=exampleString \
    --destination-id=exampleString \
    --subscription-id=exampleString \
    --source-id=exampleString \
    --email-to=exampleString \
    --notification-id=exampleString \
    --subject=exampleString \
    --limit=10 \
    --offset=0

Obter status das notificações

Este documento descreve os detalhes da carga útil para obter o status das notificações do Webhook Destination Test.

ibmcloud event-notifications notifications-status

Verifique o status de uma notificação de teste enviada para um destino de webhook. Este comando é usado especificamente para verificar o status de entrega das notificações de teste do webhook.

ibmcloud event-notifications notifications-status --instance-id INSTANCE-ID --id ID

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `32` caracteres. O comprimento mínimo é de `32` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/`.
--id (string)

O ID da notificação retornado ao testar um destino de webhook. Este ID é específico para notificações de teste enviadas a destinos de webhook. Obrigatório.

O comprimento máximo é de 36 caracteres. O comprimento mínimo é de 36 caracteres. O valor deve corresponder à expressão regular /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.

Exemplo

ibmcloud event-notifications notifications-status \
    --instance-id=exampleString \
    --id=exampleString

Enviar notificações

Este documento descreve os detalhes da carga útil para o envio de eventos utilizando as fontes da API disponíveis em Event Notifications. As origens de API podem ser usadas para enviar eventos de seus aplicativos de back-end. Event Notifications oferece dois modos para fazer chamadas d HTTP. Isso está em conformidade com a especificação CloudEvents. Esses modos são o modo binário e o modo estruturado. Mais detalhes aqui - https://github.com/cloudevents/spec. No Modo de Conteúdo Binário, o valor dos dados do evento é inserido no corpo da solicitação ou resposta HTTP tal como está, com o valor do atributo datacontenttype declarando seu tipo de mídia no cabeçalho Content-Type HTTP; todos os demais atributos do evento são mapeados para cabeçalhos HTTP. Todos os nomes de atributos têm o prefixo “ce-” e são adicionados ao cabeçalho (exceto “data” e “datacontenttype”). Quando os atributos obrigatórios do CloudEvents (specversion, id, type e source) são passados como parte dos cabeçalhos, a solicitação é tratada como modo binário. Modo estruturado. No Modo de Conteúdo Estruturado, os atributos de metadados do evento e os dados do evento são inseridos no corpo da solicitação HTTP. Para o modo estruturado, defina o cabeçalho Content-Type como application/cloudevents+json. Os atributos obrigatórios do CloudEvents (specversion, id, type e source) devem fazer parte do corpo da solicitação. Além disso, os dados de id são fornecidos como datacontenttype, que é obrigatório. Só oferecemos suporte a datacontenttype como "application/json".

ibmcloud event-notifications send-notifications

Enviar corpo de notificações da instância. Para obter mais informações sobre a carga útil de Event Notifications, consulte aqui.

ibmcloud event-notifications send-notifications --instance-id INSTANCE-ID [--body BODY]

Opções de comando

--instance-id (string)

Identificador único para a instância de notificações de eventos da IBM Cloud. Obrigatório.

 O comprimento máximo é de `256` caracteres. O comprimento mínimo é de `10` caracteres. O valor deve corresponder à expressão regular `/[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]/`.
--body (NotificationCreate)

Carga útil que descreve uma solicitação de criação de notificação.

Forneça uma opção de cadeia de caracteres JSON ou especifique um arquivo JSON para leitura, fornecendo uma opção de caminho de arquivo que comece com @, por exemplo, --body=@path/to/file.json.

NotificationCreate

O exemplo a seguir mostra o formato do objeto NotificationCreate.

{
  "specversion" : "1.0",
  "time" : "2019-01-01T12:00:00.000Z",
  "id" : "exampleString",
  "source" : "exampleString",
  "type" : "exampleString",
  "ibmenseverity" : "exampleString",
  "ibmensourceid" : "exampleString",
  "ibmendefaultshort" : "exampleString",
  "ibmendefaultlong" : "exampleString",
  "ibmensubject" : "exampleString",
  "ibmentemplates" : "[\"886f8f4c-8605-47hb-85a1-8682b9377468483\"]",
  "ibmenmailto" : "exampleString",
  "ibmenslackto": "[\"sgjhgsjaS\",\"agjhgsjaS\"]",
  "ibmensmsto" : "exampleString",
  "ibmenmms": {"content": "VBORw0KGgoAAAANSUhEUgAAAFoAAAA4CAYAAAB9lO","content_type": "image/png"},
  "ibmenmarkdownn": "This is a *italic* message.\n- Item 1\n- Item 2\n**bold text** with more text data\n~~strike through~~\n1. order 1\n2. order 2\n```fenced code block```\n> block code\n`code`\n[Click here](https://example.com) for more info."
  "ibmenhtmlbody" : "exampleString",
  "subject" : "exampleString",
   "attachments": [
    {
      "content": "VGhpcyBpcyBhIHRlc3QgZG9jdW1lbnQK",
      "filename": "test.txt",
      "content_type": "text/plain",
      "disposition": "attachment"
    }
  ],
  "data" : {
    "anyKey" : "anyValue"
  },
  "datacontenttype" : "application/json",
  "ibmenpushto" : "{
    \"fcm_devices\" : [ \"exampleString\" ],
    \"apns_devices\" : [ \"exampleString\" ],
    \"huawei_devices\" : [ \"exampleString\" ],
    \"safari_devices\" : [ \"exampleString\" ],
    \"chrome_devices\" : [ \"exampleString\" ],
    \"firefox_devices\" : [ \"exampleString\" ],
    \"user_ids\" : [ \"exampleString\" ],
    \"tags\" : [ \"exampleString\" ],
    \"platforms\" : [ \"push_android\" ]
  }",
  "ibmenfcmbody" : "{ }",
  "ibmenapnsbody" : "{ }",
  "ibmenapnsheaders" : "{ }",
  "ibmenchromebody" : "{ }",
  "ibmenchromeheaders" : "{ }",
  "ibmenfirefoxbody" : "{ }",
  "ibmenfirefoxheaders" : "{ }",
  "ibmenhuaweibody" : "{ }",
  "ibmensafaribody" : "{ }"
}

Exemplo

Com os parâmetros obrigatórios:

ibmcloud event-notifications send-notifications \
    --instance-id=exampleString \
    --body='{"specversion": "1.0", "time": "2019-01-01T12:00:00.000Z", "type": "*", "id": "exampleString", "source": "exampleString", "ibmensourceid": "exampleString", "ibmendefaultshort": "short message", "ibmendefaultlong": "long message", "data": {"name": "exampleString"}, "datacontenttype": "application/json"}'

Com todos os parâmetros:

ibmcloud event-notifications send-notifications \
    --instance-id=exampleString \
    --body='{"specversion": "1.0", "time": "2019-01-01T12:00:00.000Z", "id": "exampleString", "source": "exampleString", "type": "exampleString", "ibmenseverity": "exampleString", "ibmensourceid": "exampleString", "ibmendefaultshort": "exampleString", "ibmendefaultlong": "exampleString", "ibmensubject": "exampleString", "ibmentemplates": [\"template-id\"], "ibmenmailto": "exampleString","ibmenslackto": "[\"sgjhgsjaS\",\"agjhgsjaS\"]", "ibmensmsto": "exampleString","ibmenmms": "{\"content\": \"VBORw0KGgoAAAANSUhEUgAAAFoAAAA4CAYAAAB9lO\",\"content_type\": \"image/png\"}", "ibmenhtmlbody": "exampleString", "subject": "exampleString", "data": {"anyKey": "anyValue"}, "datacontenttype": "application/json", "ibmenpushto": "{\"fcm_devices\": [\"exampleString\"], \"apns_devices\": [\"exampleString\"], \"huawei_devices\": [\"exampleString\"], \"safari_devices\": [\"exampleString\"], \"chrome_devices\": [\"exampleString\"], \"firefox_devices\": [\"exampleString\"], \"user_ids\": [\"exampleString\"], \"tags\": [\"exampleString\"], \"platforms\": [\"push_android\"]}", "ibmenfcmbody": "{}", "ibmenapnsbody": "{}", "ibmenapnsheaders": "{}", "ibmenchromebody": "{}", "ibmenchromeheaders": "{}", "ibmenfirefoxbody": "{}", "ibmenfirefoxheaders": "{}", "ibmenhuaweibody": "{}", "ibmensafaribody": "{}"}'

Propriedades adicionais que podem ser configuradas para a notificação do IOS

configurações da plataforma iOS
Propriedade Tipo de propriedade Descrição
badge número inteiro O número a ser exibido como o badge do ícone do aplicativo.
interactive_category string O identificador de categoria a ser usado para as notificações push interativas.
ios_action_key string O título para a tecla de Ação.
payload Objeto JSON A carga útil JSON customizada que é enviada como parte da mensagem de notificação.
sound string O nome do arquivo de som no pacote configurável do aplicativo. O som desse arquivo é reproduzido como um alerta.
title_loc_key string A chave para uma sequência de título no arquivo Localizable.strings para a localização atual. A keystring pode ser formatada com especificadores %@ e %n$@ para obter as variáveis especificadas na matriz titleLocArgs.
loc_key string Uma chave para uma sequência de mensagens de alerta em um arquivo Localizabl.strings para a localização atual (que é configurada pela preferência de idioma do usuário). A keystring pode ser formatada com especificadores %@ e %n$@ para obter as variáveis especificadas na matriz locArgs.
launch_image string O nome de um arquivo de imagem no pacote do aplicativo, com ou sem a extensão do arquivo. A imagem é usada como a imagem de ativação quando os usuários tocam no botão de ação ou movem a régua de controle da ação.
title_loc_args string Os valores de sequência variável que devem aparecer no lugar dos especificadores de formato em title-loc-key.
loc_args string Os valores de sequência variável que devem aparecer no lugar dos especificadores de formato em locKey.
title string O título de notificações push detalhadas (suportado apenas no iOS 10 e acima).
subtitle string O subtítulo das notificações de rich (suportado apenas no iOS 10 e mais recente).
body string O corpo para notificações do IOS.
attachment_url string O link para a mídia de notificações do iOS (vídeo, áudio, GIF, imagens - suportado apenas no iOS 10 e acima).
type string Valores permitidos: DEFAULT, MIXED, SILENT.
apns_collapse_id string Várias notificações com o mesmo identificador de redução são exibidas para o usuário como uma única notificação.
apns_thread_id string Um identificador específico do aplicativo para agrupar notificações relacionadas. Esse valor corresponde à propriedade threadIdentifier no objeto UNNotificationContent.
apns_group_summary_arg string A sequência que a notificação inclui na sequência de formatações de resumo da categoria.
apns_group_summary_arg_count número inteiro O número de itens que a notificação inclui na sequência de formatações de resumo da categoria.

Propriedades adicionais que podem ser configuradas para a notificação do FCM

Configurações da plataforma Android
Propriedade Tipo de propriedade Descrição
icon string Especifique o nome do ícone a ser exibido para a notificação. Certifique-se de que o ícone já esteja empacotado com o aplicativo cliente.
delay_while_idle Booleano Quando configurado como true, este parâmetro indica que a mensagem não deve ser enviada até que o dispositivo se torne ativo.
sync Booleano O sistema de mensagens do grupo de dispositivos possibilita que cada instância do app em um grupo reflita o estado do sistema de mensagens mais recente.
visibility string privada ou pública — Visibilidade desta notificação, o que influencia como e quando as notificações são exibidas em uma tela bloqueada e segura.
redact string O conteúdo especificado é mostrado em uma tela bloqueada segura no dispositivo quando a visibilidade está configurada como Privada.
payload Objeto JSON A carga útil JSON customizada que é enviada como parte da mensagem de notificação.
priority string Um valor de sequência que indica a prioridade desta notificação. Os valores permitidos são 'max', 'high', 'default', 'low' e 'min '. As notificações de prioridade alta/máxima e o campo 'som' podem ser usados para notificações de alerta no Android 5.0 ou mais recente.sampleval='low'.
sound string A tentativa de reprodução do arquivo de som que acontecerá no dispositivo quando ele receber a notificação.
time_to_live número inteiro Especifica quanto tempo (em segundos) a mensagem deve ser mantida no armazenamento do GCM se o dispositivo estiver off-line.
lights Configura a cor do LED de notificação no recebimento de notificação push.
ledArgb string A cor do LED. O hardware faz sua melhor aproximação.
ledOnMs número inteiro O tempo em milissegundos para o LED ficar ligado enquanto está piscando. O hardware faz sua melhor aproximação.
ledOffMs string O tempo em milissegundos para o LED ficar desligado enquanto está piscando. O hardware faz sua melhor aproximação.
android_title string O título de notificações push de rich.
group_id string Configure esta notificação para fazer parte de um grupo de notificações que compartilham a mesma chave. Notificações agrupadas podem ser exibidas em um cluster ou uma pilha em dispositivos que suportam tal renderização.
style Opções para especificar para notificações expansíveis do Android. Os tipos de notificações expansíveis são picture_notification, bigtext_notification, inbox_notification.
type string Especifica o tipo de notificações expansíveis. Os valores possíveis são bigtext_notification, picture_notification, inbox_notification.
title string Especifica o título da notificação. O título é exibido quando a notificação é expandida. O título deve ser especificado para todas as três notificações expansíveis.
type string Valores permitidos: DEFAULT, SILENT.
alert string O valor do alerta da notificação.

Exemplo de script para provisionamento Event Notifications usando a CLI

O script provision_event_notification.sh automatiza o provisionamento e a configuração de uma instância do Event Notifications.

Exemplo de script para integração de notificações de plataforma usando a CLI

O script en-platform-notification-src-and-email-dest.sh integra as notificações da plataforma com Event Notifications e encaminha as notificações para IBM Inbuilt Email ou Custom Domain Sandbox.

Exemplo de script para integração do IBM Cloud Logs usando a CLI

O script en-icl-src-and-email-dest.sh integra IBM Cloud Logs com Event Notifications e encaminha as notificações para IBM Inbuilt Email ou Custom Domain Sandbox.

Esse script pressupõe que a instância IBM Cloud Logs e a instância Event Notifications estejam na mesma conta.

Histórico da versão da CLI

Localize um resumo de mudanças para cada versão do plug-in do Event Notifications. Mantenha a sua CLI atualizada para que você possa utilizar todos os comandos disponíveis e suas opções.

As versões do plugin CLI de 0.0.5 a 1.9.0 estão obsoletas.

Alterações no IBM Cloud Event Notifications CLI
Versão Data de liberação Mudanças
1.5.0 10 de maio de 2024 Suporte para configuração de SMTP e modelos do Slack.
1.6.0 1º de agosto de 2024 Destino CF obsoleto e MMS suportado.
1.7.0 9 de agosto de 2024 Suporte a métricas e remoção do suporte a IPs permitidos de SMTP da configuração de SMTP.
1.8.0 9 de setembro de 2024 Suporte para o destino do Slack DM.
1.9.0 11 de outubro de 2024 Suporte para modelos de webhook.
1.10.0 4 de novembro de 2024 Removido o suporte para Cloud Functions
1.11.0 7 de janeiro de 2025 Suporte para temporizador periódico
1.12.0 27 de fevereiro de 2025 Suporte para o modelo Pagerduty
1.13.0 6 de março de 2025 Suporte para Event Streams destination, subscription e templates.
1.14.0 28 de abril de 2025 PagerDuty o parâmetro obsoleto de destino api_key está marcado como opcional.
1.15.0 27 de junho de 2025 O conteúdo de remarcação para notificação.
1.16.0 1 de agosto de 2025 Code Engine e suporte a modelos predefinidos.
1.17.0 4 de setembro de 2025 Suporte ao comando get notifications-status do teste de destino do webhook
1.18.0 25 de setembro de 2025 Suporte a destino, assinatura e modelo de configuração de aplicativos
1.19.0 30 de outubro de 2025 Suporte para credenciais de usuário smtp clonadas
1.20.0 15 de dezembro de 2025 Suporte para métricas de rejeição
1.20.1 19 de janeiro de 2026 Correção dos metadados de suporte de endpoint privado e do problema de instalação do plug-in EN em private.cloud.ibm.com
1.20.2 18 de fevereiro de 2026 Atualização do patch de correção da vulnerabilidade do plug-in da CLI
1.21.0 7 de abril de 2026 Atualização do plug-in da CLI para exibir sandbox, anexos de e-mail e suporte a opções de origem para depuração de carga útil
1.21.1 25 de maio de 2026 Comando init e show descontinuado e comando de listagem de instâncias adicionado. Correção fornecida para definir automaticamente o ponto final EN de acordo com a região de destino definida.
1.21.2 29 de junho de 2026 Correção de bug nas métricas SMTP para oferecer suporte ao sinalizador “SMTP Config ID” e marcar o tipo de destino como opcional.
1.21.3 6 de agosto de 2026 Correção de vulnerabilidade no plugin CLI, melhorias de usabilidade e estéticas