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 AutoRecovery e reinicializações não planejadas.

Considerações

• Todos os horários da janela de eventos são mostrados em UTC.

• A duração mínima da janela semanal de eventos é de quatro horas.

• Os intervalos de tempo dentro de uma janela de evento devem ser de pelo menos 2 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ívelreprogramar o evento.

• É possível interromper e iniciar uma instância antes do evento agendado, que migra a instância para um novo host, e o evento agendado não ocorrerá mais.

Criar janelas 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.

Para ver as restrições da janela de eventos, consulteConsideraçõesAnteriormente neste tópico.

Janelas de eventos repetem semanalmente até que você as exclua.

Use um dos métodos a seguir para criar uma janela de eventos.

Console

Para criar uma janela de eventos

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

2. No painel de navegação, selecione Events.

3. Selecione Ações, Gerenciar janelas de eventos.

4. Selecione Janela Criar evento de instância.

5. para o Nome da janela de eventos, insira um nome descritivo para a janela de eventos.

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

     2. para o Hora de início (UTC), especifique a hora em que a janela de evento começa.

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

7. (Opcional) Para Detalhes do alvo, associe uma ou mais instâncias à janela de evento para que, se as instâncias estiverem agendadas para manutenção, o evento agendado ocorra durante a janela de evento associada. É possível associar uma ou mais instâncias a uma janela de evento usando IDs de instância ou tags de instância. É possível associar hosts dedicados a uma janela de evento usando o ID do host.

   É possível criar a janela de evento sem associar um destino à janela. Posteriormente, é possível modificar a janela para associar um ou mais alvos.

