• AWS Systems Manager CloudWatch ダッシュボードは、2026 年 4 月 30 日以降は利用できなくなります。お客様は、これまでと同様に Amazon CloudWatch コンソールを使用して、Amazon CloudWatch ダッシュボードの表示、作成、管理を継続できます。詳細については、「[Amazon CloudWatch ダッシュボードのドキュメント](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)」を参照してください。
# AWS Systems Manager Change Calendar
AWS Systems Manager のツールである Change Calendar では、指定したアクション ([Systems Manager Automation](systems-manager-automation.md) ランブックなど) が 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 エントリは、次の 2 つのタイプのいずれかになります。
**`DEFAULT_OPEN`**、またはデフォルトでオープン
カレンダーイベント中を除き、デフォルトですべてのアクションの実行が可能です。イベント中、`DEFAULT_OPEN` カレンダーの状態は `CLOSED` となり、イベントの実行がブロックされます。
**`DEFAULT_CLOSED`**、またはデフォルトでクローズ
カレンダーイベント中を除き、すべてのアクションがデフォルトでブロックされます。イベント中、`DEFAULT_CLOSED` カレンダーの状態は `OPEN` となり、アクションの実行が許可されます。
スケジュールされたすべての自動化ワークフロー、メンテナンスウィンドウ、および State Manager の関連付けをカレンダーに自動的に追加するように選択できます。また、これらのそれぞれのタイプをカレンダー表示から削除することもできます。
## Change Calendar はどのようなユーザーに適していますか?
**Change Manager の可用性の変更**
AWS Systems ManagerChange Manager は、2025 年 11 月 7 日以降、新規のお客様の受付を終了します。Change Manager を使用する場合は、その日付の前にサインアップしてください。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[AWS Systems Manager Change Manager の可用性の変更](https://docs.aws.amazon.com/systems-manager/latest/userguide/change-manager-availability-change.html)」を参照してください。
+ 次のアクションタイプを実行する AWS の顧客:
+ 自動化ランブックを作成または実行します。
+ Change Manager で変更リクエストを作成します。
+ メンテナンスウィンドウを実行します。
+ State Manager で関連付けを作成します。
Automation、Change Manager、Maintenance Windows、State Manager はすべて AWS Systems Manager のツールです。これらのツールを Change Calendar と統合することにより、それぞれに関連付ける変更カレンダーの現在の状態に応じて、これらのアクションタイプを許可またはブロックできます。
+ Systems Manager マネージドノードの設定の一貫性、安定性、機能性を維持する管理者。
## Change Calendar の利点
Change Calendar には次のような利点があります。
+ **変更を適用する前に確認する**
Change Calendar エントリを使用すると、環境に破壊的な影響を及ぼす可能性のある変更を適用する前に確認できます。
+ **適切な時間帯にのみ変更を適用する**
Change Calendar エントリを使用すると、イベント期間中に環境を安定に維持できます。たとえば、カンファレンスや公開マーケティングのプロモーションなど、リソースに対する需要が高くなると予想される期間に変更をブロックする Change Calendar エントリを作成できます。カレンダーエントリは、休暇中や祝日中など、管理者サポートが制限されると予想される期間に変更をブロックすることもできます。カレンダーエントリを使用すると、失敗したアクションやデプロイのトラブルシューティングを行うための管理者サポートが制限されている時間以外の、特定の時間帯以外の変更を許可できます。
+ **カレンダーの現在または今後の状態を取得する**
Systems Manager `GetCalendarState` API オペレーションを実行して、カレンダーの現在の状態、指定した時刻の状態、次にカレンダーの状態が変更されるようにスケジュールされている時刻を表示できます。
**注記**
`GetCalendarState` API には、1 秒あたり 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)
+ [Automation ランブックへの Change Calendar の依存関係の追加](systems-manager-change-calendar-automations.md)
+ [Change Calendar のトラブルシューティング](change-calendar-troubleshooting.md)
# Change Calendar を設定する
AWS Systems Manager のツールである Change Calendar を使用する前に、以下を完了してください。
## 最新のコマンドラインツールをインストールする
最新のコマンドラインツールをインストールして、カレンダーに関する状態情報を取得します。
| 要件 | 説明 |
| --- | --- |
| AWS CLI | (オプション) AWS Command Line Interface (AWS CLI) を使用してカレンダーに関する状態情報を取得するには、AWS CLI の最新リリースをローカルコンピュータにインストールします。 CLI をインストールまたはアップグレードする方法の詳細については、*AWS Command Line Interface ユーザーガイド*の「[AWS CLI のインストール、更新、アンインストール](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html)」を参照してください。 |
| 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 の作成](change-calendar-create.md)
+ [Change Calendar でのイベントの作成と管理](change-calendar-events.md)
+ [サードパーティーのカレンダーからのイベントのインポートと管理](third-party-events.md)
+ [Change Calendar の更新](change-calendar-update.md)
+ [Change Calendar の共有](change-calendar-share.md)
+ [Change Calendar の削除](change-calendar-delete.md)
+ [Change Calendar の状態の取得](change-calendar-getstate.md)
# Change Calendar の作成
AWS Systems Manager のツールである Change Calendar でエントリを作成すると、`text` 形式を使用する Systems Manager ドキュメント (SSM ドキュメント) が作成されます。
**Change Calendar を作成するには**
1. AWS 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 calendar (カレンダーの作成)**] ページの [**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 (デフォルトでオープン)**] - カレンダーはオープン (Automation アクションはイベントが開始するまで実行可能) で、関連付けられたイベントの期間中はクローズになります。
+ [**Closed by default (デフォルトでクローズ)**] - カレンダーはクローズ (Automation アクションはイベントが開始されるまで実行不可) で、関連付けられたイベントの期間中はオープンになります。
1. (オプション) **[変更管理イベント]** で、**[変更管理イベントをカレンダーに追加]** を選択します。これを選択すると、毎月のカレンダー表示に、予定されているメンテナンスウィンドウ、State Manager の関連付け、自動化ワークフロー、Change Manager 変更リクエストがすべて表示されます。
**ヒント**
後でこれらのイベントタイプをカレンダー表示から完全に削除する場合は、カレンダーを編集してこのチェックボックスをオフにして、**[保存]** を選択します。
1. [**Create calendar (カレンダーの作成)**] を選択します。
カレンダーエントリが作成されると、Systems Manager は、**Change Calendar** の一覧にカレンダーエントリを表示します。列には、カレンダーのバージョンとカレンダーの所有者の AWS アカウント 番号が表示されます。少なくとも 1 つのイベントを作成するかインポートするまでは、カレンダーエントリでアクションを禁止または許可することはできません。イベント作成の詳細については、「[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 イベントの作成
AWS Systems Manager のツールである Change Calendar のエントリにイベントを追加すると、カレンダーエントリのデフォルトのアクションが中断される期間を指定することができます。たとえば、カレンダーエントリの種類がデフォルトでクローズの場合、カレンダーはイベント中に変更に対してオープンになります。(または、カレンダー上のみで情報ロールを提供する、アドバイザリイベントを作成することもできます。)
現在は、コンソールを使用して作成できるのは、Change Calendar イベントのみです。イベントは、Change Calendar エントリの作成時に作成する Change Calendar ドキュメントに追加されます。
**Change Calendar イベントを作成するには**
1. AWS 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 Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[Change Calendar]** を選択します。
1. カレンダーのリストから、イベントを編集するカレンダーエントリの名前を選択します。
1. カレンダーエントリの詳細ページで、[**Events (イベント)**] を選択します。
1. カレンダーページで、編集するイベントを選択します。
**ヒント**
左上のボタンを使用すると、1 年前後に移動したり、1 か月前後に移動したりできます。タイムゾーンの変更が必要な場合は、右上リストから適切なタイムゾーンを選択します。
1. **[Event details]** (イベントの詳細) で **[Edit]** (編集) をクリックします。
イベントの名前と説明を変更するには、現在のテキスト値に追加するか、その値を置き換えます。
1. **[Event start date]** (イベント開始日) の値を変更するには、現在の開始日を選択した上で、カレンダーから新しい日付を選択します。開始時刻を変更するには、現在の開始時刻を選択した上で、リストから新しい時刻を選択します。
1. **[Event end date]** (イベント終了日) の値を変更するには、現在の日付を選択した上で、カレンダーから新しい終了日を選択します。終了時刻を変更するには、現在の終了時刻を選択した上で、リストから新しい時刻を選択します。
1. **[Schedule time zone]** (タイムゾーンのスケジュール) の値を変更するには、イベントの開始時刻と終了時刻が適用されるタイムゾーンを選択します。都市名の一部またはグリニッジ標準時 (GMT) とのタイムゾーンの差を入力すると、タイムゾーンをすばやく検索できます。デフォルトは協定世界時 (UTC) です。
1. (オプション) このイベントを、視覚的な通知やリマインダーとしてのみ使用する場合は、**[Advisory]** (アドバイザリ) チェックボックスをオンにします。アドバイザリーイベントには、カレンダー上での機能はありません。これらは、カレンダーを表示しているユーザーに情報を提供するためだけのものです。
1. [**Save**] を選択します。変更内容は、カレンダーエントリの詳細ページの [**Events (イベント)**] タブに表示されます。更新したイベントを選択して、変更を表示します。
# Change Calendar イベントの削除
AWS マネジメントコンソールを使用して、AWS Systems Manager のツールである Change Calendar で一度にひとつずつイベントを削除できます。
**ヒント**
カレンダーの作成時に **[変更管理イベントをカレンダーに追加]** を選択した場合は、次の操作を実行できます。
変更管理イベントタイプをカレンダー表示から「一時的に」非表示にするには、月次プレビューの上部でタイプの **[X]** を選択します。
これらのタイプをカレンダー表示から「完全に」削除するには、カレンダーを編集し、**[カレンダーに変更管理イベントを追加]** チェックボックスをオフにして、**[保存]** を選択します。カレンダー表示からタイプを削除しても、アカウントからは削除されません。
**Change Calendar イベントを削除するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[Change Calendar]** を選択します。
1. カレンダーのリストから、イベントを削除するカレンダーエントリの名前を選択します。
1. カレンダーエントリの詳細ページで、[**Events (イベント)**] を選択します。
1. カレンダーページで、削除するイベントを選択します。
**ヒント**
左上のボタンを使用して、カレンダーを 1 年前後に移動したり、1 か月前後に移動したりできます。タイムゾーンの変更が必要な場合は、右上リストから適切なタイムゾーンを選択します。
1. [**Event details (イベント詳細)**] ページで、[**Delete (削除)**] を選択します。イベントの削除を確認するプロンプトが表示されたら、**[Confirm]** (確認) をクリックします。
# サードパーティーのカレンダーからのイベントのインポートと管理
イベントを直接 AWS Systems Manager コンソールで作成する代わりに、サポートされているサードパーティーのカレンダーアプリケーションから iCalendar (`.ics`) ファイルをインポートできます。カレンダーには、インポートしたイベントのほか、AWS Systems Manager のツールである Change Calendar で作成したイベントを含めることができます。
**[開始する前に]**
カレンダーファイルをインポートする前に、次の要件と制約を確認してください。
カレンダーのファイル形式
有効な 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` ファイルをインポートできます。ただし、各カレンダーでインポートされたファイルすべての合計サイズは 64 KB を超えられません。
`.ics` ファイルのサイズを最小化するには、カレンダーのエントリに関する基本的な詳細のみをエクスポートしてください。必要に応じて、エクスポートする期間を短縮します。
タイムゾーン
カレンダー名、カレンダープロバイダ、および少なくとも 1 つのイベントのほか、エクスポートされた `.ics` ファイルには、カレンダーのタイムゾーンも示されます。これが表示されない場合、またはタイムゾーンの識別に問題がある場合は、ファイルをインポートした後、タイムゾーンを指定するように求められます。
反復イベントの制限
エクスポートされた `.ics` ファイルには、反復するイベントを含めることができます。ただし、ソースカレンダーで 1 つ以上の反復イベントが削除された場合、インポートは失敗します。
**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. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[Change Calendar]** を選択します。
1. 新しいカレンダーから開始するには、[**Create calendar** (カレンダーの作成)] を選択します。[**Import calendar** (カレンダーのインポート)] で [**Choose file** (ファイルの選択)] を選びます。新しいカレンダーを作成する他の手順については、「[Change Calendar の作成](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 のツール) にインポートします。Change Calendar のイベントは、新しいファイルの内容を反映するように更新されます。
**サードパーティーのカレンダープロバイダからすべてのイベントを更新するには**
1. サードパーティーのカレンダーで、Change Calendar に反映させたいイベントを追加するか削除し、カレンダーを新しい `.ics` ファイルに再エクスポートします。
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[Change Calendar]** を選択します。
1. カレンダーの一覧からカレンダー名を選択します。
1. **[ファイルの選択]** を選択して、置き換える `.ics` ファイルに移動して選択します。
1. 既存のファイルの上書きに関する通知に対して、[**Confirm** (確認)] を選択します。
# サードパーティーのカレンダーからインポートされたすべてのイベントの削除
サードパーティーのプロバイダからインポートしたイベントをカレンダーに含める必要がなくなった場合は、インポートした iCalendar `.ics` ファイルを削除できます。
**サードパーティーのカレンダーからインポートされたすべてのイベントを削除するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[Change Calendar]** を選択します。
1. カレンダーの一覧からカレンダー名を選択します。
1. [**Import calendar** (カレンダーのインポート)] の [**My imported calendars** (インポート済みのカレンダー)] で、インポートされたカレンダーの名前を見つけ、そのカードで **X** を選択します。
1. **[保存]** を選択します。
# Change Calendar の更新
Change Calendar の説明を更新できますが、名前は変更できません。カレンダーのデフォルトの状態は変更できますが、このカレンダーに関連付けられているイベント中の変更アクションの動作が逆になることに注意してください。たとえば、カレンダーの状態を [**Open by default (デフォルトでオープン)**] から [**Closed by default (デフォルトでクローズ)**] に変更すると、関連付けられたイベントを作成したユーザーが変更を予期していないイベント期間中に不要な変更が加えられることがあります。
Change Calendar を更新すると、エントリの作成時に作成した Change Calendar ドキュメントが編集されます。Change Calendar は AWS Systems Manager のツールです。
**Change Calendar を更新するには**
1. AWS 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** (説明)] で、説明テキストを変更できます。Change Calendar の名前は編集できません。
1. カレンダーの状態を変更するには、[**Calendar type** (カレンダータイプ)] で別の値を選択します。これにより、カレンダーに関連付けられているイベント中の変更アクションの動作が逆になることに注意してください。カレンダータイプを変更する前に、カレンダータイプを変更しても、作成済みのイベント中の不要な変更は許可されないことを他の Change Calendar ユーザーと確認する必要があります。
+ [**Open by default** (デフォルトでオープン)] - カレンダーはオープン (Automation アクションはイベントが開始するまで実行可能) で、関連付けられたイベントの期間中はクローズになります。
+ [**Closed by default** (デフォルトでクローズ)] - カレンダーはクローズ (Automation アクションはイベントが開始されるまで実行不可) で、関連付けられたイベントの期間中はオープンになります。
1. [**Save**] を選択します。
少なくとも 1 つのイベントを追加するまで、カレンダーでアクションを禁止または許可することはできません。イベントを追加する方法については、「[Change Calendar イベントの作成](change-calendar-create-event.md)」を参照してください。
# Change Calendar の共有
AWS Systems Manager コンソールを使用して、AWS Systems Manager のツールである Change Calendar のカレンダーを他の AWS アカウントと共有できます。カレンダーを共有した場合、そのカレンダーは共有アカウントのユーザーに対して読み取り専用になります。メンテナンスウィンドウ、State Manager の関連付け、オートメーションは共有されません。
**Change Calendar を共有するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[Change Calendar]** を選択します。
1. カレンダーのリストから、共有するカレンダーの名前を選択します。
1. カレンダーの詳細ページで、**[Sharing]** (共有) をクリックします。
1. **[Actions, Share]** (共有アクション) をクリックします。
1. [**Share calendar** (カレンダーの共有)] の [**Account ID **(アカウント ID)] に、有効な AWS アカウント の ID 番号を入力し、[**Share **(共有)] を選択します。
共有アカウントのユーザーは Change Calendar を読むことはできますが、変更できません。
# Change Calendar の削除
Systems Manager コンソールまたは AWS Command Line Interface (AWS CLI) を使用して、AWS Systems Manager のツールである Change Calendar でカレンダーを削除できます。Change Calendar を削除すると、関連するすべてのイベントが削除されます。
**Change Calendar を削除するには**
1. AWS 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 のツールである Change Calendar では、カレンダーの全体的な状態、または特定の時刻における状態を把握できます。また、カレンダーの状態が次回、`OPEN` から `CLOSED`、またはその逆に変化する時刻を表示することも可能です。
**注記**
Amazon EventBridge と Change Calendar を統合してカレンダーの状態の変化の自動モニタリングを行う方法については、「[Amazon EventBridge と Change Calendar の統合](monitoring-systems-manager-event-examples.md#change-calendar-eventbridge-integration)」を参照してください。EventBridge 統合は、カレンダーの状態が遷移したときにイベントドリブンの通知を提供し、`GetCalendarState` API アクションのポーリングベースのアプローチを補完します。
このタスクは、`GetCalendarState` API オペレーションを使用してのみ実行できます。このセクションの手順では、AWS Command Line Interface (AWS CLI) を使用します。
**Change Calendar の状態を取得するには**
+ 次のコマンドを実行して、特定の時刻の 1 つ以上のカレンダーの状態を表示します。`--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` パラメータを追加しない場合は、現在の時間が使用されます。
**注記**
1 つの要求に複数のカレンダーを指定すると、要求内のすべてのカレンダーが開いている場合にのみ、コマンドは `OPEN` のステータスを返します。要求内の 1 つ以上のカレンダーが閉じている場合、返されるステータスは `CLOSED` です。
# Automation ランブックへの Change Calendar の依存関係の追加
Automation アクションを AWS Systems Manager のツールである Change Calendar に準拠させるには、[`aws:assertAwsResourceProperty`](automation-action-assertAwsResourceProperty.md) アクションを使用する Automation ランブックにステップを追加します。指定したカレンダーエントリが目的の状態 (`GetCalendarState` または `OPEN`) であることを確認するために `CLOSED` を実行するアクションを設定します。オートメーションランブックは、カレンダーの状態が `OPEN` である場合にのみ次のステップに進むことができます。以下はオートメーションランブックの YAML ベースのサンプル抜粋です。カレンダーの状態が `OPEN` (`DesiredValues` で指定された状態) に一致しない限り、次の手順である `LaunchInstance` に進むことはできません。
以下に例を示します。
```
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 のトラブルシューティング
AWS Systems Manager のツールである Change Calendar を使用したトラブルシューティングでは、以下の情報を使用します。
**Topics**
+ [「カレンダーのインポートに失敗しました」エラー](#change-manager-troubleshooting-1)
## 「カレンダーのインポートに失敗しました」エラー
**問題**: 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** - ソースカレンダーに少なくとも 1 つのイベントが含まれていることを確認します。イベントの含まれていない `.ics` ファイルをアップロードしても成功しません。
+ **解決策 4** — `.ics` が大きすぎるためにインポートが失敗したと報告された場合は、カレンダーのエントリに関する基本的な詳細のみをエクスポートしていることを確認してください。必要に応じて、エクスポート期間を短縮します。
+ **解決策 5** — [**Events** (イベント)] タブからインポートしようとしている際、エクスポートされたカレンダーのタイムゾーンを Change Calendar が判別できない場合は、「カレンダーのインポートに失敗しました。Change Calendar は有効なタイムゾーンを見つけるられませんでした。カレンダーは [Edit (編集)] メニューからインポートできます」というメッセージが表示される可能性があります。この場合は、[**Actions, Edit** (アクション、編集)] を選択し、[**Edit calendar** (カレンダーの編集)] ページからファイルをインポートしてみてください。
+ **解決策 6** — インポート前に `.ics` ファイルを編集しないでください。ファイルの内容を変更しようとすると、カレンダーのデータが破損する可能性があります。インポートを試みる前にファイルを変更した場合は、元のカレンダーからカレンダーを再度エクスポートし、アップロードを再試行してください。