Abrufen des Status eines Änderungskalenders

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

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.