8. (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.

9. Selecione Janela Criar eventos.

AWS CLI

Para criar uma janela de eventos usando a AWS CLI, crie primeiro a janela de evento e associe um ou mais destinos à janela de eventos.

Criar uma janela de eventos

É possível definir um conjunto de intervalos de tempo ou uma expressão cron ao criar a janela de evento, mas não ambos.

Para criar uma janela de eventos com um intervalo de tempo

Usar acreate-instance-event-windowe especifique o--time-rangeparâmetro . Você também deve especificar o parâmetro --cron-expression.

aws ec2 create-instance-event-window \
    --region us-east-1 \
    --time-range StartWeekDay=monday,StartHour=2,EndWeekDay=wednesday,EndHour=8 \
    --tag-specifications "ResourceType=instance-event-window,Tags=[{Key=K1,Value=V1}]" \
    --name myEventWindowName 

Saída esperada

{
    "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

Usar acreate-instance-event-windowe especifique o--cron-expressionparâmetro . Você também deve especificar o parâmetro --time-range.

aws ec2 create-instance-event-window \
    --region us-east-1 \
    --cron-expression "* 21-23 * * 2,3" \
    --tag-specifications "ResourceType=instance-event-window,Tags=[{Key=K1,Value=V1}]" \
    --name myEventWindowName

Saída esperada

{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "State": "creating",
        "Tags": [
            {
                "Key": "K1",
                "Value": "V1"
            }
        ]
    }
}

Associar um alvo a uma janela de evento

É possível associar apenas um tipo de destino (IDs de instância, IDs de host dedicado ou tags de instância) a uma janela de evento.

Para associar tags de instância a uma janela de eventos

Usar aassociar-instance-event-windowe especifique oinstance-event-window-idparâmetro para especificar a janela de evento. Para associar tags de instância, especifique o--association-targete para os valores de parâmetro, especifique uma ou mais tags.

aws ec2 associate-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target "InstanceTags=[{Key=k2,Value=v2},{Key=k1,Value=v1}]"

Saída esperada

{
    "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 uma ou mais instâncias a uma janela de eventos

Usar aassociar-instance-event-windowe especifique oinstance-event-window-idparâmetro para especificar a janela de evento. Para associar instâncias, especifique o--association-targete para os valores de parâmetro, especifique um ou mais IDs de instância.

aws ec2 associate-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target "InstanceIds=i-1234567890abcdef0,i-0598c7d356eba48d7"

Saída esperada

{
    "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

Usar aassociar-instance-event-windowe especifique oinstance-event-window-idparâmetro para especificar a janela de evento. Para associar um Host Dedicado, especifique o--association-targete, para os valores de parâmetro, especifique um ou mais IDs de Host Dedicado.

aws ec2 associate-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target "DedicatedHostIds=h-029fa35a02b99801d"

Saída esperada

{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [],
            "Tags": [],
            "DedicatedHostIds": [
                "h-029fa35a02b99801d"
            ]
        },
        "State": "creating"
    }
}

Visualizador de eventos do Windows

É possível reagendar um evento usando um dos métodos a seguir.

Console

Para visualizar janelas de eventos

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

2. No painel de navegação, selecione Events.

3. Selecione Ações, Gerenciar janelas de eventos.

4. Selecione uma janela de eventos para visualizar seus detalhes.

AWS CLI

Para descrever todas as janelas de eventos

Usar adescribe-instance-event-windowscomando.

aws ec2 describe-instance-event-windows \
    --region us-east-1

Saída esperada

{
    "InstanceEventWindows": [
        {
            "InstanceEventWindowId": "iew-0abcdef1234567890",
            "Name": "myEventWindowName",
            "CronExpression": "* 21-23 * * 2,3",
            "AssociationTarget": {
                "InstanceIds": [
                    "i-1234567890abcdef0",
                    "i-0598c7d356eba48d7"
                ],
                "Tags": [],
                "DedicatedHostIds": []
            },
            "State": "active",
            "Tags": []
        }
        
        ...
        
    ],
    "NextToken": "9d624e0c-388b-4862-a31e-a85c64fc1d4a"
}

Para descrever uma janela de eventos específica

Usar adescribe-instance-event-windowscom o comando--instance-event-window-idpara descrever uma janela de evento específica.

aws ec2 describe-instance-event-windows \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890

Para descrever janelas de eventos que correspondam a um ou mais filtros

Usar adescribe-instance-event-windowscom o comando--filtersparâmetro . No exemplo a seguir, o filtro instance-id é usado para descrever todas as janelas de eventos que estão associadas à instância especificada.

Quando um filtro é usado, ele executa uma correspondência direta. No entanto, oinstance-idé diferente. Se não houver correspondência direta com o ID da instância, ele voltará para associações indiretas com a janela de eventos, como tags da instância ou ID de host dedicado (se a instância estiver em um host dedicado).

Para obter a lista de filtros com suporte, consulte describe-instance-event-windows.

aws ec2 describe-instance-event-windows \
    --region us-east-1 \
    --filters Name=instance-id,Values=i-1234567890abcdef0 \
    --max-results 100 \
    --next-token <next-token-value>

Saída esperada

No exemplo a seguir, a instância está em um Host Dedicado, que está associado à janela de evento.

{
    "InstanceEventWindows": [
        {
            "InstanceEventWindowId": "iew-0dbc0adb66f235982",
            "TimeRanges": [
                {
                    "StartWeekDay": "sunday",
                    "StartHour": 2,
                    "EndWeekDay": "sunday",
                    "EndHour": 8
                }
            ],
            "Name": "myEventWindowName",
            "AssociationTarget": {
                "InstanceIds": [],
                "Tags": [],
                "DedicatedHostIds": [
                    "h-0140d9a7ecbd102dd"
                ]
            },
            "State": "active",
            "Tags": []
        }
    ]
}

Modificar janelas de

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

Para modificar um volume do EBS, use um dos métodos a seguir.

Console

Para modificar uma janela de eventos

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

2. No painel de navegação, selecione Events.

3. Selecione Ações, Gerenciar janelas de eventos.

4. Selecione a janela de eventos a ser modificada e escolha Ações, Janela Modificar evento da instância.

5. Modifique os campos na janela de eventos e escolha Modificar janela de evento.

AWS CLI

Para modificar uma janela de eventos usando a AWS CLI, é possível modificar o intervalo de tempo ou a expressão cron e associar ou desassociar um ou mais destinos à janela de evento.

Modificar a hora da janela de

É possível modificar um intervalo de tempo ou uma expressão cron ao modificar a janela de evento, mas não ambos.

Para modificar o intervalo de tempo de uma janela de eventos

Usar amodify-instance-event-windowe especifique a janela de evento a ser modificada. Especifique o--time-rangeParâmetro para modificar o intervalo de tempo. Você também deve especificar o parâmetro --cron-expression.

aws ec2 modify-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --time-range StartWeekDay=monday,StartHour=2,EndWeekDay=wednesday,EndHour=8 

Saída esperada

{
    "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

Usar amodify-instance-event-windowe especifique a janela de evento a ser modificada. Especifique o--time-rangeParâmetro para modificar o intervalo de tempo. Você também não pode especificar o--cron-expressionParâmetro na mesma chamada.

aws ec2 modify-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --time-range '[{"StartWeekDay": "monday", "StartHour": 2, "EndWeekDay": "wednesday", "EndHour": 8},
	  {"StartWeekDay": "thursday", "StartHour": 2, "EndWeekDay": "friday", "EndHour": 8}]'

Saída esperada

{
    "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

Usar amodify-instance-event-windowe especifique a janela de evento a ser modificada. Especifique o--cron-expressionpara modificar a expressão cron. Você também deve especificar o parâmetro --time-range.

aws ec2 modify-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --cron-expression "* 21-23 * * 2,3"

Saída esperada

{
    "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"
            }
        ]
    }
}

