

# Trabalhar com a notificação de eventos do Amazon RDS
<a name="USER_Events"></a>

O Amazon RDS usa o Amazon Simple Notification Service (Amazon SNS) para fornecer uma notificação quando um evento do Amazon RDS ocorre. Essas notificações podem estar em qualquer formato de notificação compatível com o Amazon SNS para uma região da AWS, como um e-mail, uma mensagem de texto ou uma chamada para um endpoint HTTP. 

**Topics**
+ [Visão geral das notificações de eventos do Amazon RDS](USER_Events.overview.md)
+ [Conceder permissões para publicar notificações em um tópico do Amazon SNS](USER_Events.GrantingPermissions.md)
+ [Inscrever-se em notificações de eventos do Amazon RDS](USER_Events.Subscribing.md)
+ [Tags e atributos de notificação de eventos do Amazon RDS](USER_Events.TagsAttributesForFiltering.md)
+ [Listar assinaturas de notificação de evento do Amazon RDS](USER_Events.ListSubscription.md)
+ [Modificar uma assinatura de notificação de evento do Amazon RDS](USER_Events.Modifying.md)
+ [Adicionar um identificador de origem a uma assinatura de notificação de evento do Amazon RDS](USER_Events.AddingSource.md)
+ [Remover um identificador de origem de uma assinatura de notificação de eventos do Amazon RDS](USER_Events.RemovingSource.md)
+ [Listar as categorias de notificação de evento do Amazon RDS](USER_Events.ListingCategories.md)
+ [Excluir uma assinatura de notificação de evento do Amazon RDS](USER_Events.Deleting.md)

# Visão geral das notificações de eventos do Amazon RDS
<a name="USER_Events.overview"></a>

O Amazon RDS agrupa eventos em categorias em que você pode se inscrever para receber notificações quando um evento ocorrer na categoria.

