• O AWS Systems Manager CloudWatch Dashboard não estará mais disponível a partir de 30 de abril de 2026. Os clientes podem continuar usando o console do Amazon CloudWatch para visualizar, criar e gerenciar os painéis do Amazon CloudWatch exatamente como fazem hoje. Para obter mais informações, consulte a [documentação do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

# Obter o estado de um calendário de alterações
<a name="change-calendar-getstate"></a>

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](monitoring-systems-manager-event-examples.md#change-calendar-eventbridge-integration). 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`.