Obtención del estado de un calendario de cambios - AWS Systems Manager

• Change Manager de AWS Systems Manager ya no está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte Cambio en la disponibilidad de Change Manager de AWS Systems Manager.

 

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

Obtención del estado de un calendario de cambios

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