本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 修改 Amazon DocumentDB 子网组
<a name="document-db-subnet-group-modify"></a>

您可以使用 AWS 管理控制台 或 AWS CLI 修改子网组描述或在 Amazon DocumentDB 子网组中添加或删除子网。不过，您无法修改 `default` 子网组。

------
#### [ Using the AWS 管理控制台 ]

您可以使用 AWS 管理控制台 更改子网组描述或添加和删除子网。请记住，在完成后，您必须具有至少两个与子网组关联的可用区。

**修改子网组**

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/zh_cn/documentdb/latest/developerguide/images/docdb-menu-icon.png))。

1. 选择 **Actions (操作)**，然后选择 **Modify (修改)**。

1. **Description (描述)**—要更改子网组描述，请输入新描述。

1. 要更改与子网组关联的子网，请在**添加子网**部分中执行一个或多个以下操作：
   + 要从该子网组中删除所有子网，请选择**全部删除**。
   + 要从该子网组中删除特定的子网，请为要删除的每个子网选择**删除**。
   + 要添加与该 VPC 关联的所有子网，请选择**添加与此 VPC 相关的所有子网**。
   + 要将特定子网添加到该子网组中，请为要添加子网的每个可用区执行以下操作。

     1. **Availability zone (可用区)**—在列表中，选择新的可用区。

     1. **Subnet (子网)**—在列表中，从该子网组所选可用区中选择一个子网。

     1. 选择 **Add subnet (添加子网)**。

1. 在确认对话框中：
   + 要对子网组进行这些更改，请选择 **Modify (修改)**。
   + 要将子网组保持不变，请选择**取消**。

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

您可以使用 AWS CLI 更改子网组描述或添加和删除子网。请记住，在完成后，您必须具有至少两个与子网组关联的可用区。您无法修改 `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"
    }
}
```

------