# AWS CLI を使用する
<a name="multi-region-aws-cli"></a>

AWS CLI は、マルチリージョン Aurora DSQL クラスターを管理するためのコマンドラインインターフェイスを提供します。次の例は、マルチリージョンクラスターを作成、設定、削除する方法を示しています。

## マルチリージョンクラスターに接続する
<a name="connecting-multi-region-clusters"></a>

マルチリージョンピアリングクラスターは、ピアリングクラスターの AWS リージョンごとに 1 つずつ、2 つのリージョンエンドポイントを提供します。どちらのエンドポイントも、強力なデータ整合性を持つ同時読み取りおよび書き込みオペレーションをサポートする単一の論理データベースを提供します。ピア接続されたクラスターに加えて、マルチリージョンクラスターには、暗号化されたトランザクションログを限られた期間保存するウィットネスリージョンもあり、マルチリージョンの耐久性と可用性を向上させるために使用されます。マルチリージョンウィットネスリージョンにはエンドポイントがありません。

## マルチリージョンクラスターを作成する
<a name="creating-multi-region-clusters"></a>

マルチリージョンクラスターを作成するには、まずウィットネスリージョンを使用してクラスターを作成します。次に、このクラスターを、最初のクラスターと同じウィットネスリージョンを共有する 2 番目のクラスターとピア接続します。次の例は、米国東部 (バージニア北部) と米国東部 (オハイオ) で、米国西部 (オレゴン) を監視リージョンとしてクラスターを作成する方法を示しています。

### ステップ 1: 米国東部 (バージニア北部) でクラスター 1 を作成する
<a name="create-first-cluster"></a>

マルチリージョンプロパティを使用して米国東部 (バージニア北部) AWS リージョンにクラスターを作成するには、以下のコマンドを使用します。

```
aws dsql create-cluster \
--region us-east-1 \
--multi-region-properties '{"witnessRegion":"us-west-2"}'
```

**Example レスポンス:**  

```
{
    "identifier": "abc0def1baz2quux3quuux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
    "status": "UPDATING",
    "encryptionDetails": {
        "encryptionType": "AWS_OWNED_KMS_KEY",
        "encryptionStatus": "ENABLED"
   }
   "creationTime": "2024-05-24T09:15:32.708000-07:00"
}
```

**注記**  
API オペレーションが成功すると、クラスターは `PENDING_SETUP` 状態になります。クラスターの作成は、ピアクラスターの ARN でクラスターを更新するまで `PENDING_SETUP` のままです。

### ステップ 2: 米国東部 (オハイオ) でクラスター 2 を作成する
<a name="create-cluster-two"></a>

マルチリージョンプロパティを使用して米国東部 (オハイオ) AWS リージョンにクラスターを作成するには、以下のコマンドを使用します。

```
aws dsql create-cluster \
--region us-east-2 \
--multi-region-properties '{"witnessRegion":"us-west-2"}'
```

**Example レスポンス:**  

```
{
    "identifier": "foo0bar1baz2quux3quuxquux5",
    "arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
    "status": "PENDING_SETUP",
    "creationTime": "2025-05-06T06:51:16.145000-07:00",
    "deletionProtectionEnabled": true,
    "multiRegionProperties": {
        "witnessRegion": "us-west-2",
        "clusters": [
            "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5"
        ]
    }
}
```

API オペレーションが成功すると、クラスターは `PENDING_SETUP` 状態に移行します。クラスターの作成は、ピアリング用に別のクラスターの ARN で更新するまで `PENDING_SETUP` 状態のままです。

### ステップ 3: 米国東部 (バージニア北部) と米国東部 (オハイオ) のピアクラスター
<a name="peer-cluster-east1"></a>

米国東部 (バージニア北部) クラスターを米国東部 (オハイオ) クラスターとピアリングするには、`update-cluster` コマンドを使用します。米国東部 (バージニア北部) クラスター名と、米国東部 (オハイオ) クラスターの ARN を持つ JSON 文字列を指定します。

```
aws dsql update-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4' \
--multi-region-properties '{"witnessRegion": "us-west-2","clusters": ["arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5"]}'
```

**Example 応答**  

```
{
    "identifier": "foo0bar1baz2quux3quuxquux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
    "status": "UPDATING",
    "creationTime": "2025-05-06T06:46:10.745000-07:00"
}
```

### ステップ 4: 米国東部 (オハイオ) と米国東部 (バージニア北部) のピアクラスター
<a name="peer-cluster-east2"></a>

米国東部 (オハイオ) クラスターを米国東部 (バージニア北部) クラスターとピアリングするには、`update-cluster` コマンドを使用します。米国東部 (オハイオ) クラスター名と、米国東部 (バージニア北部) クラスターの ARN を持つ JSON 文字列を指定します。

**Example**  

