Usar a notificação de evento do Amazon RDS

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.

O Amazon RDS agrupa esses eventos em categorias nas quais você pode inscrever-se para receber notificações quando se verificar um evento dessa categoria. Você pode assinar uma categoria de evento para uma instância de banco de dados, , snapshot de banco de dados, parameter group de banco de dados ou grupo de segurança de banco de dados. Por exemplo, se você se inscrever na categoria Backup para uma determinada instância de banco de dados, será notificado sempre que ocorrer 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 um grupo de segurança de banco de dados, será notificado quando esse grupo de segurança de banco de dados for alterado. Você também recebe uma notificação quando uma assinatura de notificação de evento é alterada.

Notificações 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 bancos de dados de produção. As notificações podem ser facilmente desativadas sem que seja necessário excluir uma assinatura escolhendo No (Não) para Enabled (Habilitado) no console do Amazon RDS ou definindo o parâmetro Enabled como false usando a AWS CLI ou a API do Amazon RDS.

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.

nota

Para obter mais informações sobre como usar mensagens de texto com o SNS, consulte Mensagens de texto móveis (SMS) no Guia do desenvolvedor do Amazon Simple Notification Service.

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. Se usar a CLI ou a API, você criará o ARN usando o console do Amazon SNS ou a API do Amazon SNS ao criar uma assinatura.

