• 2026 年 4 月 30 日之後， AWS Systems Manager CloudWatch Dashboard 將不再可用。客戶可以繼續使用 Amazon CloudWatch 主控台來檢視、建立和管理其 Amazon CloudWatch 儀表板，就像現在一樣。如需詳細資訊，請參閱 [Amazon CloudWatch Dashboard 文件](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。

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

# 取得變更行事曆的狀態
<a name="change-calendar-getstate"></a>

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

**注意**  
如需有關 Change Calendar 與 Amazon EventBridge 整合以自動監控行事曆狀態變更的資訊，請參閱 [Change Calendar 與 Amazon EventBridge 整合](monitoring-systems-manager-event-examples.md#change-calendar-eventbridge-integration)。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`。