# マルチロケーション Canary の管理
<a name="CloudWatch_Synthetics_MultiLocation_Managing"></a>

## マルチロケーション Canary の作成
<a name="CloudWatch_Synthetics_MultiLocation_Create_Manage"></a>

マルチロケーション Canary を作成するには、「[Canary を作成する](CloudWatch_Synthetics_Canaries_Create.md)」の手順に従って、**[ロケーション]** で追加のリージョンを選択します。現在のリージョンがプライマリロケーションとして自動的に選択されます。

マルチロケーション Canary を作成する場合、次の要件が適用されます。
+ 最大 50 のレプリカロケーションを追加できます。
+ Canary スクリプトの .zip ファイルは 50 MB を超えることはできません。
+ 選択したレプリカリージョンに既に Canary 名が存在してはいけません。
+ レプリカのロケーションは、CloudWatch Synthetics 商用リージョンでサポートされている必要があります。プライマリリージョンをレプリカのロケーションとして選択することはできません。
+ マルチロケーション Canary をグループに関連付けることはできません。Canary がグループに属している場合は、レプリカのロケーションを追加する前に、すべてのグループから関連付けを解除します。
+ Canary で VPC 接続が必要な場合は、レプリカリージョンごとに VPC 設定を個別に設定する必要があります。VPC 設定はプライマリから継承されません。
+ タグはレプリカリージョンにレプリケートされません。レプリカにタグを追加するには、レプリカリージョンに移動し、タグを直接追加します。

作成後、レプリカは非同期的にプロビジョニングされます。**[設定]** タブの Canary の詳細ページでレプリケーションの進行状況をモニタリングできます。レプリカが `InSync` 状態になると、完全にプロビジョニングされ、実行されます。レプリカリージョンでレプリカ Canary を直接表示することもできます。詳細については、「[レプリケーションステータス](#CloudWatch_Synthetics_MultiLocation_ReplicationStatus_Manage)」を参照してください。

レプリカのプロビジョニングに失敗しても、プライマリ Canary は正常に作成されます。失敗したレプリカには、`Inconsistent` レプリケーションステータスが表示されます。Canary を更新して再試行できます。

## レプリカのロケーションの追加または削除
<a name="CloudWatch_Synthetics_MultiLocation_Update_Manage"></a>

レプリカのロケーションを追加または削除するには、プライマリリージョンから Canary を編集し、**[ロケーション]** で選択内容を更新します。レプリカリージョンからマルチロケーション Canary を編集することはできません。Canary 編集の詳細については、「[Canary を編集または削除する](synthetics_canaries_deletion.md)」を参照してください。

レプリカのロケーションを追加または削除する場合、次の要件が適用されます。
+ レプリケーションの進行中にマルチロケーション Canary を変更することはできません。すべてのレプリカが `InSync` または `Inconsistent` 状態になるまで待ってから変更を加えます。詳細については、「[レプリケーションステータス](#CloudWatch_Synthetics_MultiLocation_ReplicationStatus_Manage)」を参照してください。
+ レプリカのロケーションを追加する場合は、リクエストに Canary コードを含める必要があります。
+ 整合性のないレプリカを持つ Canary を更新する場合は、同じリクエストで整合性のないレプリカをすべて削除しない限り、Canary コードを含める必要があります。
+ 単一のリクエストで同じロケーションを追加および削除することはできません。
+ 存在しないレプリカのロケーションを削除することはできません。

## マルチロケーション Canary の開始と停止
<a name="CloudWatch_Synthetics_MultiLocation_StartStop_Manage"></a>

マルチロケーション Canary を開始または停止すると、アクションはプライマリ Canary とすべてのレプリカロケーションに適用されます。

マルチロケーション Canary を開始または停止する場合、次の要件が適用されます。
+ プライマリリージョンから Canary を開始または停止する必要があります。レプリカリージョンからの開始および停止オペレーションは許可されません。
+ レプリケーションの進行中にマルチロケーション Canary を開始または停止することはできません。すべてのレプリカが `InSync` または `Inconsistent` 状態になるまで待ってから、開始または停止します。詳細については、「[レプリケーションステータス](#CloudWatch_Synthetics_MultiLocation_ReplicationStatus_Manage)」を参照してください。
+ Canary は、開始するには `READY` または `STOPPED` 状態、停止するには `RUNNING` 状態である必要があります。

## マルチロケーション Canary の削除
<a name="CloudWatch_Synthetics_MultiLocation_Delete_Manage"></a>

マルチロケーション Canary を削除するには、まずすべてのレプリカロケーションを削除する必要があります。詳細については、「[Canary を編集または削除する](synthetics_canaries_deletion.md)」を参照してください。以下の要件が適用されます。
+ プライマリリージョンから Canary を削除する必要があります。削除オペレーションはレプリカリージョンからは許可されません。
+ 削除を試みる前に、すべてのレプリカが完全に削除されるのを待ちます。**[設定]** タブで削除の進捗状況をモニタリングできます。詳細については、「[レプリケーションステータス](#CloudWatch_Synthetics_MultiLocation_ReplicationStatus_Manage)」を参照してください。
+ Canary は、`STOPPED`、`READY`、または `ERROR` 状態である必要があります。Canary が実行されている場合は、まず停止します。

## レプリケーションステータス
<a name="CloudWatch_Synthetics_MultiLocation_ReplicationStatus_Manage"></a>

レプリケーションステータスは、レプリカとプライマリ Canary の同期状態を示します。レプリケーションのステータスは、**[設定]** タブの Canary 詳細ページで確認できます。

レプリカのレプリケーションステータス値は、次のいずれかです。
+ **InProgress** — レプリカを作成または更新中です。プライマリからの変更はレプリカに伝達されます。
+ **InSync** — レプリカはプライマリ Canary 設定と完全に同期されています。
+ **Inconsistent** — レプリカがプライマリ Canary と同期していません。これは、伝達が失敗した場合に発生する可能性があります。Canary を再度更新することで再試行できます。

プライマリ Canary の全体的な *ReplicationState* には、すべてのレプリカの集計状態が表示されます。`InProgress` のレプリカがある場合、全体的な状態は `InProgress` です。`Inconsistent` のレプリカがある場合、全体的な状態は `Inconsistent` です。