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

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

取得變更行事曆的狀態

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

注意

如需Change Calendar與 Amazon EventBridge 整合以自動監控行事曆狀態變更的相關資訊，請參閱 Change Calendar 與 Amazon EventBridge 整合。EventBridge 整合會在行事曆狀態轉換時提供事件驅動的通知，補充 GetCalendarState API 動作的輪詢型方法。

您可以使用 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_OPEN 或 DEFAULT_CLOSED，並且以 --at-time 的值指定時間)，以及下一次轉換的時間。如果您不新增 --at-time 參數，就會使用目前的時間。

    注意

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