取得變更行事曆的狀態 - AWS Systems Manager

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

取得變更行事曆的狀態

您可以在 Change Calendar (AWS Systems Manager 的功能) 中,取得行事曆的整體狀態,或特定時間的行事曆狀態。您也可以取得下次行事曆狀態從 OPEN 變更為 CLOSED 的時間,反之亦然。

您可以使用 GetCalendarState API 操作來執行這項任務。本節中的程序使用了 AWS Command Line Interface (AWS CLI)。

若要取得變更行事曆的狀態
  • 請執行以下命令,來取得一或多個行事曆在特定時間的狀態。--calendar-names 參數是必要項目,--at-time 則為選用參數。將每個範例資源預留位置取代為您自己的資訊。

    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"

    以下是範例。

    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"

    以下是範例。

    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"

    該命令會傳回相關資訊,如以下所示。

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

    結果會顯示您帳戶擁有 (或與您帳戶共用) 的行事曆狀態 (行事曆類型為 DEFAULT_OPENDEFAULT_CLOSED,並且以 --at-time 的值指定時間),以及下一次轉換的時間。如果您不新增 --at-time 參數,就會使用目前的時間。

    注意

    如果您在請求中指定多個行事曆,此命令僅會在請求中的所有行事曆均開啟的情況下傳回 OPEN 的狀態。如果請求中的一或多個行事曆已關閉,則傳回的狀態為 CLOSED