

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

# 重置 Amazon DocumentDB 集群参数组
<a name="cluster_parameter_groups-reset"></a>

您可以使用或 AWS Command Line Interface (AWS CLI) 重置集群参数组，将 Amazon DocumentDB 集群参数组的部分 AWS 管理控制台 或全部参数值重置为默认值。

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

按照以下步骤将将部分或全部集群参数组的参数值重置为默认值。

**要重置集群参数组的参数值**

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

1. 在控制台左侧的导航窗格中，选择**参数组**。

1. 在**集群参数组**窗格中，选择要对其复置的集群参数组的名称。

1. 选择**操作**，然后选择**重置**以重置该参数组。

1. 在所得的**集群参数组重置确认**页面上，确认您想要将该参数组的所有集群参数重置为默认值。然后，选择**重置**以重置您的参数组。您也可以选择**取消**以放弃所做更改。

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

要将部分或全部集群参数组的参数值重置为其默认值，请使用带有以下参数的 `reset-db-cluster-parameter-group` 操作。
+ **--db-cluster-parameter-group-name**：必需。要重置的集群参数组的名称。
+ **--parameters**：可选。集群参数组中要重置为其默认值的 `ParameterName` 和 `ApplyMethod` 列表。静态参数必须设置成 `pending-reboot` 才能在下次实例重启或 `reboot-db-instance` 请求时生效。对于集群中您希望更新的静态参数应用于的每个实例，您必须调用 `reboot-db-instance`。

  此参数和 `--reset-all-parameters` 相互排斥：您可以使用这两个参数之一，但不能同时使用二者。
+ **--reset-all-parameters** 或 **--no-reset-all-parameters**：可选。指定是否将所有参数 (`--reset-all-parameters` ) 或仅部分参数 (`--no-reset-all-parameters`) 重置为其默认值。`--reset-all-parameters` 参数和 `--parameters` 相互排斥：您可以使用这两个参数之一，但不能同时使用二者。

  当您重置整个组时，动态参数立即更新。将静态参数设置成 `pending-reboot`，以便在下次实例重启或 `reboot-db-instance` 请求时生效。对于集群中您希望更新的静态参数应用于的每个实例，您必须调用 `reboot-db-instance`。

**Example**  
**示例 1：将所有参数重置为其默认值**  
以下代码将集群参数组 `sample-parameter-group` 中的所有参数重置成它们的默认值。
对于 Linux、macOS 或 Unix：  

```
aws docdb reset-db-cluster-parameter-group \
       --db-cluster-parameter-group-name sample-parameter-group \
       --reset-all-parameters
```
对于 Windows：  

```
aws docdb reset-db-cluster-parameter-group ^
       --db-cluster-parameter-group-name sample-parameter-group ^
       --reset-all-parameters
```
**示例 2：将指定的参数重置为其默认值**  
以下代码将集群参数组 `sample-parameter-group` 中的 `tls` 参数重置成它的默认值。
对于 Linux、macOS 或 Unix：  

```
aws docdb reset-db-cluster-parameter-group \
       --db-cluster-parameter-group-name sample-parameter-group \
       --no-reset-all-parameters \
       --parameters ParameterName=tls,ApplyMethod=pending-reboot
```
对于 Windows：  

```
aws docdb reset-db-cluster-parameter-group ^
       --db-cluster-parameter-group-name sample-parameter-group ^
       --no-reset-all-parameters ^
       --parameters ParameterName=tls,ApplyMethod=pending-reboot
```
此操作的输出将类似于下文（JSON 格式）。  

```
{
       "DBClusterParameterGroupName": "sample-parameter-group"
   }
```
**重启集群实例**  
在更改静态参数的值之前，必须重新启动集群实例。重启集群中您希望将更新的静态参数应用到的每个实例。
对于 Linux、macOS 或 Unix：  

```
aws docdb reboot-db-instance \
       --db-instance-identifier sample-cluster-instance
```
对于 Windows：  

```
aws docdb reboot-db-instance ^
       --db-instance-identifier sample-cluster-instance
```

------