Abrufen des Status eines Änderungskalenders - AWS Systems Manager

AWS Systems ManagerChange Managersteht neuen Kunden nicht mehr offen. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Änderung der AWS Systems ManagerChange Manager Verfügbarkeit.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Abrufen des Status eines Änderungskalenders

Sie können den Gesamtzustand eines Kalenders oder den Zustand eines Kalenders zu einem bestimmten Zeitpunkt in Change Calendar abrufen, einem Tool in AWS Systems Manager. Sie können auch den nächsten Zeitpunkt anzeigen, an dem der Kalenderzustand von OPEN auf CLOSED oder umgekehrt wechselt.

Anmerkung

Informationen zur Integration von Change Calendar in Amazon EventBridge zur automatisierten Überwachung von Kalenderstatusänderungen finden Sie unter Change CalendarIntegration mit Amazon EventBridge. Die EventBridge-Integration bietet ereignisgesteuerte Benachrichtigungen, wenn sich Kalenderstatus ändern, und ergänzt so den abfragebasierten Ansatz der API-Aktion GetCalendarState.

Diese Aufgabe können Sie nur mit der GetCalendarState-API-Operation ausführen. Die Prozedur in diesem Abschnitt verwendet die AWS Command Line Interface (AWS CLI).

So rufen Sie den Status eines Änderungskalenders ab

  • Führen Sie den folgenden Befehl aus, um den Status eines oder mehrerer Kalender zu einer bestimmten Zeit anzuzeigen. Der Parameter --calendar-names ist erforderlich, --at-time ist jedoch optional. Ersetzen Sie jeden Beispiel Platzhalter für Ressourcen mit Ihren eigenen Informationen.

    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"

    Im Folgenden wird ein Beispiel gezeigt.

    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"

    Im Folgenden wird ein Beispiel gezeigt.

    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"

    Der Befehl gibt Informationen wie die folgenden zurück.

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

    Die Ergebnisse zeigen den Status des Kalenders (unabhängig davon, ob der Kalender vom Typ DEFAULT_OPEN oder DEFAULT_CLOSED ist) für die angegebenen Kalendereinträge, die Ihrem Konto gehören oder für dieses freigegeben sind, zu dem Zeitpunkt an, der als Wert von --at-time angegeben ist, sowie den Zeitpunkt des nächsten Übergangs. Wenn Sie den Parameter --at-time nicht hinzufügen, wird die aktuelle Zeit verwendet.

    Anmerkung

    Wenn Sie mehr als einen Kalender in einer Anforderung angeben, gibt der Befehl den Status von OPEN nur, wenn alle Kalender in der Anforderung geöffnet sind. Wenn ein oder mehrere Kalender in der Anforderung geschlossen sind, lautet der zurückgegebene Status CLOSED.