翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon DocumentDB サブネットグループの変更
<a name="document-db-subnet-group-modify"></a>

AWS マネジメントコンソール または AWS CLI を使用して、サブネットグループの説明を変更したり、Amazon DocumentDB サブネットグループにサブネットを追加または削除できます。ただし、`default` サブネットグループは変更できません。

------
#### [ Using the AWS マネジメントコンソール ]

AWS マネジメントコンソール を使用して、サブネットグループの説明を変更したり、サブネットを追加および削除できます。完了したら、サブネットグループに少なくとも 2 つのアベイラビリティーゾーンが関連付けられている必要があります。

**サブネットグループを変更するには**

1. AWS マネジメントコンソール にサインインし、Amazon DocumentDB コンソールを次の場所で開きます。[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)。

1. ナビゲーションペインで **[サブネットグループ]** を選択します。次に、サブネットグループ名の左側にあるボタンを選択します。`default` サブネットグループは変更できないことに注意してください。
**ヒント**  
画面の左側にナビゲーションペインが表示されない場合は、ページの左上隅にあるメニューアイコン (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/docdb-menu-icon.png)) を選択します。

1. [**アクション**] を選択してから、[**変更**] を選択します。

1. **説明** — サブネットグループの説明を変更するには、新しい説明を入力します。

1. サブネットグループに関連付けられているサブネットを変更するには、[**Add subnets (サブネットの追加)**] セクションで、次のいずれかを実行します。
   + このサブネットグループからサブネットをすべて削除するには、[**Remove all (すべてを削除)**] を選択します。
   + このサブネットグループから特定のサブネットを削除するには、削除するサブネットごとに [**Remove (削除)** を選択します。
   + この VPC に関連付けられているすべてのサブネットを追加するには、[**Add all the subnets related to this VPC (このVPCに関連付けられているすべてのサブネットを追加])**] を選択します。
   + このサブネットグループに特定のサブネットを追加するには、サブネットを追加する各アベイラビリティーゾーンに対して次の手順を実行します。

     1. **アベイラビリティーゾーン** - リストから新しいアベイラビリティーゾーンを選択します。

     1. **サブネット** — リストで、このサブネットグループに選択したアベイラビリティーゾーンからサブネットを選択します。

     1. [**Add subnet (サブネットを追加する)**] を選択します。

1. 確認ダイアログボックスでは:
   + サブネットグループにこのような変更を行うには、[**Modify (変更)**] を選択します。
   + サブネットグループを変更しない場合は、[**キャンセル**] を選択してください。

------
#### [ Using the AWS CLI ]

AWS CLI を使用して、サブネットグループの説明を変更したり、サブネットを追加および削除できます。完了したら、サブネットグループに少なくとも 2 つのアベイラビリティーゾーンが関連付けられている必要があります。`default` サブネットグループを変更することはできません。

**パラメータ:**
+ `--db-subnet-group-name` — 必須 変更している Amazon DocumentDB サブネットグループの名前。
+ `--subnet-ids` — 必須 この変更が完了した後でサブネットグループに必要となるすべてのサブネットの一覧。
**重要**  
このリストに含まれていない、現在サブネットグループにあるサブネットはすべて、サブネットグループから削除されます。現在サブネットグループにあるサブネットのいずれかを保持したい場合は、それらをこのリストに含める必要があります。
+ `--db-subnet-group-description` - オプションです。サブネットグループの説明。

**Example**  
次のコードは説明を変更し、既存のサブネットをサブネット `subnet-991cb8d0`、`subnet-53ab3636`、および `subnet-29ab1025` に置き換えます。  
Linux、macOS、Unix の場合:  

```
aws docdb modify-db-subnet-group \
    --db-subnet-group-name sample-subnet-group \
    --subnet-ids subnet-991cb8d0 subnet-53ab3636 subnet-29ab1025 \
    --db-subnet-group-description "Modified subnet group"
```
Windows の場合:  

```
aws docdb modify-db-subnet-group ^
    --db-subnet-group-name sample-subnet-group ^
    --subnet-ids subnet-991cb8d0 subnet-53ab3636 subnet-29ab1025 ^
    --db-subnet-group-description "Modified subnet group"
```
このオペレーションによる出力は、次のようになります（JSON 形式）。これは、「[Amazon DocumentDB サブネットグループの作成](document-db-subnet-group-create.md)」セクションで作成したものと同じサブネットグループであることに注目します。ただし、サブネットグループ内のサブネットは、`modify-db-subnet-group` オペレーションで一覧表示されるものに置き換えられます。  

```
{
    "DBSubnetGroup": {
        "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group",
        "DBSubnetGroupDescription": "Modified subnet group",
        "SubnetGroupStatus": "Complete",
        "Subnets": [
            {
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1d"
                },
                "SubnetStatus": "Active",
                "SubnetIdentifier": "subnet-53ab3636"
            },
            {
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1b"
                },
                "SubnetStatus": "Active",
                "SubnetIdentifier": "subnet-991cb8d0"
            },
            {
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1f"
                },
                "SubnetStatus": "Active",
                "SubnetIdentifier": "subnet-29ab1025"
            }
        ],
        "VpcId": "vpc-91280df6",
        "DBSubnetGroupName": "sample-subnet-group"
    }
}
```

------