• 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)。 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # AWS Systems Manager Change Calendar Change Calendar當您指定的動作 （例如，在 [Systems Manager Automation](systems-manager-automation.md) Runbook 中） 可能會在您的 中執行或不執行時， 中的工具 AWS Systems Manager可讓您設定日期和時間範圍 AWS 帳戶。在 Change Calendar 中，這些範圍稱為「事件」**。當您建立了 Change Calendar 項目，也會建立類型 `ChangeCalendar` 的 [Systems Manager](documents.md) 文件。在 Change Calendar 中，這些文件會以純文字格式儲存 [iCalendar 2.0](https://icalendar.org/) 資料。您新增到 Change Calendar 項目的事件將成為文件的一部份。若要開始使用 Change Calendar，請開啟 [Systems Manager 主控台](https://console.aws.amazon.com//systems-manager/change-calendar)。在導覽窗格中，選擇 **Change Calendar**。 您可以在 Systems Manager 主控台中建立行事曆及其事件。您還可以匯入從支援的第三方行事曆供應商匯出的 iCalendar (`.ics`) 檔案，以將其事件新增到您的行事曆中。支援的供應商包括 Google 行事曆、Microsoft Outlook 和 iCloud 行事曆。 Change Calendar 項目可能為以下兩種類型之一： **`DEFAULT_OPEN`**，或預設開啟 預設情況下 (但行事曆事件期間除外)，所有動作都可以執行。事件進行期間，`DEFAULT_OPEN` 行事曆的狀態為 `CLOSED`，且事件無法執行。 **`DEFAULT_CLOSED`**，或預設關閉。 預設情況下 (但行事曆事件期間除外)，所有動作都無法執行。事件進行期間，`DEFAULT_CLOSED` 行事曆的狀態為 `OPEN`，且動作能夠執行。 您可以選擇將所有已排程的 Automation 工作流程、維護時段和 State Manager 關聯自動新增至行事曆。您也可以從行事曆顯示中移除這些個別類型的任何項。 ## 誰應該使用Change Calendar？ **Change Manager 可用性變更** AWS Systems ManagerChange Manager 自 2025 年 11 月 7 日起，不再向新客戶開放。如果您想要使用 Change Manager，請在該日期之前註冊。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[AWS Systems ManagerChange Manager可用性變更](https://docs.aws.amazon.com/systems-manager/latest/userguide/change-manager-availability-change.html)。 + AWS 執行下列動作類型的客戶： + 建立或執行 Automation 執行手冊。 + 在 Change Manager 中建立變更請求。 + 執行維護時段。 + 在 State Manager 中建立關聯。 自動化、Maintenance Windows、 和 Change ManagerState Manager都是工具 AWS Systems Manager。將這些工具與 Change Calendar 整合，您可以根據每個動作關聯的變更行事曆的目前狀態，允許或封鎖這些動作類型。 + 負責確保 Systems Manager 受管節點組態一致性、穩定性和運作的管理員。 ## Change Calendar 的優點 以下是 Change Calendar 的部分優點。 + **在套用變更前事先檢閱** Change Calendar 項目可協助確保事先檢閱可能破壞環境的變更，再加以套用。 + **僅在適當時機套用變更** Change Calendar 項目可協助確保環境在事件進行期間的穩定性。舉例來說，您可以建立 Change Calendar 項目，以便在您預期有高資源需求 (例如會議或公開行銷期間) 的時候禁止變更。當您預期有管理員支援有限 (例如假期或假日) 時，行事曆項目也可以禁止變更。您可以使用行事曆項目來允許變更，並將管理員支援有限，而不足以針對失敗工作或部署進行故障診斷的特定時段排除。 + **取得目前或即將變更的行事曆狀態** 您可以執行 Systems Manager `GetCalendarState` API 操作來獲得行事曆目前的狀態、指定時間的狀態，或是行事曆已排程變更的下一個狀態。 **注意** `GetCalendarState` API 的配額為每秒 10 個請求。如需有關 Systems Manager 配額的詳細資訊，請參閱 *Amazon Web Services 一般參考* 中的 [Systems Manager service quotas](https://docs.aws.amazon.com/general/latest/gr/ssm.html#limits_ssm)。 + **支援 EventBridge** 此 Systems Manager 工具作為 Amazon EventBridge 規則中的*事件*類型受到支援。如需詳細資訊，請參閱 [使用 Amazon EventBridge 監控 Systems Manager](monitoring-eventbridge-events.md) 及 [參考：Systems Manager 的 Amazon EventBridge 事件模式和類型](reference-eventbridge-events.md)。 **Topics** + [誰應該使用Change Calendar？](#systems-manager-change-calendar-who) + [Change Calendar 的優點](#systems-manager-change-calendar-benefits) + [設定 Change Calendar](systems-manager-change-calendar-prereqs.md) + [使用 Change Calendar](systems-manager-change-calendar-working.md) + [正在新增 Change Calendar 依賴性到自動化 Runbook](systems-manager-change-calendar-automations.md) + [Change Calendar 疑難排解](change-calendar-troubleshooting.md) # 設定 Change Calendar 在 中使用 工具之前Change Calendar，請先完成下列操作 AWS Systems Manager。 ## 安裝最新的命令列工具 安裝最新的命令列工具，以取得與行事曆相關的狀態資訊。 | 需求 | Description | | --- | --- | | AWS CLI | （選用） 若要使用 AWS Command Line Interface (AWS CLI) 取得行事曆的狀態資訊，請在本機 AWS CLI 電腦上安裝最新版本的 。 如需如何安裝或升級 CLI 的詳細資訊，請參閱《[AWS CLI使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html)》中的*安裝、更新和解除安裝AWS Command Line Interface *。 | | AWS Tools for PowerShell | (選用) 若要使用 Tools for PowerShell 取得與行事曆相關的狀態資訊，請在本機電腦上安裝最新版本的 Tools for PowerShell。 如需如何安裝或升級 Tools for PowerShell 的詳細資訊，請參閱《*AWS Tools for PowerShell 使用者指南*》中的[安裝 AWS Tools for PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html)。 | ## 設定許可 如果使用者、群組或角色受獲指派管理員許可，則您可以完整存取 Change Calendar。如果您沒有管理員許可，則管理員必須指派 `AmazonSSMFullAccess` 受管政策或指派提供所需許可的政策給使用者、群組或角色，藉此給予您許可。 使用 Change Calendar 需要以下許可。 **Change Calendar 項目** 若要建立、更新或刪除 Change Calendar 項目 (包含從項目新增或移除事件)，則連接至您的使用者、群組或角色的政策必須允許以下動作。 + `ssm:CreateDocument` + `ssm:DeleteDocument` + `ssm:DescribeDocument` + `ssm:DescribeDocumentPermission` + `ssm:GetCalendar` + `ssm:ListDocuments` + `ssm:ModifyDocumentPermission` + `ssm:PutCalendar` + `ssm:UpdateDocument` + `ssm:UpdateDocumentDefaultVersion` **行事曆狀態** 若要取得目前或即將變更的行事曆狀態，則連接至您的使用者、群組或角色的政策必須允許以下動作。 + `ssm:GetCalendarState` **操作事件** 若要檢視操作事件 (例如維護時段、關聯及計劃的自動化)，連接至您的使用者、群組或角色的政策必須允許以下動作： + `ssm:DescribeMaintenanceWindows` + `ssm:DescribeMaintenanceWindowExecution` + `ssm:DescribeAutomationExecutions` + `ssm:ListAssociations` **注意** 他人擁有 (也就是他人建立) 的 Change Calendar 項目僅供唯讀，即便與您的帳戶分享也是如此。維護時段、State Manager 關聯和自動化不會共用。 # 使用 Change Calendar 您可以使用 AWS Systems Manager 主控台來新增、管理或刪除 Change Calendar (AWS Systems Manager 中的工具) 中的項目。您也可以匯入支援的第三方行事曆供應商的事件，方法是匯入您從來源行事曆匯出的 iCalendar (`.ics`) 檔案。另外，您可以使用 `GetCalendarState` API 操作或 `get-calendar-state` AWS Command Line Interface (AWS CLI) 命令，從而獲取在特定時間的 Change Calendar 相關資訊。 **Topics** + [建立變更行事曆](change-calendar-create.md) + [在 Change Calendar 中建立和管理事件](change-calendar-events.md) + [從第三方行事曆中匯入及管理事件](third-party-events.md) + [更新變更行事曆](change-calendar-update.md) + [共用變更行事曆](change-calendar-share.md) + [刪除變更行事曆](change-calendar-delete.md) + [取得變更行事曆的狀態](change-calendar-getstate.md) # 建立變更行事曆 您在 Change Calendar (AWS Systems Manager 中的工具) 中建立項目時，就是在建立使用 `text` 格式的 Systems Manager 文件 (SSM 文件)。 **若要建立變更行事曆** 1. 開啟位於 AWS Systems Managerhttps://console.aws.amazon.com/systems-manager/ 的主控台。[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/) 1. 在導覽窗格中，選擇 **Change Calendar**。 1. 選擇 **Create calendar (建立行事曆)**。 -或- 如果先開啟 **Change Calendar** 首頁，則選擇 **Create change calendar** (建立變更行事曆)。 1. 在 **Create instance (建立行事曆)** 頁面上的 **Calendar details (行事曆詳細資料)** 中，輸入行事曆項目的名稱。行事曆名稱可包含字母、數字、句點、破折號和底線。請使用足夠特別的名稱，以便迅速辨識行事曆項目的用途。例如，**support-off-hours**。建立行事曆項目後就無法更新此名稱。 1. (選用) 在 **Description** (描述) 中，輸入行事曆項目的描述。 1. (選用) 在 **Import calendar** (匯入行事曆) 區域中，選擇 **Choose file** (選擇檔案)，以選取您從第三方行事曆供應商匯出的 iCalendar (`.ics`) 檔案。匯入檔案會將其事件新增至您的行事曆。 支援的供應商包括 Google 行事曆、Microsoft Outlook 和 iCloud 行事曆。 如需更多詳細資訊，請參閱 [從第三方行事曆供應商匯入事件](change-calendar-import.md)。 1. 在 **Calendar type (行事曆類型)** 中，選擇以下其中一項。 + **Open by default** (預設開啟) - 行事曆會開啟 (事件開始後可執行自動化動作)，接著在相關活動進行期間關閉。 + **Closed by default** (預設關閉) - 行事曆會關閉 (事件開始後可執行自動化動作)，但會在相關活動進行期間開啟。 1. (選用) 在**變更管理事件**中，選取**將變更管理事件新增至行事曆**。此選項會在每月行事曆顯示畫面中顯示所有已排程的維護時段、State Manager 關聯、Automation 工作流程及 Change Manager 變更請求。 **提示** 如果您稍後想要從行事曆顯示中永久移除這些事件類型，請編輯行事曆，取消選取此核取方塊，然後選擇**儲存**。 1. 選擇 **Create calendar (建立行事曆)**。 建立行事曆項目後，Systems Manager 會在 **Change Calendar** 清單中顯示行事曆項目。欄位會顯示行事曆版本和行事曆擁有者的 AWS 帳戶 帳戶編號。除非您至少建立或匯入一個事件，否則行事曆將無法禁止或允許任何動作。如需建立事件的資訊，請參閱 [建立 Change Calendar 事件](change-calendar-create-event.md)。如需匯入事件的相關資訊，請參閱 [從第三方行事曆供應商匯入事件](change-calendar-import.md)。 # 在 Change Calendar 中建立和管理事件 在 中建立行事曆後 AWS Systems Manager Change Calendar，您可以建立、更新和刪除已開啟或已關閉行事曆中包含的事件。 Change Calendar 是 中的工具 AWS Systems Manager。 **提示** 作為直接在 Systems Manager 主控台中建立事件的替代方案，您可以從支援的第三方行事曆應用程式匯入 iCalendar (`.ics`) 檔案。如需相關資訊，請參閱[從第三方行事曆中匯入及管理事件](third-party-events.md)。 **Topics** + [建立 Change Calendar 事件](change-calendar-create-event.md) + [更新 Change Calendar 事件](change-calendar-update-event.md) + [刪除Change Calendar事件](change-calendar-delete-event.md) # 建立 Change Calendar 事件 當您將事件新增至 Change Calendar (AWS Systems Manager 中的工具) 中的項目時，就會指定行事曆項目預設動作暫停的時段。舉例來說，如果行事曆項目類型預設為關閉，則行事曆會在事件進行期間開放變更。(您也可以建立建議事件，其僅在行事曆上發揮提供資訊的作用。) 目前您只能使用主控台來建立 Change Calendar 事件。事件會新增到您在建立 Change Calendar 項目時所建立的 Change Calendar 文件。 **若要建立 Change Calendar 事件** 1. 開啟位於 AWS Systems Managerhttps://console.aws.amazon.com/systems-manager/ 的主控台。[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/) 1. 在導覽窗格中，選擇 **Change Calendar**。 1. 在行事曆清單中，請為您要新增事件的行事曆項目選擇名稱。 1. 在行事曆項目的詳細資料頁面上選擇 **Create event (建立事件)**。 1. 在 **Create scheduled event (建立排程事件)** 頁面的 **Event details (事件詳細資料)** 中，輸入事件的顯示名稱。事件名稱可包含字母、數字、句點、破折號和底線。請使用足夠特別的名稱，以便辨識事件的用途。例如，**nighttime-hours**。 1. 在 **Description** (描述) 中，輸入事件的描述。例如 **The support team isn't available during these hours**。 1. (選用) 如果希望此事件僅用作視覺通知或提醒，可選取 **Advisory** (建議) 核取方塊。建議事件不會在行事曆上發揮任何作用，僅為檢視行事曆的使用者提供資訊。 1. 在 **Event start date** (事件開始日期) 中，以 `MM/DD/YYYY` 格式輸入或選擇事件的開始日期，再以 `hh:mm:ss` (時分秒) 格式輸入指定日期的時間作為事件的開始時間。 1. 在 **Event end date** (事件結束日期) 中，以 `MM/DD/YYYY` 格式輸入或選擇事件的結束日期，再以 `hh:mm:ss` (時分秒) 格式輸入指定日期的時間作為事件的結束時間。 1. 在 **Schedule time zone** (排程時區) 中，選擇事件開始和結束時間適用的時區。您可以輸入城市的部分名稱，或是格林威治標準時間 (GMT) 以外的時區，以便更快找到時區。預設值是國際標準時間 (UTC)。 1. (選用) 如果要建立每天、每週或每月循環發生的事件，請開啟 **Recurrence** (循環)，然後指定循環的頻率和選用的結束日期。 1. 選擇 **Create scheduled event (建立排程事件)**。新的事件會新增到您的行事曆項目，且會顯示在行事曆項目詳細資料頁面的 **Events (事件)** 標籤上。 # 更新 Change Calendar 事件 使用下列程序更新 AWS Systems Manager 主控台中的 Change Calendar 事件。Change Calendar 是 AWS Systems Manager 中的工具。 **若要更新 Change Calendar 事件** 1. 開啟位於 AWS Systems Managerhttps://console.aws.amazon.com/systems-manager/ 的主控台。[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/) 1. 在導覽窗格中，選擇 **Change Calendar**。 1. 在行事曆清單中，請為您要編輯事件的行事曆項目選擇名稱。 1. 在行事曆項目的詳細資料頁面上選擇 **Events (事件)**。 1. 在行事曆頁面中選擇您要編輯的事件。 **提示** 使用左上角的按鈕來往後或往前一年，或是往後或往前一個月。如果有需要，可以從右上角的清單選擇正確的時區來變更時區。 1. 在 **Event details** (事件詳細資訊) 中選擇 **Edit** (編輯)。 若要變更事件名稱和描述，請新增或替換目前文字值。 1. 若要變更 **Event start date** (事件開始日期) 值，請選擇目前開始日期，然後從行事曆中選擇一個新日期。若要變更開始時間，請選擇目前開始時間，然後從清單中選擇一個新時間。 1. 若要變更 **Event end date** (事件結束日期) 值，請選擇目前日期，然後從行事曆中選擇一個新的結束日期。若要變更結束時間，請選擇目前結束時間，然後從清單中選擇一個新時間。 1. 若要變更 **Schedule time zone** (排程時區) 值，請選擇事件開始和結束時間適用的時區。您可以輸入城市的部分名稱，或是格林威治標準時間 (GMT) 以外的時區，以便更快找到時區。預設值是國際標準時間 (UTC)。 1. (選用) 如果希望此事件僅用作視覺通知或提醒，可選取 **Advisory** (建議) 核取方塊。建議事件不會在行事曆上發揮任何作用，僅為檢視行事曆的使用者提供資訊。 1. 選擇**儲存**。您的變更會顯示在行事曆項目詳細資料頁面的 **Events (事件)** 標籤上。選擇您更新的事件來檢視變更。 # 刪除Change Calendar事件 您可以使用 AWS 管理主控台在 Change Calendar (AWS Systems Manager 中的工具) 中逐一刪除事件。 **提示** 如果您在建立行事曆時選取了**將變更管理事件新增至行事曆**，您可以執行下列動作： 若要*暫時*隱藏行事曆顯示中的某個變更管理事件類型，請在每月預覽最上方針對該類型選擇 **X**。 若要從行事曆顯示中*永久*移除這些類型，請編輯行事曆，取消選取**將變更管理事件新增至行事曆**核取方塊，然後選擇**儲存**。從行事曆顯示中移除類型並不會將其從您的帳戶中刪除。 **若要刪除 Change Calendar 事件** 1. 開啟位於 AWS Systems Managerhttps://console.aws.amazon.com/systems-manager/ 的主控台。[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/) 1. 在導覽窗格中，選擇 **Change Calendar**。 1. 在行事曆清單中，請選擇您要從中刪除事件的行事曆項目名稱。 1. 在行事曆項目的詳細資料頁面上選擇 **Events (事件)**。 1. 在行事曆頁面中選擇您要刪除的事件。 **提示** 使用左上角的按鈕來將行事曆往後或往前一年，或是往後或往前一個月。如果有需要，可以從右上角的清單選擇正確的時區來變更時區。 1. 在 **Event details (事件詳細資料)** 頁面上，選擇 **Delete (刪除)**。當系統提示您確認是否要刪除事件時，請選擇 **Confirm** (確認)。 # 從第三方行事曆中匯入及管理事件 除了直接在 AWS Systems Manager 主控台中建立事件外，您也可以從支援的第三方行事曆應用程式匯入 iCalendar (`.ics`) 檔案。您的行事曆可以同時包含匯入的事件和您在 Change Calendar ( AWS Systems Manager中的工具) 中建立的事件。 **開始之前** 在您嘗試匯入行事曆檔案之前，請先檢閱以下要求與限制： 行事曆檔案格式 僅支援有效的 iCalendar 檔案 (`.ics`)。 支援的行事曆供應商 僅支援從下列第三方行事曆供應商匯出的`.ics`檔案： + Google 行事曆 ([匯出指示](https://support.google.com/calendar/answer/37111)) + Microsoft Outlook ([匯出指示](https://support.microsoft.com/en-us/office/export-an-outlook-calendar-to-google-calendar-662fa3bb-0794-4b18-add8-9968b665f4e6)) + iCloud 行事曆 ([匯出指示](https://support.apple.com/guide/calendar/import-or-export-calendars-icl1023/mac)) 檔案大小 您可以匯入任意數量的有效 `.ics` 檔案。不過，每個行事曆的所有匯入檔案大小總計不得超過 64KB。 若要將 `.ics` 檔案的大小減至最小，請確定您只匯出行事曆項目的基本詳細資訊。必要時，請縮短要匯出的時間長度。 時區 除了行事曆名稱、行事曆供應商和至少一個事件之外，您匯出的 `.ics` 檔案也應指出行事曆的時區。如果沒有，或是識別時區時發生問題，系統會在匯入檔案後提示您指定時區。 重複事件限制 匯出的 `.ics` 檔案可以包含重複事件。不過，如果在來源行事曆中刪除重複事件的一個或多個事件，匯入就會失敗。 **Topics** + [從第三方行事曆供應商匯入事件](change-calendar-import.md) + [從第三方行事曆供應商更新所有事件](change-calendar-import-add-remove.md) + [刪除從第三方行事曆匯入的所有事件](change-calendar-delete-ics.md) # 從第三方行事曆供應商匯入事件 使用以下程序可從支援的第三方行事曆應用程式匯入 iCalendar (`.ics`) 檔案。檔案中包含的事件會納入開啟或關閉行事曆的規則中。您可以將檔案匯入到您正在使用 Change Calendar ( AWS Systems Manager中的工具) 建立的新行事曆或現有的行事曆。 匯入 `.ics` 檔案之後，您可以使用 Change Calendar 介面從其中移除個別事件。如需相關資訊，請參閱[刪除Change Calendar事件](change-calendar-delete-event.md)。您也可以透過刪除 `.ics` 檔案，來刪除來源行事曆中的所有事件。如需相關資訊，請參閱[刪除從第三方行事曆匯入的所有事件](change-calendar-delete-ics.md)。 **若要從第三方行事曆供應商匯入事件** 1. 在 https：//[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/) 開啟 AWS Systems Manager 主控台。 1. 在導覽窗格中，選擇 **Change Calendar**。 1. 若要從新的行事曆開始，請選擇 **Create calendar** (建立行事曆)。在 **Import calendar** (匯入行事曆) 區域中，選擇 **Choose file** (選擇檔案)。如需有關建立新行事曆的其他步驟的資訊，請參閱 [建立變更行事曆](change-calendar-create.md)。 -或- 若要將第三方事件匯入現有的行事曆，請選擇現有行事曆的名稱加以開啟。 1. 選擇 **Actions, Edit** (動作：編輯)，然後在 **Import calendar** (匯入行事曆) 區域中選擇 **Choose file** (選擇檔案)。 1. 導覽並選取本機電腦上匯出的 `.ics` 檔案。 1. 如果出現提示，對於 **Select a time zone** (選取時區)，選取要套用至行事曆的時區。 1. 選擇**儲存**。 # 從第三方行事曆供應商更新所有事件 如果在您匯入其 iCalendar `.ics` 檔案之後，將多個事件新增至來源行事曆或從來源行事曆中移除事件，則您可以在 Change Calendar 中反映這些變更。首先，重新匯出來源行事曆，然後將新檔案匯入到 Change Calendar ( AWS Systems Manager中的工具)。變更行事曆中的事件將會更新，以反映較新檔案的內容。 **若要從第三方行事曆供應商更新所有事件** 1. 在您的第三方行事曆中，新增或移除您想要反映在 Change Calendar 中的事件，然後再將行事曆重新匯出至新的 `.ics` 檔案。 1. 在 https：//[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/) 開啟 AWS Systems Manager 主控台。 1. 在導覽窗格中，選擇 **Change Calendar**。 1. 從行事曆清單中，從清單中選擇行事曆名稱。 1. 選擇**選擇檔案**，然後導覽並選取替代 `.ics` 檔案。 1. 若要回應有關覆寫現有檔案的通知，請選擇 **Confirm** (確認)。 # 刪除從第三方行事曆匯入的所有事件 如果您不再希望從第三方供應商匯入的任何事件包含在行事曆中，您可以刪除已匯入的 iCalendar `.ics` 檔案。 **若要刪除從第三方行事曆匯入的所有事件** 1. 在 https：//[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/) 開啟 AWS Systems Manager 主控台。 1. 在導覽窗格中，選擇 **Change Calendar**。 1. 從行事曆清單中，從清單中選擇行事曆名稱。 1. 在 **Import calendar** (匯入行事曆) 區域中的 **My imported calendars** (我匯入的行事曆)，找出匯入行事曆的名稱，然後選擇卡上的 **X**。 1. 選擇**儲存**。 # 更新變更行事曆 您可以更新變更行事曆的描述，但無法更新其名稱。您雖然可以變更行事曆的預設狀態，但是請注意，這會使行事曆相關事件進行期間的變更動作行為發生反轉。舉例來說，如果您將行事曆的狀態從 **Open by default** (預設開啟) 變更為 **Closed by default** (預設關閉)，那麼如果有建立相關事件的使用者不知道變更，就可能做出不必要的變更。 您更新變更行事曆時，就是在編輯您在建立項目時所建立的 Change Calendar 文件。Change Calendar 是 AWS Systems Manager 中的工具。 **若要更新變更行事曆** 1. 開啟位於 AWS Systems Managerhttps://console.aws.amazon.com/systems-manager/ 的主控台。[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/) 1. 在導覽窗格中，選擇 **Change Calendar**。 1. 在行事曆清單中，請選擇您要更新的行事曆名稱。 1. 在行事曆的詳細資訊頁面上，選擇 **Actions, Edit** (動作：編輯)。 1. 您可以在 **Description (描述)** 中變更描述文字。您無法編輯變更行事曆的名稱。 1. 如果要變更行事曆狀態，請在 **Calendar type (行事曆類型)** 中選擇其他值。請注意，這會使行事曆相關事件進行期間的變更動作行為發生反轉。變更行事曆類型之前，您應該和其他 Change Calendar 使用者確認變更行事曆類型並不會在他們所建立的活動進行時出現不必要的變更。 + **Open by default** (預設開啟) - 行事曆會開啟 (事件開始後可執行自動化動作)，接著在相關活動進行期間關閉。 + **Closed by default** (預設關閉) - 行事曆會關閉 (事件開始後可執行自動化動作)，但會在相關活動進行期間開啟。 1. 選擇**儲存**。 除非您至少新增一個事件，否則行事曆將無法禁止或允許任何動作。如需有關如何新增事件的資訊，請參閱[建立 Change Calendar 事件](change-calendar-create-event.md)。 # 共用變更行事曆 透過使用 AWS Systems Manager 主控台，您可以在 Change Calendar (AWS Systems Manager 中的工具) 中與其他 AWS 帳戶共用行事曆。共用行事曆時，行事曆僅供共用帳戶內的使用者唯讀。維護時段、State Manager 關聯和自動化不會共用。 **若要共用變更行事曆** 1. 開啟位於 AWS Systems Managerhttps://console.aws.amazon.com/systems-manager/ 的主控台。[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/) 1. 在導覽窗格中，選擇 **Change Calendar**。 1. 在行事曆清單中，請選擇您要共用的行事曆名稱。 1. 在行事曆的詳細資訊頁面上，選擇 **Share** (共用) 索引標籤。 1. 選擇 **Actions, Share** (動作：共用)。 1. 在 **Share calendar** (共用行事曆) 中，針對 **Account ID** (帳戶 ID)，輸入有效 AWS 帳戶 的 ID 編號，然後選擇 **Share** (共用)。 共用帳戶的使用者可以讀取變更行事曆，但無法進行變更。 # 刪除變更行事曆 您可以透過使用 Systems Manager 主控台或 AWS Command Line Interface (AWS CLI)，刪除 Change Calendar (AWS Systems Manager 中的工具) 中的行事曆。刪除變更行事曆也會刪除所有相關事件。 **若要刪除變更行事曆** 1. 開啟位於 AWS Systems Managerhttps://console.aws.amazon.com/systems-manager/ 的主控台。[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/) 1. 在導覽窗格中，選擇 **Change Calendar**。 1. 在行事曆清單中，請選擇您要刪除的行事曆名稱。 1. 在行事曆的詳細資訊頁面上，選擇 **Actions, Delete** (動作：刪除)。當系統提示您確認是否要刪除行事曆時，請選擇 **Delete** (刪除)。 # 取得變更行事曆的狀態 您可以在 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`。 # 正在新增 Change Calendar 依賴性到自動化 Runbook 若要讓自動化動作遵循 Change Calendar中的工具 AWS Systems Manager，請在使用 [`aws:assertAwsResourceProperty`](automation-action-assertAwsResourceProperty.md)動作的 Automation Runbook 中新增步驟。設定要執行 `GetCalendarState` 的動作，來驗證指定的行事曆項目是否處於您希望的狀態 (`OPEN` 或 `CLOSED`)。只有在行事曆狀態為 `OPEN` 時，自動化 Runbook 才可以繼續進行下一個步驟。下列內容是 YAML 的範例摘錄，其中的自動化 Runbook 無法繼續進行下一個步驟 (`LaunchInstance`)，除非行事曆狀態符合 `DesiredValues` 中指定的 `OPEN` 行事曆狀態才可以。 下列是 範例。 ``` mainSteps: - name: MyCheckCalendarStateStep action: 'aws:assertAwsResourceProperty' inputs: Service: ssm Api: GetCalendarState CalendarNames: ["arn:aws:ssm:us-east-2:123456789012:document/SaleDays"] PropertySelector: '$.State' DesiredValues: - OPEN description: "Use GetCalendarState to determine whether a calendar is open or closed." nextStep: LaunchInstance - name: LaunchInstance action: 'aws:executeScript' inputs: Runtime: python3.11 ... ``` # Change Calendar 疑難排解 使用下列資訊以協助您對 Change Calendar ( AWS Systems Manager中的工具) 的問題進行疑難排解。 **Topics** + ['Calendar import failed' ('行事曆匯入失敗') 錯誤](#change-manager-troubleshooting-1) ## 'Calendar import failed' ('行事曆匯入失敗') 錯誤 **問題**：當匯入 iCalendar (`.ics`) 檔案時，系統會報告行事曆匯入失敗。 + **解決方案 1** – 確定您正在匯入從支援的第三方行事曆供應商匯出的檔案，其中包括下列各項： + Google 行事曆 ([匯出指示](https://support.google.com/calendar/answer/37111)) + Microsoft Outlook ([匯出指示](https://support.microsoft.com/en-us/office/export-an-outlook-calendar-to-google-calendar-662fa3bb-0794-4b18-add8-9968b665f4e6)) + iCloud 行事曆 ([匯出指示](https://support.apple.com/guide/calendar/import-or-export-calendars-icl1023/mac)) + **解決方案 2** – 如果您的來源行事曆包含任何重複事件，請確定未取消或刪除任何個別事件。目前，Change Calendar 不支援匯入具有個別取消的重複事件。若要解決這個問題，請從來源行事曆中移除重複事件、重新匯出行事曆並將它重新匯入 Change Calendar，然後使用 Change Calendar 介面新增重複事件。如需相關資訊，請參閱[建立 Change Calendar 事件](change-calendar-create-event.md)。 + **解決方案 3** – 確定您的來源行事曆包含至少一個事件。上傳不包含事件的 `.ics` 檔案不會成功。 + **解決方案 4** – 如果系統報告，因為 `.ics` 太大而匯入失敗，則請確定您只匯出行事曆項目的基本詳細資訊。必要時，請縮短您匯出的時間段長度。 + **解決方案 5** – 如果當您嘗試從 **Events** (事件) 標籤匯入時，Change Calendar 無法判斷匯出的行事曆的時區，您可能會收到此訊息："Calendar import failed. Change Calendar couldn't locate a valid time zone。You can import the calendar from the Edit menu." (行事曆匯入失敗。Change Calendar 無法找到有效時區。您可以從編輯選單中匯入行事曆。) 在此情況下，請依次選擇 **Actions, Edit** (動作、編輯)，然後嘗試從 **Edit calendar** (編輯行事曆) 頁面匯入檔案。 + **解決方案 6** – 請勿在匯入之前編輯 `.ics` 檔案。嘗試修改檔案內容可能會損毀行事曆資料。如果您在嘗試匯入之前已修改檔案，請再次從來源行事曆匯出行事曆，然後重新嘗試上傳。