Obter o estado de um calendário de alterações - AWS Systems Manager

Obter o estado de um calendário de alterações

Você pode obter o estado geral de um calendário ou o estado de um calendário em um horário específico no Change Calendar, uma ferramenta do AWS Systems Manager. Também é possível mostrar a próxima vez em que o estado do calendário muda de OPEN para CLOSED ou vice-versa.

nota

Para obter informações sobre a integração do Change Calendar com o Amazon EventBridge para monitoramento automatizado das mudanças de estado do calendário, consulte Integração do Change Calendar com o Amazon EventBridge. A integração com o EventBridge fornece notificações orientadas por eventos quando os estados do calendário fazem a transição, complementando a abordagem baseada em polling da ação da API GetCalendarState.

Você só pode fazer essa tarefa usando a API GetCalendarState. O procedimento nesta seção usa a AWS Command Line Interface (AWS CLI).

Para obter o estado de um calendário de alterações

  • Execute o seguinte comando para mostrar o estado de um ou mais calendários em um horário específico. O parâmetro --calendar-names é obrigatório, mas --at-time é opcional. Substitua cada espaço reservado para recurso de exemplo por suas próprias informações.

    Linux & macOS
    aws ssm get-calendar-state \
    --calendar-names "Calendar_name_or_document_ARN_1" "Calendar_name_or_document_ARN_2" \
    --at-time "ISO_8601_time_format"

    Veja um exemplo a seguir.

    aws ssm get-calendar-state \
    --calendar-names "arn:aws:ssm:us-east-2:123456789012:document/MyChangeCalendarDocument" "arn:aws:ssm:us-east-2:123456789012:document/SupportOffHours" \
    --at-time "2020-07-30T11:05:14-0700"
    Windows
    aws ssm get-calendar-state ^
    --calendar-names "Calendar_name_or_document_ARN_1" "Calendar_name_or_document_ARN_2" ^
    --at-time "ISO_8601_time_format"

    Veja um exemplo a seguir.

    aws ssm get-calendar-state ^
    --calendar-names "arn:aws:ssm:us-east-2:123456789012:document/MyChangeCalendarDocument" "arn:aws:ssm:us-east-2:123456789012:document/SupportOffHours" ^
    --at-time "2020-07-30T11:05:14-0700"

    O comando retorna informações como as seguintes.

    {
    "State": "OPEN",
    "AtTime": "2020-07-30T16:18:18Z",
    "NextTransitionTime": "2020-07-31T00:00:00Z"
}

    Os resultados mostram o estado do calendário (se o calendário é do tipo DEFAULT_OPEN ou DEFAULT_CLOSED) para as entradas de calendário especificadas que são propriedade ou compartilhadas com sua conta, na hora especificada como o valor --at-time e a hora da próxima transição. Se você não adicionar o parâmetro --at-time, a hora atual será usada.

    nota

    Se você especificar mais de um calendário em uma solicitação, o comando retornará o status OPEN somente se todos os calendários na solicitação estiverem abertos. Se um ou mais calendários na solicitação forem fechados, o status retornado será CLOSED.