# Eventos programados para instâncias do Amazon EC2
Para garantir a confiabilidade e o desempenho da infraestrutura, o AWS pode programar eventos para reinicializar, interromper e retirar suas instâncias. Esses eventos não ocorrem com frequência.
Se uma de suas instâncias for afetada por um evento programado, o AWS notificará você com antecedência por e-mail usando o endereço de e-mail associado à sua conta AWS. O e-mail fornece detalhes sobre o evento, como as datas de início e término. Dependendo do tipo de evento, é possível tomar providências para controlar sua duração. A AWS também envia um evento do AWS Health, que é possível monitorar e gerenciar usando o Amazon EventBridge. Para obter mais informações, consulte [Monitoramento de eventos no AWS Health com o Amazon EventBridge](https://docs.aws.amazon.com/health/latest/ug/cloudwatch-events-health.html).
Eventos programados são gerenciados por AWS. Não é possível agendar eventos para suas instâncias. No entanto, você pode:
+ Visualizar eventos programados para suas instâncias.
+ Personalize as notificações de eventos programados para incluir ou remover etiquetas da notificação por e-mail.
+ Reagendar determinados eventos programados.
+ Criar janelas de eventos personalizadas para eventos programados.
+ Tomar medidas quando uma instância estiver programada para reinicializar, interromper ou ser retirada.
Para garantir que você receba notificações de eventos programados, verifique suas informações de contato na página [Conta](https://console.aws.amazon.com/billing/home?#/account).
**nota**
Quando uma instância for afetada por um evento agendado e fizer parte de um grupo do Auto Scaling, o Amazon EC2 Auto Scaling futuramente a substituirá como parte de suas verificações de integridade, e você não precisará realizar nenhuma outra ação. Para obter mais informações sobre as verificações de integridade realizadas pelo Amazon EC2 Auto Scaling, consulte [Health checks for instances in an Auto Scaling group](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-health-checks.html) no *Guia do usuário do Amazon EC2 Auto Scaling*.
## Tipos de eventos programados
O Amazon EC2 pode criar os seguintes tipos de eventos programados para suas instâncias, onde o evento ocorre em um horário programado:
| Tipo de evento | Código do evento | Ação de evento |
| --- | --- | --- |
| Interrupção da instância | instance-stop | Na hora programada, a instância é interrompida. Quando você iniciá-la novamente, ela será migrada para um novo host. Aplicável somente a instâncias com um volume raiz do Amazon EBS. |
| Desativação da instância | instance-retirement | Na hora programada, a instância é interrompida se tiver um volume raiz do Amazon EBS ou encerrada se tiver um volume raiz do armazenamento de instância. |
| Reinicialização da instância | instance-reboot | Na hora programada, a instância é reinicializada. A instância permanece no host e, durante a reinicialização, o host passa por uma manutenção. Isso é conhecido como reinicialização no local. |
| Reinicialização do sistema | system-reboot | Na hora programada, a instância é reinicializada e migrada para um novo host. Isso é conhecido como migração com reinicialização. |
| Manutenção do sistema | system-maintenance | Na hora programada, a instância pode ser temporariamente afetada pela manutenção de rede ou pela manutenção de energia. |
## Determinar o tipo de evento
É possível verificar que tipo de evento está programado para a sua instância.
------
#### [ Console ]
**Para determinar o tipo de evento**
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. Na tabela, o código de evento aparece na coluna **Tipo de evento**.
1. Para filtrar a tabela de forma a mostrar somente os eventos de instâncias, no campo de pesquisa, escolha **Tipo de recurso: instância** na lista de filtros.
------
#### [ AWS CLI ]
**Para determinar o tipo de evento para uma instância**
Use o comando [describe-instance-status](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-status.html). Se a instância tiver um evento programado associado, a saída fornecerá informações sobre ele.
```
aws ec2 describe-instance-status \
--instance-id i-1234567890abcdef0 \
--query InstanceStatuses[].Events
```
O seguinte é um exemplo de saída. O código do evento programado é `system-reboot`.
```
[
"Events": [
{
"InstanceEventId": "instance-event-0d59937288b749b32",
"Code": "system-reboot",
"Description": "The instance is scheduled for a reboot",
"NotAfter": "2020-03-14T22:00:00.000Z",
"NotBefore": "2020-03-14T20:00:00.000Z",
"NotBeforeDeadline": "2020-04-05T11:00:00.000Z"
}
]
]
```
------
#### [ PowerShell ]
**Para determinar o tipo de evento para uma instância**
Use o cmdlet [Get-EC2InstanceStatus](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceStatus.html). Se a instância tiver um evento programado associado, a saída fornecerá informações sobre ele.
```
(Get-EC2InstanceStatus `
-InstanceId i-1234567890abcdef0).Events
```
O seguinte é um exemplo de saída. O código do evento programado é `system-reboot`.
```
Code : system-reboot
Description : The instance is scheduled for a reboot
InstanceEventId : instance-event-0d59937288b749b32
NotAfter : 2020-03-14T22:00:00.000Z
NotBefore : 2020-03-14T20:00:00.000Z
NotBeforeDeadline : 2020-04-05T11:00:00.000Z
```
------
**Topics**
+ [Tipos de eventos programados](#types-of-scheduled-events)
+ [Determinar o tipo de evento](#scheduled-event-type)
+ [Gerenciamento das instâncias do Amazon EC2 agendadas para interrupção ou desativação](schedevents_actions_retire.md)
+ [Gerenciamento das instâncias do Amazon EC2 agendadas para reinicialização](schedevents_actions_reboot.md)
+ [Gerenciamento das instâncias do Amazon EC2 agendadas para manutenção](schedevents_actions_maintenance.md)
+ [Visualizar eventos programados que afetam as instâncias do Amazon EC2](viewing_scheduled_events.md)
+ [Personalizar notificações de eventos programados para suas instâncias do EC2](customizing_scheduled_event_notifications.md)
+ [Reagendar um evento programado para uma instância do EC2](reschedule-event.md)
+ [Criar janelas de eventos personalizadas para eventos programados que afetam as instâncias do Amazon EC2](event-windows.md)
# Gerenciamento das instâncias do Amazon EC2 agendadas para interrupção ou desativação
Quando a AWS detecta falha irreparável do host subjacente para sua instância, ela programa a instância para ser interrompida ou encerrada, dependendo do tipo de dispositivo raiz da instância.
+ Se a instância tiver um volume raiz do Amazon EBS, a instância será programada para parar.
+ Se a instância tiver um volume raiz de armazenamento de instância, ela será programada para ser encerrada.
Para obter mais informações, consulte [Desativação da instância](instance-retirement.md).
**Importante**
Todos os dados armazenados nos volumes de armazenamento de instâncias serão perdidos quando a instância for interrompida, hibernada ou encerrada. Isso inclui volumes de armazenamento de instância que estão anexados a uma instância com volume raiz do EBS. Lembre-se de salvar os dados dos volumes do armazenamento de instâncias que poderão ser necessários mais tarde antes que a instância seja interrompida, hibernada ou encerrada.
## Ações que você pode realizar
**Ações que podem ser realizadas em instâncias com um volume raiz do EBS**
Ao receber uma notificação de evento `instance-stop` programada, você pode realizar uma destas seguintes:
+ **Aguardar a interrupção programada:** você pode esperar que a instância seja interrompida dentro da janela de manutenção programada.
+ **Executar a interrupção e inicialização manuais:** você pode interromper e iniciar a instância por conta própria no momento que mais lhe convier, o que a migrará para um novo host. Isso não equivale a reiniciar a instância. Para obter mais informações, consulte [Início e interrupção de instâncias do Amazon EC2](Stop_Start.md).
+ **Automatizar a interrupção e o início:** você pode automatizar uma interrupção e um início imediatos em resposta a um evento `instance-stop` programado. Para obter mais informações, consulte [Como executar automaticamente operações em instâncias do EC2 em resposta a eventos no AWS Health](https://docs.aws.amazon.com/health/latest/ug/automating-instance-actions.html) no *Guia do usuário do AWS Health*.
**Ações que você pode realizar para instâncias com um volume raiz do armazenamento de instâncias**
Quando você recebe uma notificação de evento `system-retirement` programado e deseja manter seus dados, pode executar as seguintes ações:
1. Lance uma instância de substituição a partir da sua AMI mais recente.
1. Migrar todos os dados necessários para a instância de substituição antes que a instância seja programada para encerramento.
1. Encerrar a instância original ou esperar que ela seja encerrada conforme programado.
Para obter mais informações sobre as ações que você pode realizar, consulte [Desativação da instância](instance-retirement.md).
# Gerenciamento das instâncias do Amazon EC2 agendadas para reinicialização
Quando a AWS precisar executar tarefas, como a instalação de atualizações ou a manutenção do host subjacente, ela pode programar uma reinicialização da instância. Durante essa reinicialização programada, a instância permanece no mesmo host ou migra para um diferente, dependendo do evento, da seguinte maneira:
+ `instance-reboot`Evento
+ Durante a reinicialização, a instância permanece no host. Isso é conhecido como *reinicialização no local*.
+ O host atual está passando por manutenção.
+ Normalmente, isso é concluído em segundos.
+ `system-reboot`Evento
+ Durante a reinicialização, a instância é migrada para um novo host. Isso é conhecido como *migração com reinicialização*.
+ Normalmente, isso é concluído em minutos.
Para verificar que tipo de evento está programado para a sua instância, consulte [Determinar o tipo de evento](monitoring-instances-status-check_sched.md#scheduled-event-type).
## Ações que você pode realizar
Ao receber uma notificação de evento `instance-reboot` ou `system-reboot` programado, você pode realizar uma destas ações:
+ **Aguardar a reinicialização programada**: você pode esperar que a reinicialização da instância ocorra dentro da janela de manutenção programada.
+ **Reprogramar a reinicialização:** você pode [reprogramar](reschedule-event.md) a reinicialização da instância para uma data e um horário que forem mais convenientes para você.
+ **Executar uma reinicialização iniciada pelo usuário:** é possível [reinicializar](ec2-instance-reboot.md) manualmente a instância em um momento conveniente para você. No entanto, o resultado depende do evento:
+ Evento `instance-reboot`: sua instância permanece no hardware atual (reinicialização no local), nenhuma manutenção do host ocorre e o evento permanece aberto.
+ `system-reboot`Evento
+ Se a migração com reinicialização estiver habilitada em sua instância, uma reinicialização iniciada pelo usuário tentará migrar sua instância para um novo hardware. Em caso de êxito, o evento será removido. Caso contrário, uma reinicialização local ocorrerá e o evento permanecerá na programação.
+ Se a migração com reinicialização estiver desabilitada em sua instância, uma reinicialização iniciada pelo usuário manterá a instância no mesmo hardware (reinicialização local), nenhuma manutenção do host ocorrerá e o evento permanecerá na programação. Quando o evento programado finalmente ocorrer, a AWS moverá sua instância para um novo hardware (migração com reinicialização).
**Depois que a AWS reinicializar sua instância**
O seguinte é aplicável depois que a AWS reinicializa sua instância:
+ O evento programado é removido.
+ A descrição do evento é atualizada.
+ Para um evento `instance-reboot`:
+ A manutenção do host subjacente está concluída.
+ Para um evento `system-reboot`:
+ A instância é movida para um novo host.
+ A instância mantém seu endereço IP e nome DNS.
+ Todos os dados em volumes de armazenamento de instância local são preservados.
+ Você pode usar sua instância depois que ela é totalmente inicializada.
**Opções alternativas**
Se não conseguir reprogramar o evento de reinicialização ou habilitar a migração com reinicialização para uma reinicialização iniciada pelo usuário, mas quiser manter a operação normal durante a janela de manutenção programada, você poderá fazer o seguinte:
+ **Para uma instância com um volume raiz do EBS**
+ Você pode interromper e iniciar a instância, o que a migra para um novo host. Isso não é o mesmo que reinicializar manualmente a instância, caso em que ela permanece no mesmo host.
+ Opcionalmente, automatize a parada e o início imediatos da instância em resposta ao evento de reinicialização programado. Para obter mais informações, consulte [Como executar automaticamente operações em instâncias do EC2 em resposta a eventos no AWS Health](https://docs.aws.amazon.com/health/latest/ug/automating-instance-actions.html) no *Guia do usuário do AWS Health*.
**Importante**
Os dados nos volumes de armazenamento da instância são perdidos quando uma instância é interrompida. Para obter mais informações, consulte [Início e interrupção de instâncias do Amazon EC2](Stop_Start.md).
+ **Para uma instância com um volume raiz de armazenamento de instância**
1. Lance uma instância de substituição a partir da sua AMI mais recente.
1. Migre todos os dados necessários para a instância substituta antes da janela de manutenção programada.
1. Encerre a instância original.
## Habilitar ou desabilitar a migração com reinicialização
Quando uma instância está programada para um evento `system-reboot`, é possível reiniciá-la antes do evento. O resultado de uma reinicialização iniciada pelo usuário depende da configuração da migração com reinicialização da instância:
+ Habilitada: uma reinicialização iniciada pelo usuário tenta migrar sua instância para um novo hardware (migração com reinicialização). Em caso de êxito, o evento será removido. Caso contrário, uma reinicialização local ocorrerá e o evento permanecerá na programação. Observe que, mesmo quando ativada, a migração com reinicialização só poderá ocorrer se sua instância atender aos requisitos de [migração com reinicialização](#requirements-for-reboot-migration).
+ Desabilitada: uma reinicialização iniciada pelo usuário mantém a instância no mesmo hardware (reinicialização local), nenhuma manutenção do host ocorre e o evento permanece na programação. Quando o evento programado finalmente ocorrer, a AWS moverá sua instância para um novo hardware (migração com reinicialização).
A reinicialização com migração demora mais do que uma reinicialização local:
+ Reinicialização local: aproximadamente 30 segundos
+ Reinicialização com migração: vários minutos
**nota**
Por padrão, as instâncias que recebem uma notificação de evento `system-reboot` são habilitadas para migração com reinicialização iniciada pelo usuário.
### Requisitos para habilitar a migração com reinicialização
A migração com reinicialização pode ser habilitada em instâncias que atendem aos seguintes critérios:
**Tipos de instância**
Nem todos os tipos de instância oferecem suporte à habilitação da migração com reinicialização. É possível visualizar os tipos de instância que oferecem suporte à habilitação da migração com reinicialização.
**Para visualizar os tipos de instância que oferecem suporte à habilitação da migração com reinicialização**
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 à esquerda, escolha **Instances** (Instâncias).
1. Na barra de filtros, insira **Suporte à migração com reinicialização: com suporte**. À medida que você insere os caracteres e o nome do filtro aparece, é possível selecioná-lo.
A tabela **Tipos de instâncias** exibe todos os tipos de instância que oferecem suporte à habilitação da migração com reinicialização.
**Para visualizar os tipos de instância que oferecem suporte à habilitação da migração com reinicialização**
Use o comando [describe-instance-types](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-types.html) com o filtro `reboot-migration-support`.
```
aws ec2 describe-instance-types \
--filters Name=reboot-migration-support,Values=supported \
--query "InstanceTypes[*].[InstanceType]" \
--output text | sort
```
**Para visualizar os tipos de instância que oferecem suporte à habilitação da migração com reinicialização**
Use o cmdlet [Get-EC2InstanceType](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceType.html) com o filtro `reboot-migration-support`.
```
Get-EC2InstanceType `
-Filter @{Name="reboot-migration-support";Values="true"} | `
Select InstanceType | Sort-Object InstanceType
```
**Locação**
+ Compartilhada
+ Instância Dedicada
Para obter mais informações, consulte [Instâncias dedicadas do Amazon EC2](dedicated-instance.md).
**Limitações**
**Não** há suporte à migração com reinicialização em instâncias com as seguintes características:
+ Plataforma: instâncias em execução nativa no hipervisor Xen
+ Tamanho da instância: `metal` instâncias
+ Locação: host dedicado. Para hosts dedicados, use a [recuperação automática de host dedicado](dedicated-hosts-recovery.md) em vez disso.
+ Armazenamento: instâncias com volumes de armazenamento de instância
+ Rede: instâncias usando um adaptador de malha elástica
+ Ajuste de escala automático: instâncias que fazem parte de um grupo do Auto Scaling
### Etapas para habilitar ou desabilitar a migração com reinicialização
Quando uma instância recebe um evento `system-reboot`, ela é habilitada para a migração com reinicialização por padrão. É possível desabilitar a migração com reinicialização para que, durante uma reinicialização iniciada pelo usuário, a instância permaneça no mesmo hardware (reinicialização no local).
A configuração `default` não habilita a migração com reinicialização para uma instância sem suporte. Para obter mais informações, consulte [Requisitos para habilitar a migração com reinicialização](#requirements-for-reboot-migration).
É possível desabilitar ou habilitar a migração com reinicialização em uma instância em execução ou parada.
------
#### [ AWS CLI ]
**Para desabilitar a migração com reinicialização**
Use o comando [modify-instance-maintenance-options](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-maintenance-options.html) e defina o parâmetro `--reboot-migration` como `disabled`.
```
aws ec2 modify-instance-maintenance-options \
--instance-id i-0abcdef1234567890 \
--reboot-migration disabled
```
**Para habilitar a migração com reinicialização**
Use o comando [modify-instance-maintenance-options](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-maintenance-options.html) e defina o parâmetro `--reboot-migration` como `default`.
```
aws ec2 modify-instance-maintenance-options \
--instance-id i-0abcdef1234567890 \
--reboot-migration default
```
------
#### [ PowerShell ]
**Para desabilitar a migração com reinicialização**
Use o cmdlet [Edit-EC2InstanceMaintenanceOption](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceMaintenanceOption.html).
```
Edit-EC2InstanceMaintenanceOption `
-InstanceId `
-RebootMigration Disabled
```
**Para habilitar a migração com reinicialização**
Use o cmdlet [Edit-EC2InstanceMaintenanceOption](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceMaintenanceOption.html).
```
Edit-EC2InstanceMaintenanceOption `
-InstanceId i-1234567890abcdef0 `
-RebootMigration Enabled
```
------
# Gerenciamento das instâncias do Amazon EC2 agendadas para manutenção
Quando a AWS precisa manter o host subjacente de uma instância, ela programa a instância para manutenção. Há dois tipos de eventos de manutenção: manutenção de rede e manutenção de energia.
+ Durante a manutenção de rede, instâncias programadas perdem a conectividade de rede durante um breve período. A conectividade de rede normal com a instância é restaurada depois que a manutenção for concluída.
+ Durante a manutenção de energia, as instâncias programadas ficam offline durante um breve período e depois são reinicializadas. Quando uma reinicialização é realizada, todas as definições de configuração da instância são mantidas.
Depois que sua instância tiver sido reinicializada (isso geralmente leva alguns minutos), verifique se a aplicação está funcionando conforme o esperado. Nesse ponto, a instância não deve mais ter um evento associado a ela ou, se tiver, a descrição do evento programado começará com **[Completed]**. Às vezes, leva até 1 hora para que a descrição do status da instância seja atualizada. Eventos de manutenção concluídos são exibidos no painel do console do Amazon EC2 por até uma semana.
## Ações que você pode realizar
**Ações que podem ser realizadas em instâncias com um volume raiz do EBS**
Ao receber uma notificação de evento `system-maintenance`, você pode realizar uma destas ações:
+ **Aguardar a manutenção programada:** você pode esperar que a manutenção ocorra conforme programado.
+ **Executar a interrupção e o início manuais:** você pode parar e iniciar a instância, o que a migra para um novo host. Isso não equivale a reiniciar a instância. Para obter mais informações, consulte [Início e interrupção de instâncias do Amazon EC2](Stop_Start.md).
+ **Automatizar a interrupção e o início**: você pode automatizar uma interrupção e um início imediatos em resposta a um evento de manutenção programado. Para obter mais informações, consulte [Como executar automaticamente operações em instâncias do EC2 em resposta a eventos no AWS Health](https://docs.aws.amazon.com/health/latest/ug/automating-instance-actions.html) no *Guia do usuário do AWS Health*.
**Ações que você pode realizar para instâncias com um volume raiz do armazenamento de instâncias**
Ao receber uma notificação de evento `system-maintenance`, você pode realizar uma destas ações:
+ **Aguardar a manutenção programada:** você pode esperar que a manutenção ocorra conforme programado.
+ **Lançar uma instância de substituição:** se quiser manter a operação normal durante a janela de manutenção programada:
1. Lance uma instância de substituição a partir da sua AMI mais recente.
1. Migre todos os dados necessários para a instância substituta antes da janela de manutenção programada.
1. Encerre a instância original.
# Visualizar eventos programados que afetam as instâncias do Amazon EC2
Além de receber a notificação de eventos programados por e-mail, você pode verificar se há eventos programados.
------
#### [ Console ]
**Para visualizar eventos programados para suas instâncias**
1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. O painel exibe quaisquer recursos com um evento associado em **Eventos agendados**.
![\[Visualização de eventos usando o painel.\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/dashboard-scheduled-events.png)
1. Para obter mais detalhes, escolha **Eventos** no painel de navegação. Todos os recursos com um evento associado serão exibidos. É possível filtrar por características como tipo de evento, tipo de recurso e zona de disponibilidade.
![\[Visualização de eventos usando a página de eventos.\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/events-instance-scheduled-stop.png)
------
#### [ AWS CLI ]
**Para visualizar eventos programados para suas instâncias**
Use o comando [describe-instance-status](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-status.html).
```
aws ec2 describe-instance-status \
--instance-id i-1234567890abcdef0 \
--query "InstanceStatuses[].Events"
```
O exemplo de saída a seguir mostra um evento de reinicialização.
```
[
"Events": [
{
"InstanceEventId": "instance-event-0d59937288b749b32",
"Code": "system-reboot",
"Description": "The instance is scheduled for a reboot",
"NotAfter": "2019-03-15T22:00:00.000Z",
"NotBefore": "2019-03-14T20:00:00.000Z",
"NotBeforeDeadline": "2019-04-05T11:00:00.000Z"
}
]
]
```
O exemplo de saída a seguir mostra um evento de desativação de instância:
```
[
"Events": [
{
"InstanceEventId": "instance-event-0e439355b779n26",
"Code": "instance-stop",
"Description": "The instance is running on degraded hardware",
"NotBefore": "2015-05-23T00:00:00.000Z"
}
]
]
```
------
#### [ PowerShell ]
**Para visualizar eventos programados para suas instâncias**
Use o seguinte comando [Get-EC2InstanceStatus](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceStatus.html).
```
(Get-EC2InstanceStatus -InstanceId i-1234567890abcdef0).Events
```
O exemplo de saída a seguir mostra um evento de desativação de instância:
```
Code : instance-stop
Description : The instance is running on degraded hardware
NotBefore : 5/23/2015 12:00:00 AM
```
------
#### [ Instance metadata ]
**Para visualizar os eventos programados para suas instâncias usando metadados de instância**
É possível recuperar informações sobre eventos de manutenção ativos para suas instâncias dos [metadados de instância](ec2-instance-metadata.md) usando o Serviço de metadados da instância versão 2 ou o Serviço de metadados da instância versão 1.
**IMDSv2**
```
[ec2-user ~]$ TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/meta-data/events/maintenance/scheduled
```
**IMDSv1**
```
[ec2-user ~]$ curl http://169.254.169.254/latest/meta-data/events/maintenance/scheduled
```
A seguir, temos um exemplo de saída com informações sobre um evento de reinicialização do sistema programado, no formato JSON.
```
[
{
"NotBefore" : "21 Jan 2019 09:00:43 GMT",
"Code" : "system-reboot",
"Description" : "scheduled reboot",
"EventId" : "instance-event-0d59937288b749b32",
"NotAfter" : "21 Jan 2019 09:17:23 GMT",
"State" : "active"
}
]
```
**Para visualizar o histórico de eventos sobre eventos concluídos ou cancelados das suas instâncias usando metadados de instância**
É possível recuperar informações sobre eventos concluídos ou cancelados para suas instâncias dos [metadados de instância](ec2-instance-metadata.md) usando o Serviço de metadados da instância versão 2 ou o Serviço de metadados da instância versão 1.
**IMDSv2**
```
[ec2-user ~]$ TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/meta-data/events/maintenance/history
```
**IMDSv1**
```
[ec2-user ~]$ curl http://169.254.169.254/latest/meta-data/events/maintenance/history
```
A seguir, temos um exemplo de saída com informações sobre um evento de reinicialização do sistema que foi cancelado e um que foi concluído, no formato JSON.
```
[
{
"NotBefore" : "21 Jan 2019 09:00:43 GMT",
"Code" : "system-reboot",
"Description" : "[Canceled] scheduled reboot",
"EventId" : "instance-event-0d59937288b749b32",
"NotAfter" : "21 Jan 2019 09:17:23 GMT",
"State" : "canceled"
},
{
"NotBefore" : "29 Jan 2019 09:00:43 GMT",
"Code" : "system-reboot",
"Description" : "[Completed] scheduled reboot",
"EventId" : "instance-event-0d59937288b749b32",
"NotAfter" : "29 Jan 2019 09:17:23 GMT",
"State" : "completed"
}
]
```
------
#### [ AWS Health ]
É possível usar o AWS Health Dashboard para saber mais sobre eventos que podem afetar a instância. O Health Dashboard organiza problemas em três grupos: ocorrências abertas, alterações programadas e outras notificações. O grupo de alterações programadas contém itens presentes e futuros.
Para obter mais informações, consulte [Como iniciar o AWS Health Dashboard](https://docs.aws.amazon.com/health/latest/ug/getting-started-health-dashboard.html) no *Guia do usuário do AWS Health*.
------
# Personalizar notificações de eventos programados para suas instâncias do EC2
É 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
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
É 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
É 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
```
------
# Reagendar um evento programado para uma instância do EC2
É possível reagendar um evento para que ele ocorra em uma data e hora específicas que forem convenientes. Após um evento programado ser reagendado, até um ou dois minutos podem ser necessários para que a data atualizada seja exibida.
**Limitações**
+ Somente eventos com uma data de prazo podem ser reprogramados. O evento pode ser reprogramado até a data de prazo do evento. A data limite do evento é indicada na coluna **Data limite** (console) e o campo `NotBeforeDeadline` (AWS CLI).
+ Somente eventos ainda não iniciados podem ser reprogramados. A hora de início é indicada na coluna **Hora de início** (console) e no campo `NotBefore` (AWS CLI). Eventos programados para início nos próximos cinco minutos não podem ser reprogramados.
+ A nova hora de início do evento deve ser pelo menos 60 minutos a partir da hora atual.
+ Se você reprogramar vários eventos usando o console, a data de prazo do evento será determinada pelo evento com a data de prazo do evento mais recente.
------
#### [ Console ]
**Para reprogramar um evento**
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 **Resource type: instance (Tipo de recurso: instância)** na lista de filtros.
1. Escolha uma ou mais instâncias e selecione **Actions (Ações)**, **Schedule event (Programar evento)**.
Somente eventos que têm uma data de prazo de evento, indicados por um valor para **Deadline (Prazo)**, podem ser reprogramados. Se um dos eventos selecionados não tiver uma data de prazo, a opção **Actions (Ações)**, **Schedule event (Programar evento)** será desativada.
1. Em **New start time (Nova hora de início)**, insira uma nova data e hora para o evento. A nova data e hora devem ocorrer antes de **Event deadline (Prazo do evento)**.
1. Escolha **Salvar**.
Pode levar um ou dois minutos para a hora de início do evento atualizado ser refletida no console.
------
#### [ AWS CLI ]
**Para reprogramar um evento**
Use o comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-start-time.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-start-time.html).
```
aws ec2 modify-instance-event-start-time \
--instance-id i-1234567890abcdef0 \
--instance-event-id instance-event-0d59937288b749b32 \
--not-before 2020-03-25T10:00:00.000
```
------
#### [ PowerShell ]
**Para reprogramar um evento**
Use o cmdlet [Edit-EC2InstanceEventStartTime](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceEventStartTime.html).
```
Edit-EC2InstanceEventStartTime `
-InstanceId i-1234567890abcdef0 `
-InstanceEventId instance-event-0d59937288b749b32 `
-NotBefore 2020-03-25T10:00:00.000
```
------
# Criar janelas de eventos personalizadas para eventos programados que afetam as instâncias do Amazon EC2
É possível definir janelas de eventos personalizadas recorrentes semanalmente para eventos agendados que reinicializam, interrompem ou terminam suas instâncias do Amazon EC2. É possível associar uma ou mais instâncias a uma janela de eventos. Se um evento agendado para essas instâncias estiver planejado, a AWS irá programar os eventos na janela de eventos associada.
É possível usar janelas de eventos para maximizar a disponibilidade da workload especificando janelas de eventos que ocorrem durante períodos fora do pico para sua workload. Também é possível alinhar as janelas de eventos com suas programações de manutenção internas.
Você define uma janela de evento especificando um conjunto de intervalos de tempo. O intervalo de tempo mínimo é de duas horas. Os intervalos de tempo combinados devem totalizar pelo menos 4 horas.
É possível associar uma ou mais instâncias a uma janela de evento usando IDs de instância ou tags de instância. Também é possível associar hosts dedicados a uma janela de evento usando o ID do host.
**Atenção**
As janelas de eventos são aplicáveis apenas para eventos agendados que param, reinicializam ou encerram instâncias.
Janelas de eventos sãonãoaplicável para:
Eventos agendados e eventos de manutenção de rede acelerados.
Manutenção não programada, como [recuperação automática de instâncias](ec2-instance-recover.md) e reinicializações não planejadas.
**Topics**
+ [Considerações](#event-windows-considerations)
+ [Criar uma janela de eventos](#create-event-windows)
+ [Associar um alvo a uma janela de evento](#associate-target-event-window)
+ [Desassociar uma tag de uma janela de eventos](#disassociate-target-event-window)
+ [Modificar uma janela de eventos](#modify-event-windows)
+ [Excluir uma janela de eventos](#delete-event-windows)
## Considerações
+ Todos os horários da janela de eventos são mostrados em UTC.
+ Uma janela de eventos pode conter vários intervalos de tempo. Embora cada intervalo individual deva ter pelo menos duas horas, a duração total em todos os intervalos deve ser de pelo menos quatro horas.
+ Apenas um tipo de destino (ID de instância, ID de host dedicado ou tag de instância) pode ser associado a uma janela de evento.
+ Um destino (ID de instância, ID de host dedicado ou tag de instância) só pode ser associado a uma janela de evento.
+ Um máximo de 100 IDs de instância, ou 50 IDs de host dedicados ou 50 tags de instância podem ser associados a uma janela de evento. As tags de instância podem ser associadas a qualquer número de instâncias.
+ Um máximo de 200 janelas de eventos podem ser criadas por AWS região:
+ Várias instâncias associadas a janelas de eventos podem potencialmente ter eventos agendados ocorrem ao mesmo tempo.
+ Se a AWS já agendou um evento, modificar uma janela de evento não alterará a hora do evento agendado. Se o evento tiver uma data limite, é possível[reprogramar o evento](reschedule-event.md).
+ Você pode interromper e iniciar uma instância antes do evento programado. Isso migra essa instância para um novo host e limpa o evento.
## Criar uma janela de eventos
É possível criar uma ou mais janelas de eventos. Para cada janela de evento, você especifica um ou mais blocos de tempo. Por exemplo, é possível criar uma janela de evento com blocos de tempo que ocorrem todos os dias às 4h por duas horas. Ou é possível criar uma janela de evento com blocos de tempo que ocorrem aos domingos, das 2h às 4h, e às quartas-feiras, das 3h às 5h.
Janelas de eventos repetem semanalmente até que você as exclua.
------
#### [ Console ]
**Para criar uma janela 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. Selecione **Ações**, **Gerenciar janelas de eventos**.
1. Selecione **Janela Criar evento de instância**.
1. para o **Nome da janela de eventos**, insira um nome descritivo para a janela de eventos.
1. para o **Agendamento de janelas**, escolha especificar os blocos de tempo na janela de eventos usando o construtor de cron ou especificando intervalos de tempo.
+ Se escolher o **Construtor de cron**, especifique o seguinte:
1. para o **Dias (UTC)**, especifique os dias da semana em que a janela de eventos ocorre.
1. para o **Hora de início (UTC)**, especifique a hora em que a janela de evento começa.
1. para a **Duração**, especifique a duração dos blocos de tempo na janela do evento. A duração mínima por bloco de tempo é de 2 horas. A duração mínima da janela do evento deve ser igual ou superior a 4 horas no total. Todos os horários são em UTC.
+ Se escolher **Intervalos de tempo**, escolha **Adicione um novo intervalo de tempo** e especifique o dia e a hora de início e o dia e a hora de término. Repita para cada intervalo de tempo. A duração mínima por intervalo de tempo é de 2 horas. A duração mínima para todos os intervalos de tempo combinados deve ser igual ou superior a 4 horas no total.
1. (Opcional) Em **Detalhes do destino**, associe uma ou mais instâncias à janela de eventos. Use IDs de instância ou etiquetas de instância para associar instâncias. Use IDs de host para associar Hosts dedicados. Quando esses destinos estiverem programados para manutenção, o evento ocorrerá durante essa janela de eventos.
É possível criar a janela de evento sem associar um destino à janela. Posteriormente, é possível modificar a janela para associar um ou mais alvos.
1. (Opcional) Para **Tags da janela de evento**, escolha **Adicionar tag** e insira a chave e o valor da tag. Repita esse procedimento para cada tag.
1. Selecione **Janela Criar eventos**.
------
#### [ AWS CLI ]
**Para criar uma janela de eventos com um intervalo de tempo**
Use o comando [create-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-instance-event-window.html).
```
aws ec2 create-instance-event-window \
--time-range StartWeekDay=monday,StartHour=2,EndWeekDay=wednesday,EndHour=8 \
--tag-specifications "ResourceType=instance-event-window,Tags=[{Key=K1,Value=V1}]" \
--name myEventWindowName
```
O seguinte é um exemplo de saída.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"TimeRanges": [
{
"StartWeekDay": "monday",
"StartHour": 2,
"EndWeekDay": "wednesday",
"EndHour": 8
}
],
"Name": "myEventWindowName",
"State": "creating",
"Tags": [
{
"Key": "K1",
"Value": "V1"
}
]
}
}
```
**Para criar uma janela de eventos com uma expressão cron**
Use o comando [create-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-instance-event-window.html).
```
aws ec2 create-instance-event-window \
--cron-expression "* 21-23 * * 2,3" \
--tag-specifications "ResourceType=instance-event-window,Tags=[{Key=K1,Value=V1}]" \
--name myEventWindowName
```
O seguinte é um exemplo de saída.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"State": "creating",
"Tags": [
{
"Key": "K1",
"Value": "V1"
}
]
}
}
```
------
#### [ PowerShell ]
**Para criar uma janela de eventos com um intervalo de tempo**
Use o cmdlet [New-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2InstanceEventWindow.html).
```
$timeRange = New-Object Amazon.EC2.Model.InstanceEventWindowTimeRangeRequest
$timeRange.StartWeekDay = "monday"
$timeRange.EndWeekDay = "wednesday"
$timeRange.StartHour = 2
$timeRange.EndHour = 8
$tag = @{Key="key1"; Value="value1"}
$tagspec = New-Object Amazon.EC2.Model.TagSpecification
$tagspec.ResourceType = "instance-event-window"
$tagspec.Tags.Add($tag)
New-EC2InstanceEventWindow `
-Name my-event-window `
-TagSpecification $tagspec `
-TimeRange @($timeRange)
```
O seguinte é um exemplo de saída.
```
AssociationTarget :
CronExpression :
InstanceEventWindowId : iew-0abcdef1234567890
Name : my-event-window
State : creating
Tags : {key1}
TimeRanges : {Amazon.EC2.Model.InstanceEventWindowTimeRange}
```
**Para criar uma janela de eventos com uma expressão cron**
Use o cmdlet [New-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2InstanceEventWindow.html).
```
$tag = @{Key="key1"; Value="value1"}
$tagspec = New-Object Amazon.EC2.Model.TagSpecification
$tagspec.ResourceType = "instance-event-window"
$tagspec.Tags.Add($tag)
New-EC2InstanceEventWindow `
-Name my-event-window `
-TagSpecification $tagspec`
-CronExpression "* 21-23 * * 2,3"
```
O seguinte é um exemplo de saída.
```
AssociationTarget :
CronExpression : * 21-23 * * 2,3
InstanceEventWindowId : iew-0abcdef1234567890
Name : my-event-window
State : creating
Tags : {key1}
TimeRanges : {}
```
------
## Associar um alvo a uma janela de evento
Após criar uma janela de evento, você poderá associar destinos à janela de eventos. É possível associar apenas um tipo de destino a uma janela de eventos. É possível especificar IDs de instância, IDs de host dedicado ou tags de instância.
------
#### [ Console ]
**Para associar destinos adicionais a uma janela 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. Selecione a janela de eventos a ser modificada.
1. Escolha **Ações**, **Modificar janela de eventos da instância**.
------
#### [ AWS CLI ]
**Para associar tags de instância a uma janela de eventos**
Use o comando [associate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/associate-instance-event-window.html).
```
aws ec2 associate-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--association-target "InstanceTags=[{Key=k2,Value=v2},{Key=k1,Value=v1}]"
```
O seguinte é um exemplo de saída.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [],
"Tags": [
{
"Key": "k2",
"Value": "v2"
},
{
"Key": "k1",
"Value": "v1"
}
],
"DedicatedHostIds": []
},
"State": "creating"
}
}
```
**Para associar IDs de instâncias a uma janela de eventos**
Use o comando [associate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/associate-instance-event-window.html).
```
aws ec2 associate-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--association-target "InstanceIds=i-1234567890abcdef0,i-0598c7d356eba48d7"
```
O seguinte é um exemplo de saída.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [
"i-1234567890abcdef0",
"i-0598c7d356eba48d7"
],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating"
}
}
```
**Para associar um host dedicado a uma janela de eventos**
Use o comando [associate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/associate-instance-event-window.html).
```
aws ec2 associate-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--association-target "DedicatedHostIds=h-029fa35a02b99801d"
```
O seguinte é um exemplo de saída.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [],
"Tags": [],
"DedicatedHostIds": [
"h-029fa35a02b99801d"
]
},
"State": "creating"
}
}
```
------
#### [ PowerShell ]
**Para associar tags de instância a uma janela de eventos**
Use o cmdlet [Register-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventWindow.html).
```
$tag1 = @{Key="key1"; Value="value1"}
$tag2 = @{Key="key2"; Value="value2"}
Register-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-AssociationTarget_InstanceTag @($tag1,$tag2)
```
**Para associar IDs de instâncias a uma janela de eventos**
Use o cmdlet [Register-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventWindow.html).
```
Register-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-AssociationTarget_InstanceId i-1234567890abcdef0, i-0598c7d356eba48d7
```
**Para associar um host dedicado a uma janela de eventos**
Use o cmdlet [Register-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventWindow.html).
```
Register-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-AssociationTarget_DedicatedHostId h-029fa35a02b99801d
```
------
## Desassociar uma tag de uma janela de eventos
------
#### [ Console ]
**Para desassociar destinos com uma janela 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. Selecione a janela de eventos a ser modificada.
1. Escolha **Ações**, **Modificar janela de eventos da instância**.
------
#### [ AWS CLI ]
**Para desassociar tags de instância de uma janela de eventos**
Use o comando [disassociate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference//ec2/disassociate-instance-event-window.html).
```
aws ec2 disassociate-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--association-target "InstanceTags=[{Key=k2,Value=v2},{Key=k1,Value=v1}]"
```
O seguinte é um exemplo de saída.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating"
}
}
```
**Para desassociar IDs de instâncias de uma janela de eventos**
Use o comando [disassociate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/disassociate-instance-event-window.html).
```
aws ec2 disassociate-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--association-target "InstanceIds=i-1234567890abcdef0,i-0598c7d356eba48d7"
```
O seguinte é um exemplo de saída.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating"
}
}
```
**Para desassociar um host dedicado de uma janela de eventos**
Use o comando [disassociate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/disassociate-instance-event-window.html).
```
aws ec2 disassociate-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--association-target DedicatedHostIds=h-029fa35a02b99801d
```
O seguinte é um exemplo de saída.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating"
}
}
```
------
#### [ PowerShell ]
**Para desassociar tags de instância de uma janela de eventos**
Use o cmdlet [Unregister-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventWindow.html).
```
$tag1 = @{Key="key1"; Value="value1"}
$tag2 = @{Key="key2"; Value="value2"}
Unregister-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-AssociationTarget_InstanceTag @($tag1, $tag2)
```
**Para desassociar IDs de instâncias de uma janela de eventos**
Use o cmdlet [Unregister-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventWindow.html).
```
Unregister-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-AssociationTarget_InstanceId i-1234567890abcdef0, i-0598c7d356eba48d7
```
**Para desassociar um host dedicado de uma janela de eventos**
Use o cmdlet [Unregister-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventWindow.html).
```
Unregister-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-AssociationTarget_DedicatedHostId h-029fa35a02b99801d
```
------
## Modificar uma janela de eventos
É possível modificar todos os campos de uma janela de evento, exceto seu ID. Por exemplo, quando o horário de verão começar, convém modificar o agendamento da janela de eventos. Para janelas de eventos existentes, talvez você queira adicionar ou remover destinos.
É possível modificar um intervalo de tempo ou uma expressão cron ao modificar a janela de evento, mas não ambos.
------
#### [ Console ]
**Para modificar uma janela 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. Selecione **Ações**, **Gerenciar janelas de eventos**.
1. Selecione a janela de eventos a ser modificada e escolha **Ações**, **Janela Modificar evento da instância**.
1. Modifique os campos na janela de eventos e escolha **Modificar janela de evento**.
------
#### [ AWS CLI ]
**Para modificar o intervalo de tempo de uma janela de eventos**
Use o comando [modify-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-window.html).
```
aws ec2 modify-instance-event-window
--instance-event-window-id iew-0abcdef1234567890 \
--time-range StartWeekDay=monday,StartHour=2,EndWeekDay=wednesday,EndHour=8
```
O seguinte é um exemplo de saída.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"TimeRanges": [
{
"StartWeekDay": "monday",
"StartHour": 2,
"EndWeekDay": "wednesday",
"EndHour": 8
}
],
"Name": "myEventWindowName",
"AssociationTarget": {
"InstanceIds": [
"i-0abcdef1234567890",
"i-0be35f9acb8ba01f0"
],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating",
"Tags": [
{
"Key": "K1",
"Value": "V1"
}
]
}
}
```
**Modificar um conjunto de intervalos de tempo para uma janela de eventos**
Use o comando [modify-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-window.html).
```
aws ec2 modify-instance-event-window
--instance-event-window-id iew-0abcdef1234567890 \
--time-range '[{"StartWeekDay": "monday", "StartHour": 2, "EndWeekDay": "wednesday", "EndHour": 8},
{"StartWeekDay": "thursday", "StartHour": 2, "EndWeekDay": "friday", "EndHour": 8}]'
```
O seguinte é um exemplo de saída.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"TimeRanges": [
{
"StartWeekDay": "monday",
"StartHour": 2,
"EndWeekDay": "wednesday",
"EndHour": 8
},
{
"StartWeekDay": "thursday",
"StartHour": 2,
"EndWeekDay": "friday",
"EndHour": 8
}
],
"Name": "myEventWindowName",
"AssociationTarget": {
"InstanceIds": [
"i-0abcdef1234567890",
"i-0be35f9acb8ba01f0"
],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating",
"Tags": [
{
"Key": "K1",
"Value": "V1"
}
]
}
}
```
**Para modificar a expressão cron de uma janela de eventos**
Use o comando [modify-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-window.html).
```
aws ec2 modify-instance-event-window
--instance-event-window-id iew-0abcdef1234567890 \
--cron-expression "* 21-23 * * 2,3"
```
O seguinte é um exemplo de saída.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [
"i-0abcdef1234567890",
"i-0be35f9acb8ba01f0"
],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating",
"Tags": [
{
"Key": "K1",
"Value": "V1"
}
]
}
}
```
------
#### [ PowerShell ]
**Para modificar o intervalo de tempo de uma janela de eventos**
Use o cmdlet [Edit-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceEventWindow.html).
```
$timeRange1 = New-Object Amazon.EC2.Model.InstanceEventWindowTimeRangeRequest
$timeRange1.StartWeekDay = "monday"
$timeRange1.EndWeekDay = "wednesday"
$timeRange1.StartHour = 2
$timeRange1.EndHour = 8
$timeRange2 = New-Object Amazon.EC2.Model.InstanceEventWindowTimeRangeRequest
$timeRange2.StartWeekDay = "thursday"
$timeRange2.EndWeekDay = "friday"
$timeRange2.StartHour = 1
$timeRange2.EndHour = 6
Edit-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-TimeRange @($timeRange1, $timeRange2)
```
**Para modificar a expressão cron de uma janela de eventos**
Use o cmdlet [Edit-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceEventWindow.html).
```
Edit-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-CronExpression "* 21-23 * * 2,3"
```
------
## Excluir uma janela de eventos
É possível excluir uma janela de eventos de cada vez.
------
#### [ Console ]
**Para excluir uma janela 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. Selecione **Ações**, **Gerenciar janelas de eventos**.
1. Selecione a janela de eventos a ser excluída e escolha **Ações**, **Janela de evento Excluir instância**.
1. Quando solicitado, digite **delete** e escolha **Delete (Excluir)**.
------
#### [ AWS CLI ]
**Para excluir uma janela de eventos**
Usar a[delete-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-instance-event-window.html)e especifique a janela de evento a ser excluída.
```
aws ec2 delete-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890
```
**Para forçar a exclusão de uma janela de eventos**
Usar a`--force-delete`se a janela de evento estiver atualmente associada a destinos.
```
aws ec2 delete-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--force-delete
```
------
#### [ PowerShell ]
**Para excluir uma janela de eventos**
Use o cmdlet [Remove-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2InstanceEventWindow.html).
```
Remove-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890
```
**Para forçar a exclusão de uma janela de eventos**
Use o cmdlet [Remove-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2InstanceEventWindow.html).
```
Remove-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-ForceDelete $true
```
------