As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Usar assinaturas de eventos do Amazon DocumentDB
O Amazon DocumentDB usa o Amazon Simple Notification Service (Amazon SNS) para fornecer uma notificação quando um evento do Amazon DocumentDB ocorre. Essas notificações podem estar em qualquer formato compatível com o Amazon SNS para um Região da AWS, como um e-mail, uma mensagem de texto ou uma chamada para um endpoint HTTP.
O Amazon DocumentDB agrupa esses eventos em categorias nas quais é possível inscrever-se para receber notificações quando ocorre um evento dessa categoria. É possível assinar uma categoria de evento para uma instância, cluster, o snapshot, snapshot do cluster, ou para uma grupo de parâmetros. Por exemplo, se você se inscrever na categoria Backup para uma determinada instância, será notificado sempre que ocorrer um evento relacionado ao backup que afete a instância. Você também recebe uma notificação quando uma assinatura de evento é alterada.
Ocorrem eventos tanto no nível do cluster, quanto no nível da instância, portanto, é possível receber eventos assinar em um cluster ou uma instância.
Assinaturas de eventos são enviadas aos endereços que você fornece ao criar a assinatura. Pode ser interessante criar várias assinaturas diferentes, como uma assinatura para receber todas as notificações de eventos e outra que inclua somente eventos críticos para as suas instâncias de produção. É possível facilmente desativar a notificação sem excluir uma assinatura. Para fazer isso, defina o botão **Habilitado** como **Não** no console do Amazon DocumentDB.
**Importante**
O Amazon DocumentDB não garante a ordem dos eventos enviados em um fluxo de eventos. A ordem do evento está sujeita a alterações.
O Amazon DocumentDB usa o nome do recurso da Amazon (ARN) de um tópico do Amazon SNS para identificar cada assinatura. O console do Amazon DocumentDB cria o ARN para você quando você cria a assinatura.
O faturamento das assinaturas de eventos do Amazon DocumentDB é 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, consulte Amazon Simple Notification Service Pricing. Além das cobranças do Amazon SNS, o Amazon DocumentDB não cobra por assinaturas de eventos.
**Topics**
+ [Assinar eventos](event-subscriptions.subscribe.md)
+ [Gerenciar assinaturas do](event-subscriptions.managing.md)
+ [Categorias e mensagens](event-subscriptions.categories-messages.md)
# Tornar-se assinante de eventos do Amazon DocumentDB
É possível usar o console do Amazon DocumentDB para se inscrever em assinaturas de eventos, da seguinte forma:
1. Faça login no Console de gerenciamento da AWS at[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. No painel de navegação, escolha **Assinaturas de eventos**.
![\[Painel de navegação do console do Amazon DocumentDB com a opção Assinaturas de eventos destacada.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/event-subs/subscribe-event-subs.png)
1. No painel **Event subscriptions (Assinaturas de eventos)**, escolha **Create event subscription (Criar assinatura de evento)**.
![\[Painel Assinaturas de eventos, destacando o botão Criar assinatura de evento no canto superior direito.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/event-subs/subscribe-create.png)
1. Na caixa de diálogo **Criar assinatura de evento** faça o seguinte:
+ Em **Name** (Nome), insira um nome para a assinatura de notificação de eventos.
![\[O formulário Criar assinatura de evento, mostrando a seção Detalhes e o campo de entrada Nome.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/event-subs/subscribe-name.png)
+ Para **Destino**, escolha para onde você deseja enviar notificações. É possível escolher um **ARN** existente ou escolher **Novo tópico de e-mail** para inserir o nome de um tópico e uma lista de destinatários.
![\[A seção Destino, com opções para especificar para onde enviar notificações.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/event-subs/subscribe-target.png)
+ Em **Origem**, escolha um tipo de origem. Dependendo do tipo de origem que você selecionou, escolha as categorias e origens de eventos para as quais quer receber notificações de eventos.
![\[A seção Origem, para selecionar um tipo de origem para receber notificações de eventos.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/event-subs/subscribe-source.png)
+ Escolha **Criar**.
![\[A seção Origem com o botão Criar no canto inferior direito.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/event-subs/subscribe-create-2.png)
# Gerenciar assinaturas de notificação de eventos do Amazon DocumentDB
Se você escolher **Assinaturas de eventos** no painel de navegação do console do Amazon DocumentDB, é possível visualizar categorias de assinatura e uma lista das suas assinaturas atuais. Você também pode modificar ou excluir uma assinatura específica.
## Para listar suas atuais assinaturas de notificações de eventos do Amazon DocumentDB
1. Faça login no Console de gerenciamento da AWS at[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
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.
![\[Painel de navegação do console do Amazon DocumentDB com a opção Assinaturas de eventos destacada.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/event-subs/modify-event-subs.png)
1. No painel **Event subscriptions (Assinaturas de eventos)**, escolha a assinatura que deseja modificar e escolha **Edit (Editar)**.
![\[O painel Inscrições de eventos, mostrando uma assinatura selecionada e o botão Editar.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/event-subs/modify-edit.png)
1. Faça as alterações na assinatura usando as seções **Destino** ou **Origem**. É possível adicionar ou remover identificadores de origem selecionando-os ou desmarcando-os na seção Fonte.
![\[O formulário Modificar assinatura de evento, destacando a seção Destino.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/event-subs/modify-target.png)
1. Escolha **Modificar**. O console do Amazon DocumentDB indica que a assinatura está sendo modificada.
![\[O final do formulário Modificar assinatura de evento, com o botão Modificar destacado.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/event-subs/modify-button.png)
## Como excluir uma assinatura de notificação de evento do Amazon DocumentDB
É 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.
1. Faça login no Console de gerenciamento da AWS at[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. No painel de navegação, escolha **Assinaturas de eventos**.
![\[Painel de navegação do console do Amazon DocumentDB com a opção Assinaturas de eventos destacada.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/event-subs/delete-event-subs.png)
1. No painel **Minhas assinaturas de eventos de banco de dados**, escolha a assinatura que deseja excluir.
![\[O ASsinaturas de eventos, mostrando uma assinatura selecionada.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/event-subs/delete-select.png)
1. Escolha **Excluir**.
![\[O painel Assinaturas de eventos, destacando o botão Excluir.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/event-subs/delete-delete.png)
1. Uma janela pop-up aparecerá perguntando se você deseja excluir permanentemente essa notificação. Escolha **Excluir**.
![\[Uma caixa de diálogo confirmando a exclusão da assinatura do evento com o botão Excluir destacado no canto inferior direito.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/event-subs/delete-delete-2.png)
# Categorias e mensagens de eventos do Amazon DocumentDB
O Amazon DocumentDB gera um número significativo de eventos em categorias nas quais é possível fazer uma assinatura usando o console. Cada categoria aplica-se a um tipo de origem, que pode ser uma instância, um cluster, um snapshot ou um grupo de parâmetros.
**nota**
O Amazon DocumentDB usa definições de eventos existentes do Amazon RDS e. IDs
## Eventos do Amazon DocumentDB originados de instâncias
| Categoria | Description |
| --- | --- |
| disponibilidade | A instância foi reiniciada. |
| disponibilidade | Desligamento da instância. |
| alteração de configuração | Como aplicar uma modificação à classe de instância. |
| alteração de configuração | Conclusão da aplicação de modificação à classe de instância. |
| alteração de configuração | Redefinir as credenciais principais. |
| criação | Instância criada. |
| exclusão | Instância excluída |
| falha | Houve falha na instância de banco de dados devido a uma configuração incompatível ou a um problema do armazenamento subjacente. Comece um point-in-time-restore para a instância. |
| notificação | A Instância foi interrompida. |
| notificação | A instância foi iniciada. |
| notificação | A instância está sendo iniciada porque excede o tempo máximo permitido para permanecer parada. |
| recuperação | A recuperação da instância começou. O tempo de recuperação variará dependendo da quantidade de dados a serem recuperados. |
| recuperação | A recuperação da instância está completa. |
| patches de segurança | A atualização do sistema operacional está disponível para a sua instância. Para obter informações sobre a aplicação de atualizações, consulte [Manutenção do Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html). |
## Eventos do Amazon DocumentDB originados de um cluster
| Categoria | Description |
| --- | --- |
| criação | Cluster criado |
| exclusão | Cluster excluído. |
| failover | Como promover novamente a primária anterior. |
| failover | Failover concluído para a instância. |
| failover | Iniciou o failover para a instância de banco de dados: %s |
| failover | Iniciou o mesmo failover da AZ para a instância de banco de dados: %s |
| failover | Iniciou o failover cruzado da AZ para a instância de banco de dados: %s |
| manutenção | O cluster foi corrigido. |
| manutenção | O cluster do banco de dados está em um estado que não pode ser atualizado: %s |
| notificação | O cluster parou. |
| notificação | O cluster iniciou. |
| notificação | Falha na parada do cluster. |
| notificação | O cluster está sendo iniciado porque excede o tempo máximo permitido para permanecer parado. |
| notificação | Cluster renomeado de %s para %s. |
## Eventos do Amazon DocumentDB originados de um snapshot de cluster
AA tabela a seguir mostra a categoria de evento e uma lista de eventos quando um snapshot de cluster do Amazon DocumentDB é o tipo de origem.
| Categoria | Description |
| --- | --- |
| backup | Criação de um snapshot manual do cluster. |
| backup | Snapshot de cluster manual criado. |
| backup | Criando snapshot de cluster automatizado. |
| backup | Snapshot de cluster automatizado criado. |
## Eventos do Amazon DocumentDB originados de um grupo de parâmetros
A tabela a seguir mostra a categoria de evento e uma lista de eventos quando um parameter group é o tipo de origem.
| Categoria | Description |
| --- | --- |
| alteração de configuração | Parâmetro atualizado de %s para %s com o método de aplicação %s |