本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 修改 Amazon DocumentDB 子網路群組
<a name="document-db-subnet-group-modify"></a>

您可以使用 AWS 管理主控台 或 AWS CLI 來修改子網路群組的描述，或從 Amazon DocumentDB 子網路群組新增或移除子網路。不過，您無法修改 `default` 子網路群組。

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

您可以使用 AWS 管理主控台 來變更子網路群組的描述，或新增和移除子網路。請記住，完成後，您必須至少有兩個可用區域與子網路群組關聯。

**修改子網路群組**

1. 登入 AWS 管理主控台，並在 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)：// 開啟 Amazon DocumentDB 主控台。

1. 在導覽窗格中選擇 **Subnet groups (子網路群組)**。然後，選擇子網路群組名稱左側的按鈕。請記住，您無法修改 `default` 子網路群組。
**提示**  
如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/docdb-menu-icon.png))。

1. 選擇 **Actions (動作)**，然後選擇 **Modify (修改)**。

1. **Description** - 若要變更子網路群組的描述，請輸入新的描述。

1. 若要變更與子網路群組相關聯的子網路，請在 **Add subnets (新增子網路)** 區段中執行下列其中一個或多個動作：
   + 若要移除此子網路群組中的所有子網路，選擇 **Remove all (全部移除)**。
   + 若要從此子網路群組中移除特定的子網路，請為每個想要移除的子網路選擇 **Remove (移除)**。
   + 若要新增與此 VPC 相關的所有子網路，請選擇 **Add all the subnets related to this VPC (新增與此 VPC 相關的所有子網路)**。
   + 若要新增特定子網路至子網路群組，請為想要新增子網路的每個可用區域執行下列動作。

     1. **可用區域** - 在清單中，選擇新的可用區域。

     1. **Subnet** - 在清單中，從為此子網路群組選擇的可用區域選擇子網路。

     1. 選擇 **Add subnet (新增子網路)**。

1. 在確認對話方塊中：
   + 若要對子網路群組進行這些變更，請選擇 **Modify (修改)**。
   + 若要保持子網路群組不變，請選擇 **Cancel (取消)**。

------
#### [ 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"
    }
}
```

------