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

# 修改 Amazon DocumentDB 叢集參數群組
<a name="cluster_parameter_groups-modify"></a>

本節說明如何修改*自訂* Amazon DocumentDB 參數群組。在 Amazon DocumentDB 中，您無法修改在新區域中首次使用新引擎版本建立`default`叢集時建立的叢集參數群組。如果您的 Amazon DocumentDB 叢集使用預設叢集參數群組，而且您想要修改其中的值，您必須先[建立新的參數群組](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html)或[複製現有的參數群組](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html)、修改它，然後將修改後的參數群組套用至您的叢集。

完成下列步驟以修改自訂叢集參數群組。修改動作可能需要一段時間才能傳播。請等待修改後的叢集參數群組可用，再將其連接至您的叢集。您可以使用 AWS 管理主控台 或 AWS CLI `describe-db-cluster-parameters`操作來驗證叢集參數群組是否已修改。如需詳細資訊，請參閱[描述叢集參數群組](cluster_parameter_groups-describe.md)。

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

請依照下列步驟修改自訂 Amazon DocumentDB 參數群組。您無法修改 `default` 參數群組。如果您想要修改 `default` 參數群組中的值，可以[複製預設叢集參數群組](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html)並加以修改，接著將修改的參數群組套用到叢集。如需將參數群組套用到叢集的詳細資訊，請參閱[修改 Amazon DocumentDB 叢集](db-cluster-modify.md)。

**修改自訂叢集參數群組**

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

1. 在主控台左側的導覽窗格中，選擇 **Parameter groups (參數群組)**。在參數群組清單中，選擇您要修改看的參數群組名稱。
**提示**  
如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/docdb-menu-icon.png))。

1. 對於您要修改之參數群組中的每個參數，請執行下列動作：

   1. 找到您要修改的參數，並檢查其是否列為可修改資料欄`true`下的 ，以確認其**可修改**。

   1. 如果可以修改，請選取參數並從主控台頁面的右上角選擇 **Edit (編輯)**。

   1. 在**修改 `<parameter-name>`** 對話方塊中，進行所需的變更。然後，選擇 **Modify cluster parameter (修改叢集參數)**，或選擇 **Cancel (取消)** 以捨棄變更。

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

您可以使用 修改自訂 Amazon DocumentDB `ParameterValue`叢集參數群組中任何可修改參數`ApplyMethod`的 `Description`、 或 AWS CLI。您無法直接修改預設叢集參數群組。

若要修改自訂叢集參數群組的參數，請使用 `modify-db-cluster-parameter-group` 操作搭配下列參數。
+ **--db-cluster-parameter-group-name** – 必要。您想要修改的叢集參數群組名稱。
+ **--parameters** – 必要。您要修改的參數。如需套用至 Amazon DocumentDB 叢集中所有執行個體的參數清單，請參閱 [Amazon DocumentDB 叢集參數參考](cluster_parameter_groups-list_of_parameters.md)。每個參數項目必須包括下列：
  + **ParameterName** — 您要修改的參數名稱。
  + **ParameterValue** — 此參數的新值。
  + **ApplyMethod** — 您希望如何套用此參數的變更。允許值為 `immediate` 和 `pending-reboot`。
**注意**  
`static` 必須擁有使用 `ApplyType` 的參數 `ApplyMethod` `pending-reboot`。

**Example - 修改參數值**  
在此範例中，您列出 `sample-parameter-group` 的參數值和修改 `tls` 參數。接著，在等待 5 分鐘後，您會再次列出 `sample-parameter-group` 的參數值，以查看變更的參數值。  

1. 列出參數和其 `sample-parameter-group` 的值。

   針對 Linux、macOS 或 Unix：

   ```
   aws docdb describe-db-cluster-parameters \
          --db-cluster-parameter-group-name sample-parameter-group
   ```

   針對 Windows：

   ```
   aws docdb describe-db-cluster-parameters ^
          --db-cluster-parameter-group-name sample-parameter-group
   ```

   此操作的輸出將會如下所示 (JSON 格式)。

   ```
   {
          "Parameters": [
              {
                  "Source": "system",
                  "ApplyType": "static",
                  "AllowedValues": "disabled,enabled",
                  "ParameterValue": "enabled",
                  "ApplyMethod": "pending-reboot",
                  "DataType": "string",
                  "ParameterName": "tls",
                  "IsModifiable": true,
                  "Description": "Config to enable/disable TLS"
              },
              {
                  "Source": "user",
                  "ApplyType": "dynamic",
                  "AllowedValues": "disabled,enabled",
                  "ParameterValue": "enabled",
                  "ApplyMethod": "pending-reboot",
                  "DataType": "string",
                  "ParameterName": "ttl_monitor",
                  "IsModifiable": true,
                  "Description": "Enables TTL Monitoring"
              }
          ]
   }
   ```

1. 修改 `tls` 參數，讓其值為 `disabled`。

   您無法修改 `ApplyMethod`，因為 `ApplyType` 是 `static`。

   針對 Linux、macOS 或 Unix：

   ```
   aws docdb modify-db-cluster-parameter-group \
          --db-cluster-parameter-group-name sample-parameter-group \
          --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot
   ```

   針對 Windows：

   ```
   aws docdb modify-db-cluster-parameter-group ^
          --db-cluster-parameter-group-name sample-parameter-group ^
          --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot
   ```

   此操作的輸出將會如下所示 (JSON 格式)。

   ```
   {
          "DBClusterParameterGroupName": "sample-parameter-group"
      }
   ```

1. 等待至少 5 分鐘。

1. 列出 `sample-parameter-group` 的參數值，來確認 `tls` 參數已經過修改。

   針對 Linux、macOS 或 Unix：

   ```
   aws docdb describe-db-cluster-parameters \
          --db-cluster-parameter-group-name sample-parameter-group
   ```

   針對 Windows：

   ```
   aws docdb describe-db-cluster-parameters ^
          --db-cluster-parameter-group-name sample-parameter-group
   ```

   此操作的輸出將會如下所示 (JSON 格式)。

   ```
   {
          "Parameters": [
              {
                  "ParameterValue": "false",
                  "ParameterName": "enable_audit_logs",
                  "ApplyType": "dynamic",
                  "DataType": "string",
                  "Description": "Enables auditing on cluster.",
                  "AllowedValues": "true,false",
                  "Source": "system",
                  "IsModifiable": true,
                  "ApplyMethod": "pending-reboot"
              },
              {
                  "ParameterValue": "disabled",
                  "ParameterName": "tls",
                  "ApplyType": "static",
                  "DataType": "string",
                  "Description": "Config to enable/disable TLS",
                  "AllowedValues": "disabled,enabled",
                  "Source": "system",
                  "IsModifiable": true,
                  "ApplyMethod": "pending-reboot"
              }
          ]
   }
   ```

------