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

# 修改 Amazon DocumentDB 叢集以使用自訂叢集參數群組
<a name="cluster_parameter_groups-modify_clusters"></a>

當您建立 Amazon DocumentDB 叢集時，會自動為該叢集建立`default.docdb4.0`參數群組。您無法修改 `default` 叢集參數群組。反之，您可以修改 Amazon DocumentDB 叢集，將新的自訂參數群組與其建立關聯。

本節說明如何使用 AWS 管理主控台 和 AWS Command Line Interface () 修改現有的 Amazon DocumentDB 叢集以使用自訂叢集參數群組AWS CLI。

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

**修改 Amazon DocumentDB 叢集以使用新的非預設叢集參數群組**

1. 開始之前，請確定您已建立 Amazon DocumentDB 叢集和叢集參數群組。如需進一步說明，請參閱[建立 Amazon DocumentDB 叢集](db-cluster-create.md)與[建立 Amazon DocumentDB 叢集參數群組](cluster_parameter_groups-create.md)。

1. 建立叢集參數群組之後，請在 開啟 Amazon DocumentDB 主控台[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)。在導覽窗格中選擇 **Clusters (叢集)** 來將新的參數群組新增至叢集。

1. 選擇您要與參數群組建立關聯的叢集。選擇 **Actions (動作)**，然後選擇 **Modify (修改)** 來修改叢集。

1. 在 **Cluster options (叢集選項)** 下，選擇要與叢集建立關聯的參數群組。

1. 選擇 **Continue (繼續)** 以檢視修改摘要。

1. 確認變更後，即可立即套用，或是在下一個維護時段在 **Scheduling of modifications (修改的排程)** 下套用。

1. 選擇 **Modify cluster (修改叢集)** 來以新的參數群組更新叢集。

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

開始之前，請確定您已建立 Amazon DocumentDB 叢集和叢集參數群組。您可以使用 [操作建立 Amazon DocumentDB 叢集](https://docs.aws.amazon.com//documentdb/latest/developerguide/db-cluster-create.html)。 AWS CLI `create-db-cluster`您可以使用 `create-db-cluster-parameter-group`操作[建立叢集參數群組](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) AWS CLI 。

若要將新的叢集參數群組新增至叢集，請使用 AWS CLI `modify-db-cluster`操作搭配下列參數。
+ **--db-cluster-identifier** — 叢集的名稱 （例如 `sample-cluster`)。
+ **--db-cluster-parameter-group-name** — 您要與叢集建立關聯的參數群組名稱 （例如 `sample-parameter-group`)。

**Example**  

```
aws docdb modify-db-cluster \
    --db-cluster-identifier sample-cluster \
    --db-cluster-parameter-group-name sample-parameter-group
```
此操作的輸出將會如下所示 (JSON 格式)。  

```
"DBCluster": {
    "AvailabilityZones": [
            "us-west-2c",
            "us-west-2b",
            "us-west-2a"
    ],
    "BackupRetentionPeriod": 1,
    "DBClusterIdentifier": "sample-cluster",
    "DBClusterParameterGroup": "sample-parameter-group",
    "DBSubnetGroup": "default",
   ...
}
```

------