# Eventos de alteração de estado para instâncias do Amazon EC2
<a name="monitoring-instance-state-changes"></a>

O Amazon EC2 envia um evento `EC2 Instance State-change Notification` ao Amazon EventBridge quando o estado de uma instância é alterado.

A seguir estão dados de exemplo para esse evento. Neste exemplo, a instância inseriu o estado `pending`.

```
{
   "id":"7bf73129-1428-4cd3-a780-95db273d1602",
   "detail-type":"EC2 Instance State-change Notification",
   "source":"aws.ec2",
   "account":"123456789012",
   "time":"2021-11-11T21:29:54Z",
   "region":"us-east-1",
   "resources":[
      "arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0"
   ],
   "detail":{
      "instance-id":"i-1234567890abcdef0",
      "state":"pending"
   }
}
```

Os possíveis valores para `state` são:
+ `pending`
+ `running`
+ `stopping`
+ `stopped`
+ `shutting-down`
+ `terminated`

Quando você executa ou inicia uma instância, ela entra no estado `pending` e depois no estado `running`. Quando você interrompe uma instância, ela entra no estado `stopping` e depois no estado `stopped`. Quando você termina uma instância, ela entra no estado `shutting-down` e depois no estado `terminated`. Para obter mais informações, consulte [Alterações do estado de instâncias do Amazon EC2](ec2-instance-lifecycle.md).

# Criar um alarme que envie um e-mail quando uma instância do Amazon EC2 muda de estado
<a name="ec2-events-eventbridge-example"></a>

Para receber notificações por e-mail quando o estado de sua instância for alterado, crie um tópico do Amazon SNS e crie uma regra do EventBridge para o evento `EC2 Instance State-change Notification`.

**Para criar um tópico do SNS**

1. Abra o console do Amazon SNS em [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home).

1. No painel de navegação, escolha **Tópicos**.

1. Escolha **Criar tópico**.

1. Em **Tipo**, escolha **Padrão**.

1. Em **Name** (Nome), digite um nome para o tópico.

1. Escolha **Criar tópico**.

1. Selecione **Criar assinatura**.

1. Em **Protocolo**, escolha **E-mail**.

1. Em **Endpoint**, insira o endereço de e-mail que receberá as notificações.

1. Selecione **Criar assinatura**.

1. Você receberá uma mensagem de e-mail com esta linha de assunto: AWS Notification - Subscription Confirmation. Siga as instruções para confirmar sua assinatura.

**Para criar uma regra de EventBridge**

1. Abra o console do Amazon EventBridge em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Selecione **Criar regra**.

1. Em **Name** (Nome), insira um nome para a regra.

1. Em **Rule type**, escolha **Rule with an event pattern**.

1. Escolha **Próximo**.

1. Em **Event pattern** (Padrão de evento), faça o seguinte:

   1. Para **Origem do evento**, escolha **Serviços da AWS**.

   1. Em **AWS service (Serviço da AWS)**, escolha **EC2**.

   1. Para **Event Type (Tipo de evento)**, escolha **EC2 Instance State-change Notification (Notificação de alteração de estado da instância do EC2)**.

   1. Por padrão, enviamos notificações para qualquer alteração de estado de qualquer instância. Se você preferir, é possível selecionar estados específicos ou instâncias específicas.

1. Escolha **Próximo**.

1. Especifique um destino desta forma:

   1. Em **Target types** (Tipos de destino), escolha **AWS service (Serviço da AWS)**.

   1. Em **Select a target** (Selecionar um destino), escolha **SNS topic** (Tópico do SNS).

   1. Em **Topic** (Tópico), selecione o tópico do SNS que você criou no procedimento anterior.

1. Escolha **Próximo**.

1. (Opcional) Adicione etiquetas à regra.

1. Escolha **Próximo**.

1. Selecione **Criar regra**.

1. Para testar a regra, inicie uma alteração de estado. Por exemplo, inicie uma instância interrompida, interrompa uma instância em execução ou inicie uma instância. Você receberá mensagens de e-mail com esta linha de assunto: AWS Notification Message. O corpo do e-mail contém os dados do evento.