```
aws dsql update-cluster \
--region us-east-2 \
--identifier 'foo0bar1baz2quux3quuxquux5' \
--multi-region-properties '{"witnessRegion": "us-west-2", "clusters": ["arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4"]}'
```

**Example 応答**  

```
{
    "identifier": "foo0bar1baz2quux3quuxquux5",
    "arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
    "status": "UPDATING",
    "creationTime": "2025-05-06T06:51:16.145000-07:00"
}
```

**注記**  
ピアリングが成功すると、両方のクラスターは「PENDING\_SETUP」から「CREATING」に移行し、使用する準備が整うと、最終的に「ACTIVE」ステータスに移行します。

#### マルチリージョンクラスターのプロパティを表示する
<a name="describe-cluster-multiregion"></a>

クラスターを説明すると、異なる AWS リージョンのクラスターのマルチリージョンプロパティを表示できます。

**Example**  

```
aws dsql get-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4'
```

**Example 応答**  

```
{
    "identifier": "foo0bar1baz2quux3quuxquux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
    "status": "PENDING_SETUP", 
    "encryptionDetails": {
    "encryptionType": "AWS_OWNED_KMS_KEY",
    "encryptionStatus": "ENABLED"
},
    "creationTime": "2024-11-27T00:32:14.434000-08:00",
    "deletionProtectionEnabled": false,
    "multiRegionProperties": {
       "witnessRegion": "us-west-2",
       "clusters": [
          "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
          "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5"
       ]
    }
}
```

#### 作成中のピアクラスター
<a name="peer-during-creation"></a>

クラスターの作成時にピアリング情報を含めることで、ステップの数を減らすことができます。米国東部 (バージニア北部) で最初のクラスターを作成した後 (ステップ 1)、米国東部 (オハイオ) で 2 番目のクラスターを作成し、最初のクラスターの ARN を含めることで同時にピアリングプロセスを開始できます。

**Example**  

```
aws dsql create-cluster \
--region us-east-2 \
--multi-region-properties '{"witnessRegion":"us-west-2","clusters": ["arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4"]}'
```

これにより、ステップ 2 と 4 が組み合わせられますが、ピアリング関係を確立するには、ステップ 3 (最初のクラスターを 2 番目のクラスターの ARN で更新) を完了する必要があります。すべてのステップが完了すると、両方のクラスターは標準プロセスと同じ状態に移行します。**[PENDING\_SETUP]** から **[CREATING]** に移行し、使用する準備ができたら最後に **[ACTIVE]** に移行します。

## マルチリージョンクラスターを削除する
<a name="delete-clusters"></a>

マルチリージョンクラスターを削除するには、2 つのステップを完了する必要があります。

1. 各クラスターの削除保護をオフにします。

1. ピアリングされた各クラスターをそれぞれ対応する AWS リージョンで個別に削除する

### 米国東部 (バージニア北部) のクラスターを更新および削除する
<a name="delete-cluster-us-east-1"></a>

1. `update-cluster` コマンドを使用して削除保護をオフにします。

   ```
   aws dsql update-cluster \
     --region us-east-1 \
     --identifier 'foo0bar1baz2quux3quuxquux4' \
     --no-deletion-protection-enabled
   ```

1. `delete-cluster` コマンドを使用してクラスターを削除します。

   ```
   aws dsql delete-cluster \
     --region us-east-1 \
     --identifier 'foo0bar1baz2quux3quuxquux4'
   ```

   このコマンドは、次のレスポンスを返します。

   ```
   {
       "identifier": "foo0bar1baz2quux3quuxquux4",
       "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
       "status": "PENDING_DELETE", 
       "creationTime": "2025-05-06T06:46:10.745000-07:00"
   }
   ```
**注記**  
クラスターは `PENDING_DELETE` ステータスに移行します。削除は、米国東部 (オハイオ) でピアリングされたクラスターを削除するまで完了しません。

### 米国東部 (オハイオ) でクラスターを更新および削除する
<a name="delete-cluster-us-east-2"></a>

1. `update-cluster` コマンドを使用して削除保護をオフにします。

   ```
   aws dsql update-cluster \
   --region us-east-2 \
   --identifier 'foo0bar1baz2quux3quux4quuux' \
   --no-deletion-protection-enabled
   ```

1. `delete-cluster` コマンドを使用してクラスターを削除します。

   ```
   aws dsql delete-cluster \
   --region us-east-2 \
   --identifier 'foo0bar1baz2quux3quuxquux5'
   ```

   このコマンドは、次のレスポンスを返します。

   ```
   {
       "identifier": "foo0bar1baz2quux3quuxquux5",
       "arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
       "status": "PENDING_DELETE",
       "creationTime": "2025-05-06T06:46:10.745000-07:00"
   }
   ```
**注記**  
クラスターは `PENDING_DELETE` ステータスに移行します。数秒後、システムは検証後に両方のピアリングされたクラスターを `DELETING` ステータスに自動的に移行します。