• El panel de AWS Systems Manager CloudWatch dejará de estar disponible después del 30 de abril de 2026. Los clientes pueden seguir utilizando la consola de Amazon CloudWatch para ver, crear y administrar sus paneles de Amazon CloudWatch, tal y como lo hacen actualmente. Para obtener más información, consulte la [documentación del panel de Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

# Obtención del estado de un calendario de cambios
<a name="change-calendar-getstate"></a>

Puede obtener el estado general de un calendario o el estado de un calendario en un momento específico en Change Calendar, una herramienta de AWS Systems Manager. También puede mostrar la próxima vez que el estado del calendario va a cambiar de `OPEN` a `CLOSED`, o a la inversa.

**nota**  
Para obtener información sobre la integración de Change Calendar en Amazon EventBridge para la supervisión automática de los cambios de estado del calendario, consulte [Integración de Change Calendar en Amazon Eventbridge](monitoring-systems-manager-event-examples.md#change-calendar-eventbridge-integration). La integración de EventBridge proporciona notificaciones basadas en eventos cuando los estados del calendario cambian, lo que complementa el enfoque basado en sondeos de la acción de la API `GetCalendarState`.

Esta tarea solo se puede realizar mediante la operación `GetCalendarState` de la API. En el procedimiento de esta sección se utiliza la AWS Command Line Interface (AWS CLI).

**Para obtener el estado de un calendario de cambios**
+ Ejecute el siguiente comando para mostrar el estado de uno o más calendarios en un momento específico. El parámetro `--calendar-names` es obligatorio, pero `--at-time` es opcional. Reemplace cada *example resource placeholder* con su propia información.

------
#### [ 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"
  ```

  A continuación se muestra un ejemplo.

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

  A continuación se muestra un ejemplo.

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

------

  El comando devuelve información similar a la siguiente.

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

  Los resultados muestran el estado del calendario (si el calendario es de tipo `DEFAULT_OPEN` o `DEFAULT_CLOSED`) de las entradas de calendario especificadas que son propiedad de la cuenta o compartidas con ella, en el momento especificado como valor de `--at-time`, así como en el momento de la siguiente transición. Si no agrega el parámetro `--at-time`, se utiliza la hora actual.
**nota**  
Si especifica más de un calendario en una solicitud, el comando regresa el estado `OPEN` solo si todos los calendarios de la solicitud están abiertos. Si se cierran uno o más calendarios de la solicitud, el estado regresado es `CLOSED`.