**Topics**
+ [Recursos do RDS elegíveis para assinatura de eventos](#USER_Events.overview.resources)
+ [Processo básico de assinatura de notificações de eventos do Amazon RDS](#USER_Events.overview.process)
+ [Entrega de notificações de evento do RDS](#USER_Events.overview.subscriptions)
+ [Faturamento de notificações de eventos do Amazon RDS](#USER_Events.overview.billing)
+ [Exemplos de eventos do Amazon RDS usando o Amazon EventBridge](#events-examples)

## Recursos do RDS elegíveis para assinatura de eventos
<a name="USER_Events.overview.resources"></a>

Você pode se inscrever em uma categoria de evento para os seguintes recursos:
+ DB instance (Instância de banco de dados)
+ DB snapshot
+ Grupo de parâmetros de banco de dados
+ DB security group (grupo de segurança de banco de dados)
+ RDS Proxy
+ Versões de mecanismo personalizadas

Por exemplo, se você se inscrever na categoria de backup para uma determinada instância de banco de dados, receberá notificações sempre que houver um evento relacionado ao backup que afete a instância de banco de dados. Se você se inscrever em uma categoria de alteração de configuração para uma instância de banco de dados, será notificado quando a instância de banco de dados for alterada. Você também recebe uma notificação quando uma assinatura de notificação de evento é alterada.

Você pode querer criar várias assinaturas diferentes. Por exemplo, você pode criar uma assinatura que receba todas as notificações de eventos de todas as instâncias de banco de dados e outra que inclua somente eventos críticos de um subconjunto das instâncias de bancos de dados. Para a segunda assinatura, especifique uma ou mais instâncias de banco de dados no filtro.

## Processo básico de assinatura de notificações de eventos do Amazon RDS
<a name="USER_Events.overview.process"></a>

O processo de inscrição na notificação de evento do Amazon RDS é o seguinte:

1. Você cria uma assinatura de notificação de eventos do Amazon RDS usando o console do Amazon RDS, a AWS CLI ou a API.

   O Amazon RDS usa o ARN de um tópico do Amazon SNS para identificar cada assinatura. O console do Amazon RDS cria o ARN para você quando cria a assinatura. Crie o ARN usando o console do Amazon SNS, a AWS CLI ou a API do Amazon SNS.

1. O Amazon RDS envia um e-mail ou mensagem SMS de aprovação para os endereços que você submeteu com a assinatura.

1. Você confirma a assinatura escolhendo o link na notificação que recebeu.

1. O console do Amazon RDS atualiza a seção **My Event Subscriptions** (Minhas assinaturas de eventos) com o status de sua assinatura.

1. O Amazon RDS começa a enviar notificações aos endereços que você forneceu ao criar a assinatura.

Para saber mais sobre o Gerenciamento de Identidade e Acesso ao usar o Amazon SNS, consulte [Gerenciamento de Identidade e Acesso no Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-authentication-and-access-control.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.

É possível usar o AWS Lambda para processar notificações de eventos de uma instância de banco de dados. Para obter mais informações, consulte [Uso do AWS Lambda com o Amazon RDS](https://docs.aws.amazon.com/lambda/latest/dg/services-rds.html) no *Guia do desenvolvedor do AWS Lambda*.

## Entrega de notificações de evento do RDS
<a name="USER_Events.overview.subscriptions"></a>

O Amazon RDS envia notificações aos endereços que você fornece ao criar a assinatura. A notificação pode incluir atributos de mensagem que fornecem metadados estruturados sobre a mensagem. Para obter mais informações sobre os atributos de mensagem, consulte [Categorias de eventos e mensagens de eventos ](USER_Events.Messages.md).

As notificações de eventos podem levar até cinco minutos para serem entregues.

**Importante**  
O Amazon RDS não garante a ordem dos eventos enviados em um fluxo de eventos. A ordem do evento está sujeita a alterações.

Quando o Amazon SNS envia uma notificação para um endpoint HTTP ou HTTPS inscrito, a mensagem POST enviada ao endpoint tem um corpo de mensagem que contém um documento JSON. Para obter mais informações, consulte [Mensagens do Amazon SNS e formatos JSON](https://docs.aws.amazon.com/sns/latest/dg/sns-message-and-json-formats.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.

É possível configurar o SNS para notificar você com mensagens de texto. Para obter mais informações, consulte [Mensagens de texto móveis (SMS)](https://docs.aws.amazon.com/sns/latest/dg/sns-mobile-phone-number-as-subscriber.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.

Para desativar as notificações sem excluir uma assinatura, escolha **No** (Não) para **Enabled** (Habilitado) no console do Amazon RDS. Ou você pode definir o parâmetro `Enabled` para `false` usando a AWS CLI ou a API do Amazon RDS.

## Faturamento de notificações de eventos do Amazon RDS
<a name="USER_Events.overview.billing"></a>

O faturamento da notificação de eventos do Amazon RDS é feito por meio do Amazon SNS. As taxas do Amazon SNS se aplicam durante o uso da notificação de eventos. Para obter mais informações sobre o faturamento do Amazon SNS, consulte [Preço do Amazon Simple Notification Service](https://aws.amazon.com/sns/#pricing).

## Exemplos de eventos do Amazon RDS usando o Amazon EventBridge
<a name="events-examples"></a>

Os exemplos a seguir mostram diferentes tipos de eventos do Amazon RDS no formato JSON. Para acessar um tutorial que mostre como capturar e visualizar eventos no formato JSON, consulte [Tutorial: Registro de alterações de estado de uma instância de banco de dados usando o Amazon EventBridge](rds-cloud-watch-events.md#log-rds-instance-state).

**Topics**
+ [Exemplo de um evento de instância de banco de dados](#rds-cloudwatch-events.db-instances)
+ [Exemplo de um evento de grupo de parâmetros de banco de dados](#rds-cloudwatch-events.db-parameter-groups)
+ [Exemplo de um evento de snapshot do banco de dados](#rds-cloudwatch-events.db-snapshots)

### Exemplo de um evento de instância de banco de dados
<a name="rds-cloudwatch-events.db-instances"></a>

Veja a seguir um exemplo de um evento de instância de banco de dados no formato JSON. O evento mostra que o RDS executou um failover multi-AZ para a instância chamada `my-db-instance`. O ID do evento é RDS-EVENT-0049.

```
{
  "version": "0",
  "id": "68f6e973-1a0c-d37b-f2f2-94a7f62ffd4e",
  "detail-type": "RDS DB Instance Event",
  "source": "aws.rds",
  "account": "123456789012",
  "time": "2018-09-27T22:36:43Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:rds:us-east-1:123456789012:db:my-db-instance"
  ],
  "detail": {
    "EventCategories": [
      "failover"
    ],
    "SourceType": "DB_INSTANCE",
    "SourceArn": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
    "Date": "2018-09-27T22:36:43.292Z",
    "Message": "A Multi-AZ failover has completed.",
    "SourceIdentifier": "my-db-instance",
    "EventID": "RDS-EVENT-0049"
  }
}
```

### Exemplo de um evento de grupo de parâmetros de banco de dados
<a name="rds-cloudwatch-events.db-parameter-groups"></a>

Veja a seguir um exemplo de um evento de grupo de parâmetros de banco de dados no formato JSON. O evento mostra que o parâmetro `time_zone` foi atualizado no grupo de parâmetros `my-db-param-group`. O ID do evento é RDS-EVENT-0037.

```
{
  "version": "0",
  "id": "844e2571-85d4-695f-b930-0153b71dcb42",
  "detail-type": "RDS DB Parameter Group Event",
  "source": "aws.rds",
  "account": "123456789012",
  "time": "2018-10-06T12:26:13Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:rds:us-east-1:123456789012:pg:my-db-param-group"
  ],
  "detail": {
    "EventCategories": [
      "configuration change"
    ],
    "SourceType": "DB_PARAM",
    "SourceArn": "arn:aws:rds:us-east-1:123456789012:pg:my-db-param-group",
    "Date": "2018-10-06T12:26:13.882Z",
    "Message": "Updated parameter time_zone to UTC with apply method immediate",
    "SourceIdentifier": "my-db-param-group",
    "EventID": "RDS-EVENT-0037"
  }
}
```

### Exemplo de um evento de snapshot do banco de dados
<a name="rds-cloudwatch-events.db-snapshots"></a>

Veja a seguir um exemplo de um evento de snapshot de banco de dados no formato JSON. O evento mostra a exclusão do snapshot chamado `my-db-snapshot`. O ID do evento é RDS-EVENT-0041.

```
{
  "version": "0",
  "id": "844e2571-85d4-695f-b930-0153b71dcb42",
  "detail-type": "RDS DB Snapshot Event",
  "source": "aws.rds",
  "account": "123456789012",
  "time": "2018-10-06T12:26:13Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:rds:us-east-1:123456789012:snapshot:rds:my-db-snapshot"
  ],
  "detail": {
    "EventCategories": [
      "deletion"
    ],
    "SourceType": "SNAPSHOT",
    "SourceArn": "arn:aws:rds:us-east-1:123456789012:snapshot:rds:my-db-snapshot",
    "Date": "2018-10-06T12:26:13.882Z",
    "Message": "Deleted manual snapshot",
    "SourceIdentifier": "my-db-snapshot",
    "EventID": "RDS-EVENT-0041"
  }
}
```

# Conceder permissões para publicar notificações em um tópico do Amazon SNS
<a name="USER_Events.GrantingPermissions"></a>

Para conceder permissões do Amazon RDS a fim de publicar notificações em um tópico do Amazon Simple Notification Service (Amazon SNS), anexe uma política do AWS Identity and Access Management (IAM) ao tópico de destino. Para obter mais informações sobre permissões, consulte [ Exemplos de casos de controle de acesso do Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.

Por padrão, um tópico do Amazon SNS tem uma política que permite que todos os recursos do Amazon RDS na mesma conta publiquem notificações nele. Você pode anexar uma política personalizada para possibilitar notificações entre contas ou restringir o acesso a determinados recursos.

Veja a seguir um exemplo de uma política do IAM anexada ao tópico de destino do Amazon SNS. Ela restringe o tópico a instâncias de banco de dados com nomes correspondentes ao prefixo especificado. Para usar essa política, especifique os seguintes valores:
+ `Resource`: o nome do recurso da Amazon (ARN) do tópico do Amazon SNS
+ `SourceARN`: o ARN de recursos do RDS
+ `SourceAccount`: o ID de sua Conta da AWS

Para ver uma lista dos tipos de recursos e seus ARNs, consulte [Recursos definidos pelo Amazon RDS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonrds.html#amazonrds-resources-for-iam-policies) na *Referência de autorização do serviço*.

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "events.rds.amazonaws.com"
      },
      "Action": [
        "sns:Publish"
      ],
      "Resource": "arn:aws:sns:us-east-1:123456789012:topic_name",
      "Condition": {
        "ArnLike": {
          "aws:SourceArn": "arn:aws:rds:us-east-1:123456789012:db:prefix-*"
        },
        "StringEquals": {
          "aws:SourceAccount": "123456789012"
        }
      }
    }
  ]
}
```

------

# Inscrever-se em notificações de eventos do Amazon RDS
<a name="USER_Events.Subscribing"></a>

A forma mais fácil de criar uma assinatura é com o console do RDS. Se você preferir criar assinaturas de notificações de eventos usando a CLI ou API, é necessário criar um tópico do Amazon Simple Notification Service e fazer a assinatura desse tópico com o console do Amazon SNS ou a API do Amazon SNS. Também será necessário reter o nome de recurso da Amazon (ARN) do tópico, pois ele é usado ao enviar comandos da CLI ou operações da API. Para obter informações sobre como criar um tópico do SNS e assiná-lo, consulte [Conceitos básicos do Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/GettingStarted.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.

Você pode especificar o tipo de origem sobre o qual deseja ser notificado e a origem do Amazon RDS que aciona o evento:

**Source type** (Tipo de origem)  
O tipo de fonte. Por exemplo, **Source type** (Tipo de origem) pode ser **Instances** (Instâncias). Você deve escolher um tipo de origem.

***Resources* to include** (Recursos para incluir)  
Os recursos do Amazon RDS que estão gerando os eventos. Por exemplo, você pode escolher **Select specific instances** (Selecionar instâncias específicas), depois **myDBInstance1**. 

A tabela a seguir explica o resultado quando você especifica ou não ***Resources* to include** (Recursos para incluir).


|  Recursos para incluir  |  Descrição  |  Exemplo  | 
| --- | --- | --- | 
|  Especificado  |  O RDS notifica você sobre todos os eventos somente do recurso especificado.  | Se o seu Source type (Tipo de origem) for Instances (Instâncias) e seu recurso for myDBInstance1, o RDS notificará você sobre todos os eventos somente para myDBInstance1. | 
|  Não especificado  |  O RDS notifica você sobre os eventos do tipo de fonte especificado para todos os recursos do Amazon RDS.   |  Se o **Source type** (Tipo de origem) for **Instances** (Instâncias), o RDS notificará você sobre todos os eventos relacionados à instância em sua conta.  | 

Por padrão, um assinante de tópico do Amazon SNS recebe todas as mensagens publicadas no tópico. Para receber apenas um subconjunto das mensagens, o assinante deve atribuir uma política de filtro à assinatura do tópico. Para obter mais informações sobre filtragem de mensagens do SNS, consulte [Filtragem de mensagens do Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-message-filtering.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.

## Console
<a name="USER_Events.Subscribing.Console"></a>

**Para assinar a notificação de eventos do RDS**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. No painel de navegação, escolha **Event subscriptions (Assinaturas de eventos)**. 

1. No painel **Event subscriptions (Assinaturas de eventos)**, escolha **Create event subscription (Criar assinatura de evento)**. 

1. Insira os detalhes da sua assinatura da seguinte forma:

   1. Em **Name** (Nome), insira um nome para a assinatura de notificação de eventos.

   1. Para **Send notifications to** (Enviar notificação para), utilize um dos seguintes procedimentos:
      + Escolha **New email topic** (Novo tópico de e-mail). Insira um nome para o tópico do seu e-mail e uma lista de destinatários. Recomendamos que você configure as assinaturas de eventos com o mesmo endereço de e-mail do contato primário da sua conta. As mensagens de recomendações, eventos de serviço e integridade pessoal são enviadas por meio de canais diferentes. As assinaturas com o mesmo endereço de e-mail garantem que todas as mensagens sejam consolidadas em um único local.
      + Escolha **Amazon Resource Name (ARN)** [Nome do recurso da Amazon (ARN)]. Depois, escolha o ARN do Amazon SNS existente para um tópico do Amazon SNS.

        Se você quiser usar um tópico que tenha sido ativado para criptografia do lado do servidor (SSE), conceda ao Amazon RDS as permissões necessárias para acessar a AWS KMS key. Para obter mais informações, consulte [ Ativar a compatibilidade entre as fontes de eventos de tópicos criptografados e serviços da AWS](https://docs.aws.amazon.com/sns/latest/dg/sns-key-management.html#compatibility-with-aws-services) no *Guia do desenvolvedor do Amazon Simple Notification Service*.

   1. Em **Source type (Tipo de origem)**, escolha um tipo de origem. Por exemplo, escolha **Instances** (Instâncias) ou **Parameter groups** (Grupos de parâmetros).

   1. Escolha as categorias e recursos de eventos para os quais quer receber notificações de eventos.

      O exemplo a seguir configura notificações de eventos para a instância de banco de dados denominada `testinst`.  
![\[Insira o tipo de fonte\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/event-source.png)

   1. Escolha **Criar**.

O console do Amazon RDS indica que a assinatura está sendo criada.

![\[Listar assinaturas de notificação de evento de banco de dados\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/EventNotification-Create2.png)


## AWS CLI
<a name="USER_Events.Subscribing.CLI"></a>

Para assinar a Notificação de eventos do RDS, use o comando [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/rds/create-event-subscription.html) da `create-event-subscription`. Inclua os seguintes parâmetros necessários:
+ `--subscription-name`
+ `--sns-topic-arn`

**Example**  
Para Linux, macOS ou Unix:  

```
aws rds create-event-subscription \
    --subscription-name myeventsubscription \
    --sns-topic-arn arn:aws:sns:us-east-1:123456789012:myawsuser-RDS \
    --enabled
```
Para Windows:  

```
aws rds create-event-subscription ^
    --subscription-name myeventsubscription ^
    --sns-topic-arn arn:aws:sns:us-east-1:123456789012:myawsuser-RDS ^
    --enabled
```

## API
<a name="USER_Events.Subscribing.API"></a>

Para assinar a notificação de eventos do Amazon RDS, chame a função da API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateEventSubscription.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateEventSubscription.html) do Amazon RDS. Inclua os seguintes parâmetros necessários: 
+ `SubscriptionName`
+ `SnsTopicArn`

# Tags e atributos de notificação de eventos do Amazon RDS
<a name="USER_Events.TagsAttributesForFiltering"></a>

Quando o Amazon RDS envia uma notificação de evento ao Amazon Simple Notification Service (SNS) ou ao Amazon EventBridge, a notificação contém atributos de mensagem e tags de evento. O RDS envia os atributos da mensagem separadamente com a mensagem, enquanto as tags de evento estão no corpo da mensagem. Use os atributos de mensagem e as tags do Amazon RDS para adicionar metadados aos seus recursos. Você pode modificar essas tags com suas próprias notações sobre as instâncias de banco de dados Para ter mais informações sobre recursos de marcação do Amazon RDS, consulte [Marcar recursos do do Amazon RDS](USER_Tagging.md). 

Por padrão, o Amazon SNS e o Amazon EventBridge recebem todas as mensagens enviadas a eles. O SNS e o EventBridge podem filtrar a mensagem e enviar as notificações ao modo de comunicação preferencial, como um e-mail, uma mensagem de texto ou uma chamada para um endpoint HTTP.

**nota**  
A notificação enviada em um e-mail ou uma mensagem de texto não terá tags de evento.

A tabela a seguir mostra os atributos da mensagem de eventos do RDS enviada ao assinante do tópico.


| Atributo de evento do Amazon RDS |  Descrição  | 
| --- | --- | 
| EventID |  Identificador da mensagem de eventos do RDS, por exemplo, RDS-EVENT-0006.  | 
| Recurso |  O identificador do ARN do recurso que emite o evento, por exemplo, `arn:aws:rds:ap-southeast-2:123456789012:db:database-1`.  | 

As tags do RDS fornecem dados sobre o recurso que foi afetado pelo evento do serviço. O RDS adiciona o estado atual das tags ao corpo da mensagem quando a notificação é enviada ao SNS ou ao EventBridge.

Para ter mais informações sobre filtragem de atributos de mensagens do SNS, consulte [Filtragem de mensagens do Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-message-filtering.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.

Para obter mais informações sobre a filtragem de tags de evento para o EventBridge, consulte [Operadores de comparação para uso em padrões de eventos do Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns-content-based-filtering.html) no *Guia do usuário do Amazon EventBridge*.

Para obter mais informações sobre a filtragem de tags baseadas em carga útil para o SNS, consulte [Introdução à filtragem de mensagens baseadas em carga útil para o Amazon SNS](https://aws.amazon.com/blogs/compute/introducing-payload-based-message-filtering-for-amazon-sns/)

# Listar assinaturas de notificação de evento do Amazon RDS
<a name="USER_Events.ListSubscription"></a>

Você pode listar suas atuais assinaturas de notificações de eventos do Amazon RDS.

## Console
<a name="USER_Events.ListSubscription.Console"></a>

**Para listar suas atuais assinaturas de notificações de eventos do Amazon RDS**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1.  No painel de navegação, escolha **Event subscriptions (Assinaturas de eventos)**. O painel **Event subscriptions (Assinaturas de eventos)** exibirá todas as suas assinaturas de notificação de eventos.  
![\[Listar assinaturas de notificação de evento de banco de dados\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/EventNotification-ListSubs.png)

   

## AWS CLI
<a name="USER_Events.ListSubscription.CLI"></a>

Para listar suas atuais assinaturas de notificações de eventos do Amazon RDS, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-event-subscriptions.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-event-subscriptions.html)I. 

**Example**  
O exemplo a seguir descreve todas as assinaturas de eventos.  

```
aws rds describe-event-subscriptions
```
O exemplo a seguir descreve a pilha `myfirsteventsubscription`.  

```
aws rds describe-event-subscriptions --subscription-name myfirsteventsubscription
```

## API
<a name="USER_Events.ListSubscription.API"></a>

Para listar suas atuais assinaturas de notificações de eventos do Amazon RDS, chame a ação da API do Amazon RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeEventSubscriptions.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeEventSubscriptions.html).

# Modificar uma assinatura de notificação de evento do Amazon RDS
<a name="USER_Events.Modifying"></a>

Depois que você criar uma assinatura, é possível alterar o nome, identificador de origem, categorias ou ARN do tópico da assinatura.

## Console
<a name="USER_Events.Modifying.Console"></a>

**Para modificar uma assinatura de notificação de evento do Amazon RDS**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1.  No painel de navegação, escolha **Event subscriptions (Assinaturas de eventos)**. 

1.  No painel **Event subscriptions (Assinaturas de eventos)**, escolha a assinatura que deseja modificar e escolha **Edit (Editar)**. 

1.  Faça as alterações na assinatura usando as seções **Target (Alvo)** ou **Source (Origem)**.

1. Selecione a opção **Editar**. O console do Amazon RDS indica que a assinatura está sendo modificada.  
![\[Listar assinaturas de notificação de evento de banco de dados\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/EventNotification-Modify2.png)

   

## AWS CLI
<a name="USER_Events.Modifying.CLI"></a>

Para modificar uma assinatura de notificação de evento do Amazon RDS, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-event-subscription.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-event-subscription.html). Inclua o seguinte parâmetro necessário:
+ `--subscription-name`

**Example**  
O código a seguir habilita `myeventsubscription`.  
Para Linux, macOS ou Unix:  

```
aws rds modify-event-subscription \
    --subscription-name myeventsubscription \
    --enabled
```
Para Windows:  

```
aws rds modify-event-subscription ^
    --subscription-name myeventsubscription ^
    --enabled
```

## API
<a name="USER_Events.Modifying.API"></a>

Para modificar um evento do Amazon RDS, chame a operação da API do Amazon RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyEventSubscription.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyEventSubscription.html). Inclua o seguinte parâmetro necessário:
+ `SubscriptionName`

# Adicionar um identificador de origem a uma assinatura de notificação de evento do Amazon RDS
<a name="USER_Events.AddingSource"></a>

Você pode adicionar um identificador de origem (a origem do Amazon RDS que gera o evento) à uma assinatura existente.

## Console
<a name="USER_Events.AddingSource.Console"></a>

Você pode facilmente adicionar ou remover identificadores de origem usando o console do Amazon RDS selecionando-os ou desmarcando-os ao modificar uma assinatura. Para obter mais informações, consulte [Modificar uma assinatura de notificação de evento do Amazon RDS](USER_Events.Modifying.md).

## AWS CLI
<a name="USER_Events.AddingSource.CLI"></a>

Para adicionar um identificador de origem a uma assinatura de notificação de eventos do Amazon RDS, use o comando da AWS CLI [https://docs.aws.amazon.com/](https://docs.aws.amazon.com/). Inclua os seguintes parâmetros necessários:
+ `--subscription-name`
+ `--source-identifier`

**Example**  
O exemplo a seguir adiciona o identificador de origem `mysqldb` à assinatura `myrdseventsubscription`  
Para Linux, macOS ou Unix:  

```
aws rds add-source-identifier-to-subscription \
    --subscription-name myrdseventsubscription \
    --source-identifier mysqldb
```
Para Windows:  

```
aws rds add-source-identifier-to-subscription ^
    --subscription-name myrdseventsubscription ^
    --source-identifier mysqldb
```

## solicitações de
<a name="USER_Events.AddingSource.API"></a>

Para adicionar um identificador de origem a uma assinatura de notificação de evento do Amazon RDS, chame a API do Amazon RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AddSourceIdentifierToSubscription.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AddSourceIdentifierToSubscription.html). Inclua os seguintes parâmetros necessários:
+ `SubscriptionName`
+ `SourceIdentifier`

# Remover um identificador de origem de uma assinatura de notificação de eventos do Amazon RDS
<a name="USER_Events.RemovingSource"></a>

Você pode remover um identificador de origem (a origem do Amazon RDS que gera o evento) de uma assinatura se você não quiser mais ser notificado sobre eventos para aquela origem. 

## Console
<a name="USER_Events.RemovingSource.Console"></a>

Você pode facilmente adicionar ou remover identificadores de origem usando o console do Amazon RDS selecionando-os ou desmarcando-os ao modificar uma assinatura. Para obter mais informações, consulte [Modificar uma assinatura de notificação de evento do Amazon RDS](USER_Events.Modifying.md).

## AWS CLI
<a name="USER_Events.RemovingSource.CLI"></a>

Para remover um identificador de origem de uma assinatura de notificação de eventos do Amazon RDS, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/remove-source-identifier-from-subscription.html](https://docs.aws.amazon.com/cli/latest/reference/rds/remove-source-identifier-from-subscription.html). Inclua os seguintes parâmetros necessários:
+ `--subscription-name`
+ `--source-identifier`

**Example**  
O exemplo a seguir remove o identificador de origem `mysqldb` da assinatura `myrdseventsubscription`.  
Para Linux, macOS ou Unix:  

```
aws rds remove-source-identifier-from-subscription \
    --subscription-name myrdseventsubscription \
    --source-identifier mysqldb
```
Para Windows:  

```
aws rds remove-source-identifier-from-subscription ^
    --subscription-name myrdseventsubscription ^
    --source-identifier mysqldb
```

## solicitações de
<a name="USER_Events.RemovingSource.API"></a>

Para remover um identificador de origem de uma assinatura de notificação de eventos do Amazon RDS, use o comando [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RemoveSourceIdentifierFromSubscription.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RemoveSourceIdentifierFromSubscription.html) da API do Amazon RDS. Inclua os seguintes parâmetros necessários:
+ `SubscriptionName`
+ `SourceIdentifier`

# Listar as categorias de notificação de evento do Amazon RDS
<a name="USER_Events.ListingCategories"></a>

Todos os eventos para um tipo de recurso são agrupados em categorias. Para visualizar a lista de categorias disponíveis, use os seguintes procedimentos.

## Console
<a name="USER_Events.ListingCategories.Console"></a>

Quando você cria ou modifica uma assinatura de notificação de evento, as categorias de eventos são exibidas no console do Amazon RDS. Para obter mais informações, consulte [Modificar uma assinatura de notificação de evento do Amazon RDS](USER_Events.Modifying.md). 

![\[Listar categorias de notificação de evento de banco de dados\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/EventNotification-Categories.png)




## AWS CLI
<a name="USER_Events.ListingCategories.CLI"></a>

Para listar as categorias de notificação de evento do Amazon RDS, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-event-categories.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-event-categories.html). Esse comando não possui parâmetros necessários.

**Example**  

```
aws rds describe-event-categories
```

## API
<a name="USER_Events.ListingCategories.API"></a>

Para listar as categorias de notificação de evento do Amazon RDS, use o comando [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeEventCategories.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeEventCategories.html) da API do Amazon RDS. Esse comando não possui parâmetros necessários.

# Excluir uma assinatura de notificação de evento do Amazon RDS
<a name="USER_Events.Deleting"></a>

É possível excluir uma assinatura quando não precisar mais dela. Todos os assinantes do tópico não receberão mais notificações de evento especificadas pela assinatura.

## Console
<a name="USER_Events.Deleting.Console"></a>

**Para excluir uma assinatura de notificação de evento do Amazon RDS**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1.  No painel de navegação, escolha **DB Event Subscriptions (Assinaturas de eventos de banco de dados)**. 

1.  No painel **My DB Event Subscriptions (Minhas assinaturas de eventos de banco de dados)**, escolha a assinatura que deseja excluir. 

1. Escolha **Excluir**.

1. O console do Amazon RDS indica que a assinatura está sendo excluída.  
![\[Excluir uma assinatura de notificação de evento\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/EventNotification-Delete.png)

   

## AWS CLI
<a name="USER_Events.Deleting.CLI"></a>

Para excluir uma assinatura de notificação de evento do Amazon RDS, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/delete-event-subscription.html](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-event-subscription.html). Inclua o seguinte parâmetro necessário:
+ `--subscription-name`

**Example**  
O exemplo a seguir exclui a assinatura `myrdssubscription`.  

```
aws rds delete-event-subscription --subscription-name myrdssubscription
```

## API
<a name="USER_Events.Deleting.API"></a>

Para excluir uma assinatura de notificação de evento do Amazon RDS, use o comando [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteEventSubscription.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteEventSubscription.html) da API do RDS. Inclua o seguinte parâmetro necessário:
+ `SubscriptionName`