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

# 创建 Amazon DocumentDB 集群参数组
<a name="cluster_parameter_groups-create"></a>

当您使用新引擎版本和在新区域创建集群时创建的默认集群参数组，例如 `default.docdb5.0`、`default.docdb4.0` 或 `default.docdb3.6`。在此区域创建且具有相同引擎版本的后续集群将继承 `default` 集群参数组。一经创建，`default` 参数组就无法删除或重命名。您可以通过创建带有首选参数值的自定义参数组并将其附加到 Amazon DocumentDB 集群来修改集群实例的引擎行为。

以下过程指导您完成集群参数组的创建。然后，您可以[修改该参数组中的参数](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-modify.html)。

**注意**  
创建一个集群参数组之后，您应至少等 5 分钟，再使用特定的集群参数组。这样，在将集群参数组用于新集群之前，Amazon DocumentDB 可以完成全部 `create` 操作。您可以使用 AWS 管理控制台 或`describe-db-cluster-parameter-groups` AWS CLI 操作来验证您的集群参数组是否已创建。有关更多信息，请参阅 [描述 Amazon DocumentDB 集群参数组](cluster_parameter_groups-describe.md)。

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

**要创建集群参数组**

1. [登录 AWS 管理控制台，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)

1. 在导航窗格中，选择**参数组**。
**提示**  
如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/docdb-menu-icon.png))。

1. 在**集群参数组**窗格中，选择**创建**。

1. 在**创建集群参数组**窗格中，输入以下内容：

   1. **新集群参数组名称**：为集群参数组输入一个名称。例如 `sample-parameter-group`。集群参数组具有以下命名限制：
      + 长度为 [1-255] 个字母数字字符。
      + 第一个字符必须是字母。
      + 不能以连字符结尾或包含两个连续的连字符。

   1. **系列**：选择要用于集群的 DocumentDB 版本。

   1. **描述**：为此集群参数组提供一个描述。

1. 要创建集群参数组，请选择**创建**。要取消操作，请选择**取消**。

1. 选择**创建**后，以下文本将显示于页面顶部，以验证集群参数组是否已成功创建：

   ```
   Successfully created cluster parameter group 'sample-parameter-group'.
   ```

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

要为 Amazon DocumentDB 4.0 集群创建新的集群参数组，请使用带有以下参数的 AWS CLI `create-db-cluster-parameter-group`操作：
+ **--db-cluster-parameter-group-name**：自定义集群参数组的名称。例如 `sample-parameter-group`。
+ **--db-cluster-parameter-group-family**：用作自定义集群参数组模板的集群参数组族。
+ **--description**：用户提供的此集群参数组的描述。下面的示例使用了“`Custom docdb4.0 parameter group`”。

对于 Linux、macOS 或 Unix：

**Example**  

```
aws docdb create-db-cluster-parameter-group \
 --db-cluster-parameter-group-name sample-parameter-group \
 --db-parameter-group-family docdb5.0 \
 --description "Custom docdb5.0 parameter group"
```
对于 Windows：  

```
aws docdb create-db-cluster-parameter-group ^
 --db-cluster-parameter-group-name sample-parameter-group ^
 --db-parameter-group-family docdb5.0 ^
 --description "Custom docdb5.0 parameter group"
```
此操作的输出将类似于下文（JSON 格式）。  

```
{
    "DBClusterParameterGroup": {
        "DBClusterParameterGroupName": "sample-parameter-group",
        "DBParameterGroupFamily": "docdb5.0",
        "Description": "Custom docdb4.0 parameter group",
        "DBClusterParameterGroupArn": "sample-parameter-group-arn"
    }
}
```

------