# 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`