# Visão geral das notificações de eventos do Amazon RDS
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
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
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
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
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
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
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
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
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"
}
}
```