O faturamento da notificação de eventos do Amazon RDS é feito por meio do Amazon Simple Notification Service (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 Definição de preço do Amazon Simple Notification Service.

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

1. Crie uma assinatura de notificação de evento do Amazon RDS usando o console do Amazon RDS, a AWS CLI ou a API.

2. O Amazon RDS envia um e-mail ou mensagem SMS de aprovação para os endereços que você submeteu com a assinatura. Para confirmar a assinatura, escolha o link da notificação que você recebeu.

3. Quando a assinatura é confirmada, o status da assinatura é atualizado no console do Amazon RDS, seção My Event Subscriptions (Minhas assinaturas de eventos).

4. Em seguida, você começará a receber notificações de eventos.

nota

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 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 Como usar o AWS Lambda com o Amazon RDS no Guia do desenvolvedor do AWS Lambda.

A seguinte seção lista todas as categorias e eventos sobre os quais você pode ser notificado. Ela também fornece informações sobre como assinar e trabalhar com assinaturas de eventos do Amazon RDS.

Categorias de eventos e mensagens de eventos do Amazon RDS

O Amazon RDS gera um número significativo de eventos em categorias nas quais você pode fazer uma assinatura usando o console do Amazon RDS, a AWS CLI ou a API. Cada categoria aplica-se a um tipo de origem, que pode ser uma instância de banco de dados, um snapshot de banco de dados, um security group de banco de dados ou um parameter group de banco de dados.

As tabelas a seguir mostram a categoria de evento e uma lista de eventos quando uma instância de banco de dados é o tipo de origem.

Categoria	ID do evento do Amazon RDS	Descrição
disponibilidade	RDS-EVENT-0006	A instância de banco de dados foi reiniciada.
disponibilidade	RDS-EVENT-0004	Desligamento da instância de banco de dados.
disponibilidade	RDS-EVENT-0022	Ocorreu um erro ao reiniciar o MySQL ou o MariaDB.
backup	RDS-EVENT-0001	Fazendo backup da instância de banco de dados.
backup	RDS-EVENT-0002	Backup da instância do banco de dados concluído.
alteração de configuração	RDS-EVENT-0009	A instância de banco de dados foi adicionada a um security group.
alteração de configuração	RDS-EVENT-0024	A instância de banco de dados está sendo convertida em uma instância de banco de dados Multi-AZ.
alteração de configuração	RDS-EVENT-0030	A instância do banco de dados está sendo convertida em uma instância de banco de dados Single-AZ.
alteração de configuração	RDS-EVENT-0012	Aplicando modificação à classe de instância de banco de dados.
alteração de configuração	RDS-EVENT-0018	As configurações de armazenamento atuais para essa instância de banco de dados estão sendo alteradas.
alteração de configuração	RDS-EVENT-0011	Um parameter group para esta instância de banco de dados foi alterado.
alteração de configuração	RDS-EVENT-0092	A atualização de um parameter group para esta instância de banco de dados foi concluída.
alteração de configuração	RDS-EVENT-0028	Os backups automáticos para esta instância de banco de dados foram desabilitados.
alteração de configuração	RDS-EVENT-0032	Os backups automáticos para esta instância de banco de dados foram habilitados.
alteração de configuração	RDS-EVENT-0033	Existem [contagem] usuários que correspondem ao nome do usuário mestre. Os usuários não vinculados a um host específico foram redefinidos.
alteração de configuração	RDS-EVENT-0025	A instância do banco de dados foi convertida em uma instância de banco de dados Multi-AZ.
alteração de configuração	RDS-EVENT-0029	A instância do banco de dados foi convertida em uma instância de banco de dados Single-AZ.
alteração de configuração	RDS-EVENT-0014	A classe de instância de banco de dados para essa instância de banco de dados foi alterada.
alteração de configuração	RDS-EVENT-0017	As configurações de armazenamento para essa instância de banco de dados mudaram.
alteração de configuração	RDS-EVENT-0010	A instância de banco de dados foi removida de um security group.
alteração de configuração	RDS-EVENT-0016	A senha principal da instância de banco de dados foi redefinida.
alteração de configuração	RDS-EVENT-0067	Uma tentativa de redefinir a senha mestre para a instância de banco de dados falhou.
alteração de configuração	RDS-EVENT-0078	A configuração de Monitoramento avançado foi alterada.
criação	RDS-EVENT-0005	Instância de banco de dados criada.
exclusão	RDS-EVENT-0003	A instância de banco de dados foi excluída.
failover	RDS-EVENT-0034	O Amazon RDS não está tentando um failover solicitado porque ocorreu um failover recentemente na instância de banco de dados.
failover	RDS-EVENT-0013	Um failover de Multi-AZ que resultou na promoção de uma instância em espera foi iniciado.
failover	RDS-EVENT-0015	Um failover de Multi-AZ que resultou na promoção de uma instância em espera está concluído. Pode levar vários minutos para o DNS ser transferido para a nova instância primária do banco de dados.
failover	RDS-EVENT-0065	A instância se recuperou de um failover parcial.
failover	RDS-EVENT-0049	Um failover de Multi-AZ foi concluído.
failover	RDS-EVENT-0050	Uma ativação Multi-AZ foi iniciada após uma recuperação bem-sucedida da instância.
failover	RDS-EVENT-0051	Uma ativação Multi-AZ está completa. Seu banco de dados deve estar acessível agora.
falha	RDS-EVENT-0031	Houve falha na instância de banco de dados devido a uma configuração incompatível ou a um problema do armazenamento subjacente. Inicie um point-in-time-restore para a instância de banco de dados.
falha	RDS-EVENT-0036	A instância de banco de dados está em uma rede incompatível. Alguns dos IDs de sub-rede especificados são inválidos ou não existem.
falha	RDS-EVENT-0035	A instância de banco de dados tem parâmetros inválidos. Por exemplo, se a instância de banco de dados não pôde ser iniciada porque um parâmetro relacionado à memória está definido como um valor muito alto para essa classe de instância, a ação do cliente seria modificar o parâmetro da memória e reinicializar a instância de banco de dados.
falha	RDS-EVENT-0058	Erro ao criar a conta de usuário do Statspack PERFSTAT. Descarte a conta antes de adicionar a opção Statspack.
falha	RDS-EVENT-0079	O Monitoramento avançado não pode ser habilitado sem a função do IAM de monitoramento avançado. Para obter informações sobre como criar a função do IAM de monitoramento avançado, consulte Como criar uma função do IAM para o monitoramento avançado do Amazon RDS.
falha	RDS-EVENT-0080	O Monitoramento avançado foi desabilitado devido a um erro na alteração da configuração. É provável que a função do IAM de monitoramento avançado esteja configurada incorretamente. Para obter informações sobre como criar a função do IAM de monitoramento avançado, consulte Como criar uma função do IAM para o monitoramento avançado do Amazon RDS.
falha	RDS-EVENT-0081	A função do IAM que você usa para acessar seu bucket do Amazon S3 para backup e restauração nativos do SQL Server está configurada incorretamente. Para obter mais informações, consulte Configurar o backup e a restauração nativos.
armazenamento baixo	RDS-EVENT-0089	A instância de banco de dados consumiu mais de 90% do armazenamento alocado. Você pode monitorar o espaço de armazenamento para uma instância de banco de dados usando a métrica Free Storage Space (Espaço de armazenamento livre). Para obter mais informações, consulte Exibir métricas de instância de banco de dados.
armazenamento baixo	RDS-EVENT-0007	O armazenamento alocado para a instância de banco de dados foi consumido. Para resolver esse problema, aloque armazenamento adicional para a instância de banco de dados. Para obter mais informações, consulte Perguntas frequentes do RDS. Você pode monitorar o espaço de armazenamento para uma instância de banco de dados usando a métrica Free Storage Space (Espaço de armazenamento livre). Para obter mais informações, consulte Exibir métricas de instância de banco de dados.
manutenção	RDS-EVENT-0026	Está ocorrendo a manutenção offline da instância de banco de dados. Atualmente, a instância do banco de dados está indisponível.
manutenção	RDS-EVENT-0027	A manutenção offline da instância de banco de dados está completa. A instância de banco de dados já está disponível.
manutenção	RDS-EVENT-0047	O patch da instância de banco de dados foi concluído.
manutenção	RDS-EVENT-0155	A instância de banco de dados tem uma atualização de versão secundária do mecanismo de banco de dados disponível.
notificação	RDS-EVENT-0044	Notificação emitida pelo operador. Para obter mais informações, consulte a mensagem do evento.
notificação	RDS-EVENT-0048	O patch da instância de banco de dados foi atrasado.
notificação	RDS-EVENT-0054	O mecanismo de armazenamento MySQL que você está usando não é o InnoDB, que é o mecanismo de armazenamento MySQL recomendado para o Amazon RDS. Para obter informações sobre os mecanismos de armazenamento do MySQL, consulte Mecanismos de armazenamento compatíveis para MySQL no Amazon RDS.
notificação	RDS-EVENT-0055	O número de tabelas existentes para a sua instância de banco de dados excede as melhores práticas recomendadas para o Amazon RDS. Reduza o número de tabelas na sua instância de banco de dados. Para obter informações sobre as melhores práticas recomendadas, consulte Diretrizes operacionais básicas do Amazon RDS.
notificação	RDS-EVENT-0056	O número de bancos de dados existentes para a sua instância de banco de dados excede as melhores práticas recomendadas para o Amazon RDS. Reduza o número de bancos de dados na sua instância de banco de dados. Para obter informações sobre as melhores práticas recomendadas, consulte Diretrizes operacionais básicas do Amazon RDS.
notificação	RDS-EVENT-0064	A chave TDE foi rotacionada. Para obter informações sobre as melhores práticas recomendadas, consulte Diretrizes operacionais básicas do Amazon RDS.
notificação	RDS-EVENT-0084	Você tentou converter uma instância de banco de dados para Multi-AZ, mas ela contém grupos de arquivos na memória que não têm suporte para Multi-AZ. Para obter mais informações, consulte Implantações Multi-AZ para Microsoft SQL Server.
notificação	RDS-EVENT-0087	A instância do banco de dados foi interrompida.
notificação	RDS-EVENT-0088	A instância do banco de dados foi iniciada.
notificação	RDS-EVENT-0154	A instância de banco de dados está sendo iniciada porque excede o tempo máximo permitido para permanecer parada.
notificação	RDS-EVENT-0157	O RDS não pode modificar a classe de instância de banco de dados porque a classe de instância de destino não oferece suporte ao número de bancos de dados existentes na instância de banco de dados de origem. A mensagem de erro é exibida como: "A instância possui N bancos de dados, mas, após a conversão, comportaria apenas N". Para obter mais informações, consulte Limites para instâncias de banco de dados do Microsoft SQL Server.
notificação	RDS-EVENT-0158	A instância de banco de dados está em um estado que não pode ser atualizado.
réplica de leitura	RDS-EVENT-0045	Ocorreu um erro no processo de replicação de leitura. Para obter mais informações, consulte a mensagem do evento. Além disso, consulte a seção de solução de problemas para réplicas de leitura para o mecanismo de banco de dados. Solução de problemas da réplica de leitura do MariaDB Solução de problemas de uma réplica de leitura do SQL Server Solucionar problemas de uma réplica de leitura do MySQL Solução de problemas de réplicas do Oracle Solucionar problemas da réplica de leitura do PostgreSQL
réplica de leitura	RDS-EVENT-0046	A réplica de leitura retomou a replicação. Essa mensagem aparece quando você cria uma réplica de leitura pela primeira vez, ou como uma mensagem de monitoramento confirmando que a replicação está funcionando corretamente. Se essa mensagem seguir uma notificação RDS-EVENT-0045, a replicação foi retomada após um erro ou após a replicação ter sido interrompida.
réplica de leitura	RDS-EVENT-0057	A replicação na réplica de leitura foi encerrada.
réplica de leitura	RDS-EVENT-0062	A replicação na réplica de leitura foi interrompida manualmente.
réplica de leitura	RDS-EVENT-0063	A replicação na réplica de leitura foi redefinida.
recuperação	RDS-EVENT-0020	A recuperação da instância de banco de dados começou. O tempo de recuperação variará dependendo da quantidade de dados a serem recuperados.
recuperação	RDS-EVENT-0021	A recuperação da instância de banco de dados está completa.
recuperação	RDS-EVENT-0023	Um backup manual foi solicitado, mas o Amazon RDS está no processo de criar um snapshot de banco de dados. Envie o pedido novamente depois que o Amazon RDS tiver concluído o snapshot de banco de dados.
recuperação	RDS-EVENT-0052	A recuperação da instância Multi-AZ começou. O tempo de recuperação variará dependendo da quantidade de dados a serem recuperados.
recuperação	RDS-EVENT-0053	A recuperação da instância Multi-AZ está completa.
recuperação	RDS-EVENT-0066	A instância de banco de dados do SQL Server está restabelecendo seu espelho. O desempenho será degradado até o espelho ser restabelecido. Um banco de dados foi encontrado com o modelo de recuperação não FULL. O modelo de recuperação foi alterado de volta para FULL, e a recuperação de espelhamento foi iniciada. (<dbname>: <modelo de recuperação encontrado>[,…])"
restauração	RDS-EVENT-0008	A instância de banco de dados foi restaurada a partir de um snapshot de banco de dados.
restauração	RDS-EVENT-0019	A instância de banco de dados foi restaurada a partir de um backup point-in-time.

A tabela a seguir mostra a categoria de evento e uma lista de eventos quando um parameter group de banco de dados é o tipo de origem.

Categoria	ID do evento do RDS	Descrição
alteração de configuração	RDS-EVENT-0037	O parameter group foi modificado.

A tabela a seguir mostra a categoria de evento e uma lista de eventos quando um security group de banco de dados é o tipo de origem.

Categoria	ID do evento do RDS	Descrição
alteração de configuração	RDS-EVENT-0038	O security group foi modificado.
falha	RDS-EVENT-0039	O grupo de segurança de propriedade de [usuário] não existe; a autorização do grupo de segurança foi revogada.

A tabela a seguir mostra a categoria de evento e uma lista de eventos quando um snapshot de banco de dados é o tipo de origem.

Categoria	ID do evento do RDS	Descrição
criação	RDS-EVENT-0040	Está sendo criado um snapshot de banco de dados manual.
criação	RDS-EVENT-0042	Foi criado um snapshot de banco de dados manual.
criação	RDS-EVENT-0090	Está sendo criado um snapshot de banco de dados automatizado.
criação	RDS-EVENT-0091	Foi criado um snapshot de banco de dados automatizado.
exclusão	RDS-EVENT-0041	Um snapshot de banco de dados foi excluído.
notificação	RDS-EVENT-0059	Iniciada a cópia do snapshot de banco de dados entre regiões [nome do snapshot de banco de dados] da região de origem [nome da região].
notificação	RDS-EVENT-0060	Finalizada a cópia do DB entre regiões [nome do snapshot de banco de dados] da região de origem [nome da região] em [tempo] minutos.
notificação	RDS-EVENT-0061	A cópia de um snapshot de banco de dados entre regiões.
notificação	RDS-EVENT-0159	Falha na tarefa de exportação do snapshot de banco de dados.
notificação	RDS-EVENT-0160	Tarefa de exportação de snapshot de banco de dados cancelada.
notificação	RDS-EVENT-0161	Tarefa de exportação de snapshot de banco de dados concluída.
restauração	RDS-EVENT-0043	Uma instância de banco de dados está sendo restaurada a partir de um snapshot de banco de dados.

A tabela a seguir mostra a categoria de evento e uma lista de eventos quando um cluster de banco de dados do Aurora é o tipo de origem.

Categoria	ID do evento do RDS	Descrição
failover	RDS-EVENT-0069	Um failover para o cluster de banco de dados falhou.
failover	RDS-EVENT-0070	Um failover para o cluster de banco de dados foi reiniciado.
failover	RDS-EVENT-0071	Um failover para o cluster de banco de dados foi concluído.
failover	RDS-EVENT-0072	Um failover para o cluster de banco de dados começou na mesma Zona de disponibilidade.
failover	RDS-EVENT-0073	Um failover para o cluster de banco de dados começou entre Zonas de disponibilidade.
falha	RDS-EVENT-0083	O Aurora não pôde copiar dados de backup de um bucket do Amazon S3. É provável que as permissões para o Aurora acessar o bucket do Amazon S3 estejam configuradas incorretamente. Para obter mais informações, consulte Migrar dados de um banco de dados MySQL externo para um cluster de banco de dados MySQL do Amazon Aurora.
falha	RDS-EVENT-0143	Falha no dimensionamento para o cluster de banco de dados do Aurora Serverless.
manutenção	RDS-EVENT-0156	O cluster de banco de dados tem uma atualização de versão secundária do mecanismo de banco de dados disponível.
notificação	RDS-EVENT-0076	Falha na migração para um cluster de banco de dados do Aurora.
notificação	RDS-EVENT-0077	Uma tentativa de converter uma tabela do banco de dados de origem para o InnoDB falhou durante a migração para um cluster de banco de dados do Aurora.
notificação	RDS-EVENT-0141	Escalonamento iniciado para o cluster de banco de dados do Aurora Serverless.
notificação	RDS-EVENT-0142	Escalonamento concluído para o cluster de banco de dados do Aurora Serverless.
notificação	RDS-EVENT-0144	Pausa automática iniciada para o cluster de banco de dados do Aurora Serverless.
notificação	RDS-EVENT-0145	O cluster de banco de dados do Aurora Serverless foi pausado.
notificação	RDS-EVENT-0146	Pausa cancelada para o cluster de banco de dados do Aurora Serverless.
notificação	RDS-EVENT-0147	Retomada iniciada para o cluster de banco de dados do Aurora Serverless.
notificação	RDS-EVENT-0148	Retomada concluída para o cluster de banco de dados do Aurora Serverless.
notificação	RDS-EVENT-0149	Escalabilidade transparente concluída com a opção forçada para o cluster de banco de dados do Aurora Serverless. Conexões podem ser interrompidas conforme necessário.
notificação	RDS-EVENT-0150	O cluster de banco de dados parou.
notificação	RDS-EVENT-0151	O cluster de banco de dados iniciou.
notificação	RDS-EVENT-0152	Falha na parada do cluster de banco de dados.
notificação	RDS-EVENT-0153	O cluster de banco de dados está sendo iniciado porque excede o tempo máximo permitido para permanecer parado.
notificação	RDS-EVENT-0173	A aplicação de patches do cluster de banco de dados foi concluída.

A tabela a seguir mostra a categoria de evento e uma lista de eventos quando um snapshot de cluster de banco de dados do Aurora é o tipo de origem.

Categoria	ID do evento do RDS	Descrição
backup	RDS-EVENT-0074	Foi iniciada a criação de um snapshot de cluster de banco de dados manual.
backup	RDS-EVENT-0075	Foi criado um snapshot de cluster de banco de dados manual.
notificação	RDS-EVENT-0162	Falha na tarefa de exportação do snapshot do cluster de banco de dados.
notificação	RDS-EVENT-0163	Tarefa de exportação de snapshot de cluster de banco de dados cancelada.
notificação	RDS-EVENT-0164	Tarefa de exportação de snapshot de cluster de banco de dados concluída.
backup	RDS-EVENT-0168	Criando snapshot de cluster automatizado.
backup	RDS-EVENT-0169	Snapshot de cluster automatizado criado.
criação	RDS-EVENT-0170	Cluster de banco de dados criado.
exclusão	RDS-EVENT-0171	Cluster de banco de dados excluído.
notificação	RDS-EVENT-0172	Cluster de banco de dados renomeado de [nome antigo do cluster de banco de dados] para [novo nome do cluster de banco de dados].

Inscrever-se em notificações de eventos do Amazon RDS

Você pode criar uma assinatura de notificação de evento do Amazon RDS para que possa ser notificado quando um evento ocorrer para determinada instância de banco de dados, snapshot de banco de dados, security group de banco de dados ou parameter group de banco de dados. 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 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. Estes são definidos pelo SourceType (tipo de fonte) e o SourceIdentifier (a fonte do Amazon RDS gerando o evento). Se especificar SourceType e SourceIdentifier, como, por exemplo, SourceType = db-instance e SourceIdentifier = myDBInstance1, você receberá todos os eventos da instância de banco de dados da origem especificada. Se especificar um SourceType, mas não especificar um SourceIdentifier, você receberá um aviso dos eventos desse tipo de origem para todas as origens do Amazon RDS. Se não especificar o SourceType nem o SourceIdentifier, você receberá notificações de eventos gerados de todas as origens do Amazon RDS pertencentes à conta do cliente.

nota

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

A notificação de eventos do Amazon RDS está disponível apenas para tópicos do SNS não criptografados. Se você especificar um tópico criptografado do SNS, notificações de eventos não serão enviadas para o tópico.

Console

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/.

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

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

4. Na caixa de diálogo Create event subscription (Criar assinatura de evento) faça o seguinte:

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

   2. Em Send notifications to (Enviar notificações para), escolha um ARN do Amazon SNS existente para um tópico do Amazon SNS ou escolha create topic (criar tópico) para digitar o nome de um tópico e uma lista de destinatários.

   3. Em Source type (Tipo de origem), escolha um tipo de origem.

   4. Escolha Yes (Sim) para habilitar a assinatura. Se você quiser criar a assinatura, mas não tiver notificações enviadas, escolha No (Não).

   5. Dependendo do tipo de origem que você selecionou, escolha as categorias e origens de eventos para as quais quer receber notificações de eventos.

   6. Escolha Criar.

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

AWS CLI

Para assinar a Notificação de eventos do RDS, use o comando create-event-subscription da AWS CLI. Inclua os seguintes parâmetros necessários:

• --subscription-name

• --sns-topic-arn

exemplo

Para Linux, macOS ou Unix:

aws rds create-event-subscription \
    --subscription-name myeventsubscription \
    --sns-topic-arn arn:aws:sns:us-east-1:802#########:myawsuser-RDS \
    --enabled

Para Windows:

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

API

Para assinar a notificação de eventos do Amazon RDS, chame a função da API CreateEventSubscription do Amazon RDS. Inclua os seguintes parâmetros necessários:

• SubscriptionName

• SnsTopicArn

Listar assinaturas de notificação de evento do Amazon RDS

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

Console

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/.

2. 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.

   

AWS CLI

Para listar suas atuais assinaturas de notificações de eventos do Amazon RDS, use o comando describe-event-subscriptions da AWS CLI.

exemplo

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

Para listar suas atuais assinaturas de notificações de eventos do Amazon RDS, chame a ação da API DescribeEventSubscriptions do Amazon RDS.

exemplo

O exemplo de código a seguir lista até 100 assinaturas de eventos.

https://rds.us-east-1.amazonaws.com/
   ?Action=DescribeEventSubscriptions
   &MaxRecords=100
   &SignatureMethod=HmacSHA256
   &SignatureVersion=4
   &Version=2014-10-31
   &X-Amz-Algorithm=AWS4-HMAC-SHA256
   &X-Amz-Credential=AKIADQKE4SARGYLE/20140428/us-east-1/rds/aws4_request
   &X-Amz-Date=20140428T161907Z
   &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date
   &X-Amz-Signature=4208679fe967783a1a149c826199080a066085d5a88227a80c6c0cadb3e8c0d4

O exemplo a seguir descreve a pilha myfirsteventsubscription.

https://rds.us-east-1.amazonaws.com/
   ?Action=DescribeEventSubscriptions
   &SignatureMethod=HmacSHA256
   &SignatureVersion=4
   &SubscriptionName=myfirsteventsubscription
   &Version=2014-10-31
   &X-Amz-Algorithm=AWS4-HMAC-SHA256
   &X-Amz-Credential=AKIADQKE4SARGYLE/20140428/us-east-1/rds/aws4_request
   &X-Amz-Date=20140428T161907Z
   &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date
   &X-Amz-Signature=4208679fe967783a1a149c826199080a066085d5a88227a80c6c0cadb3e8c0d4

Modificar uma assinatura de notificação de evento do Amazon RDS

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

Console

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/.

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

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

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

5. Selecione Edit. O console do Amazon RDS indica que a assinatura está sendo modificada.

   

AWS CLI

Para modificar uma assinatura de notificação de evento do Amazon RDS, use o comando modify-event-subscription da AWS CLI. Inclua o seguinte parâmetro necessário:

• --subscription-name

exemplo

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

Para modificar um evento do Amazon RDS, chame a operação ModifyEventSubscription da API do Amazon RDS. Inclua o seguinte parâmetro necessário:

• SubscriptionName

Adicionar um identificador de origem a uma assinatura de notificação de evento do Amazon RDS

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

Console

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.

AWS CLI

Para adicionar um identificador de origem a uma assinatura de notificação de eventos do Amazon RDS, use o comando add-source-identifier-to-subscription da AWS CLI. Inclua os seguintes parâmetros necessários:

• --subscription-name

• --source-identifier

exemplo

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

API

Para adicionar um identificador de origem a uma assinatura de notificação de evento do Amazon RDS, chame a API AddSourceIdentifierToSubscription do Amazon RDS. 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

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

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.

AWS CLI

Para remover um identificador de origem de uma assinatura de notificação de eventos do Amazon RDS, use o comando remove-source-identifier-from-subscription da AWS CLI. Inclua os seguintes parâmetros necessários:

• --subscription-name

• --source-identifier

exemplo

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

API

Para remover um identificador de origem de uma assinatura de notificação de eventos do Amazon RDS, use o comando RemoveSourceIdentifierFromSubscription 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

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

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.

AWS CLI

Para listar as categorias de notificação de evento do Amazon RDS, use o comando describe-event-categories da AWS CLI. Esse comando não possui parâmetros necessários.

exemplo

aws rds describe-event-categories

API

Para listar as categorias de notificação de evento do Amazon RDS, use o comando DescribeEventCategories 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

Você pode 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

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/.

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

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

4. Escolha Delete.

5. O console do Amazon RDS indica que a assinatura está sendo excluída.

   

AWS CLI

Para excluir uma assinatura de notificação de evento do Amazon RDS, use o comando delete-event-subscription da AWS CLI. Inclua o seguinte parâmetro necessário:

• --subscription-name

exemplo

O exemplo a seguir exclui a assinatura myrdssubscription.

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

API

Para excluir uma assinatura de notificação de evento do Amazon RDS, use o comando DeleteEventSubscription da API do RDS. Inclua o seguinte parâmetro necessário:

• SubscriptionName