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

# 重設 Amazon DocumentDB 叢集參數群組
<a name="cluster_parameter_groups-reset"></a>

您可以使用 或 AWS 管理主控台 AWS Command Line Interface (AWS CLI) 重設叢集參數群組，將部分或全部 Amazon DocumentDB 叢集參數群組的參數值重設為其預設值。

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

請遵循這些步驟操作，將部分或全部叢集參數群組的參數值重設為預設值。

**重設叢集參數群組的參數值**

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

1. 在主控台左側的導覽窗格中，選擇 **Parameter groups (參數群組)**。

1. 在 **Cluster parameter groups (叢集參數群組)** 窗格中，選擇您想要重設的叢集參數群組名稱。

1. 依序選擇 **Actions (動作)** 和 **Reset (重設)** 來重設該參數群組。

1. 在產生的 **Cluster parameter group reset confirmation (叢集參數群組重設確認)** 頁面上，確認您想要將該參數群組的所有叢集參數重設為預設值。然後選擇 **Reset (重設)** 以重設您的參數群組。您也可以選擇 **Cancel** (取消) 以捨棄變更。

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

若要將部分或全部叢集參數群組的參數值重設為預設值，使用 `reset-db-cluster-parameter-group` 操作搭配下列參數。
+ **--db-cluster-parameter-group-name** – 必要。要重設之叢集參數群組的名稱。
+ **--parameters** — 選用。叢集參數群組中要重設為預設值的 `ApplyMethod` 和 `ParameterName` 清單。靜態參數必須設定為 `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
```

------