# Personalizar notificações de eventos programados para suas instâncias do EC2
<a name="customizing_scheduled_event_notifications"></a>

É possível personalizar notificações de eventos programados para incluir tags na notificação por e-mail. Isso facilita a identificação do recurso afetado (instâncias ou Hosts dedicados) e priorizar ações para o próximo evento.

Ao personalizar notificações de eventos para incluir tags, é possível optar por incluir:
+ Todas as tags associadas ao recurso afetado
+ Somente tags específicas que estão associadas ao recurso afetado

Por exemplo, suponha que você atribua as tags `application`, `costcenter`, `project` e `owner` a todas as suas instâncias. É possível optar por incluir todas as tags nas notificações de eventos. Como alternativa, se você quiser ver apenas as tags `owner` e `project` nas notificações de eventos, poderá optar por incluir apenas essas tags.

Depois de selecionar as tags a serem incluídas, as notificações de evento incluirão o ID do recurso (ID da instância ou ID do Host dedicado) e os pares de chave de tag e valor associados ao recurso afetado.

**Topics**
+ [Incluir tags em notificações de eventos](#register-tags)
+ [Remover tags de notificações de eventos](#deregister-tags)
+ [Visualizar as tags a serem incluídas nas notificações de eventos](#view-tags)

## Incluir tags em notificações de eventos
<a name="register-tags"></a>

As tags que você escolher incluir se aplicarão a todos os recursos (instâncias e Hosts dedicados) na região selecionada. Para personalizar notificações de eventos em outras regiões, primeiro selecione a região necessária e execute as etapas a seguir.

------
#### [ Console ]

**Como incluir tags em notificações de eventos**

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

1. No painel de navegação, selecione **Events**.

1. Escolha **Actions (Ações)**, **Manage event notifications (Gerenciar notificações de eventos)**.

1. Ative a opção **Incluir tags em notificações de eventos**.

1. Siga um destes procedimentos, dependendo das tags que você deseja incluir nas notificações de eventos:
   + Para incluir todas as tags associadas à instância afetada ou ao Host dedicado, selecione **Incluir todas as tags**.
   + Para selecionar as tags a serem incluídas, selecione **Escolher as tags a serem incluídas** e, em seguida, selecione ou insira as chaves de tag.

1. Escolha **Salvar**.

------
#### [ AWS CLI ]

**Como incluir todas as tags em notificações de eventos**  
Use o comando [register-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/register-instance-event-notification-attributes.html) e defina o parâmetro `IncludeAllTagsOfInstance` como `true`.

```
aws ec2 register-instance-event-notification-attributes \
    --instance-tag-attribute "IncludeAllTagsOfInstance=true"
```

**Como incluir tags específicas em notificações de eventos**  
Use o comando [register-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/register-instance-event-notification-attributes.html) e especifique as tags a serem incluídas usando o parâmetro `InstanceTagKeys`.

```
aws ec2 register-instance-event-notification-attributes \
    --instance-tag-attribute 'InstanceTagKeys=["{{tag_key_1}}", "{{tag_key_2}}", "{{tag_key_3}}"]'
```

------
#### [ PowerShell ]

**Como incluir todas as tags em notificações de eventos**  
Use o cmdlet [Register-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventNotificationAttribute.html).

```
Register-EC2InstanceEventNotificationAttribute `
    -InstanceTagAttribute_IncludeAllTagsOfInstance $true
```

**Como incluir tags específicas em notificações de eventos**  
Use o cmdlet [Register-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventNotificationAttribute.html).

```
Register-EC2InstanceEventNotificationAttribute `
    -InstanceTagAttribute_InstanceTagKey {{tag_key_1}}, {{tag_key_2}}, {{tag_key_3}}
```

------

## Remover tags de notificações de eventos
<a name="deregister-tags"></a>

É possível remover tags das notificações de eventos.

------
#### [ Console ]

**Como remover tags de notificações de eventos**

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

1. No painel de navegação, selecione **Events**.

1. Escolha **Actions (Ações)**, **Manage event notifications (Gerenciar notificações de eventos)**.

1. Para remover todas as tags das notificações de eventos, desmarque **Incluir tags nas notificações de eventos**.

1. Para remover tags específicas das notificações de eventos, escolha o **X** para as chaves de tag correspondentes.

1. Escolha **Salvar**.

------
#### [ AWS CLI ]

**Como remover todas as tags das notificações de eventos**  
Use o comando [deregister-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/deregister-instance-event-notification-attributes.html) e defina o parâmetro `IncludeAllTagsOfInstance` como `false`.

```
aws ec2 deregister-instance-event-notification-attributes \
    --instance-tag-attribute "IncludeAllTagsOfInstance=false"
```

**Para remover uma tag de notificações de eventos**  
Use o comando [deregister-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/deregister-instance-event-notification-attributes.html) e especifique as tags a serem removidas usando o parâmetro `InstanceTagKeys`.

```
aws ec2 deregister-instance-event-notification-attributes \
    --instance-tag-attribute 'InstanceTagKeys=["{{tag_key_3}}"]'
```

------
#### [ PowerShell ]

**Como remover todas as tags das notificações de eventos**  
Use o cmdlet [Unregister-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventNotificationAttribute.html).

```
Unregister-EC2InstanceEventNotificationAttribute `
    -InstanceTagAttribute_IncludeAllTagsOfInstance $false
```

**Para remover uma tag de notificações de eventos**  
Use o cmdlet [Unregister-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventNotificationAttribute.html).

```
Unregister-EC2InstanceEventNotificationAttribute `
    -InstanceTagAttribute_InstanceTagKey {{tag_key_3}}
```

------

## Visualizar as tags a serem incluídas nas notificações de eventos
<a name="view-tags"></a>

É possível visualizar as tags que serão incluídas nas notificações de eventos.

------
#### [ Console ]

**Como visualizar as tags a serem incluídas nas notificações de eventos**

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

1. No painel de navegação, selecione **Events**.

1. Escolha **Actions (Ações)**, **Manage event notifications (Gerenciar notificações de eventos)**.

------
#### [ AWS CLI ]

**Para visualizar as tags que serão incluídas nas notificações de eventos**  
Use o comando [describe-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-event-notification-attributes.html).

```
aws ec2 describe-instance-event-notification-attributes
```

------
#### [ PowerShell ]

**Para visualizar as tags que serão incluídas nas notificações de eventos**  
Use o cmdlet [Get-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceEventNotificationAttribute.html).

```
Get-EC2InstanceEventNotificationAttribute
```

------