Modificar os alvos associados a uma janela de evento

É possível associar alvos adicionais a uma janela de evento. Também é possível desassociar alvos existentes de uma janela de evento. No entanto, apenas um tipo de destino (IDs de instância, IDs de host dedicado ou tags de instância) pode ser associado a uma janela de evento.

Para associar alvos adicionais a uma janela de evento

Para obter instruções sobre como associar alvos a uma janela de evento, consulteAssociate a target with an event window.

Para desassociar tags de instância de uma janela de eventos

Usar adisassociar-instance-event-janelae especifique oinstance-event-window-idparâmetro para especificar a janela de evento. Para desassociar tags de instância, especifique o--association-targete para os valores de parâmetro, especifique uma ou mais tags.

aws ec2 disassociate-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target "InstanceTags=[{Key=k2,Value=v2},{Key=k1,Value=v1}]"

Saída esperada

{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [],
            "Tags": [],
            "DedicatedHostIds": []
        },
        "State": "creating"
    }
}

Para desassociar uma ou mais instâncias de uma janela de eventos

Usar adisassociar-instance-event-janelae especifique oinstance-event-window-idparâmetro para especificar a janela de evento. Para desassociar instâncias, especifique o--association-targete para os valores de parâmetro, especifique um ou mais IDs de instância.

aws ec2 disassociate-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target "InstanceIds=i-1234567890abcdef0,i-0598c7d356eba48d7"

Saída esperada

{
    "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

Usar adisassociar-instance-event-janelae especifique oinstance-event-window-idparâmetro para especificar a janela de evento. Para desassociar um Host Dedicado, especifique o--association-targete, para os valores de parâmetro, especifique um ou mais IDs de Host Dedicado.

aws ec2 disassociate-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target DedicatedHostIds=h-029fa35a02b99801d

Saída esperada

{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [],
            "Tags": [],
            "DedicatedHostIds": []
        },
        "State": "creating"
    }
}

Excluir janelas de eventos

É possível excluir uma janela de eventos de cada vez usando um dos métodos a seguir.

Console

Para excluir uma janela de eventos

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

2. No painel de navegação, selecione Events.

3. Selecione Ações, Gerenciar janelas de eventos.

4. Selecione a janela de eventos a ser excluída e escolha Ações, Janela de evento Excluir instância.

5. Quando solicitado, digite delete e escolha Delete (Excluir).

AWS CLI

Para excluir uma janela de eventos

Usar adelete-instance-event-windowe especifique a janela de evento a ser excluída.

aws ec2 delete-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890

Para forçar a exclusão de uma janela de eventos

Usar a--force-deletese a janela de evento estiver atualmente associada a destinos.

aws ec2 delete-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --force-delete

Saída esperada

{
    "InstanceEventWindowState": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "State": "deleting"
    }
}

Marcar janelas de eventos

É possível marcar uma janela de evento ao criá-la ou posteriormente.

Para marcar uma janela de evento ao criá-la, consulteCriar janelas de eventos.

Use um dos métodos a seguir para marcar uma janela de evento.

Console

Para marcar uma janela de eventos atual

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

2. No painel de navegação, selecione Events.

3. Selecione Ações, Gerenciar janelas de eventos.

4. Selecione a janela de eventos a ser marcada e escolha Ações, Gerenciar tags de janela de evento.

5. Para adicionar uma tag, escolha Add tag. Repita esse procedimento para cada tag.

6. Escolha Salvar.

AWS CLI

Para marcar uma janela de eventos atual

Use o comando create-tags para marcar os recursos existentes. No exemplo a seguir, a solicitação de existente é marcada com Key=purpose e Value=test.

aws ec2 create-tags \
    --resources iew-0abcdef1234567890 \
    --tags Key=purpose,Value=test