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

# 管理 Amazon DocumentDB 叢集參數群組
<a name="cluster_parameter_groups"></a>

您可以在叢集參數群組中使用參數來管理 Amazon DocumentDB 引擎組態。*叢集參數群組*是 Amazon DocumentDB 組態值的集合，可讓您更輕鬆地管理 Amazon DocumentDB 叢集的參數。叢集參數群組扮演引擎組態值的容器，以套用至資料庫叢集中的所有執行個體。

本節說明如何建立、檢視和修改叢集參數群組。此外也會為您示範如何判斷有哪些叢集參數群組與指定的叢集相關。

**Topics**
+ [描述叢集參數群組](cluster_parameter_groups-describe.md)
+ [建立叢集參數群組](cluster_parameter_groups-create.md)
+ [修改叢集參數群組](cluster_parameter_groups-modify.md)
+ [修改叢集以使用自訂叢集參數群組](cluster_parameter_groups-modify_clusters.md)
+ [複製叢集參數群組](cluster_parameter_groups-copy.md)
+ [重設叢集參數群組](cluster_parameter_groups-reset.md)
+ [刪除叢集參數群組](cluster_parameter_groups-delete.md)
+ [叢集參數參考](cluster_parameter_groups-list_of_parameters.md)

# 描述 Amazon DocumentDB 叢集參數群組
<a name="cluster_parameter_groups-describe"></a>

當您在新區域中建立第一個 Amazon DocumentDB 叢集或使用新引擎時，系統會自動建立`default`叢集參數群組。在相同區域中建立且具有相同引擎版本的後續叢集會使用`default`叢集參數群組建立。

**Topics**
+ [描述叢集參數群組的詳細資訊](#cluster_parameter_groups-describe_details)
+ [判斷叢集的參數群組](#cluster_parameter_groups-determine)
+ [判斷與叢集參數群組相關聯的叢集和執行個體](#cluster_parameter_groups-count)

## 描述 Amazon DocumentDB 叢集參數群組的詳細資訊
<a name="cluster_parameter_groups-describe_details"></a>

若要描述指定叢集參數群組的詳細資訊，請使用 AWS 管理主控台 或 AWS Command Line Interface () 完成下列步驟AWS CLI。

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

****

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. 在 **Cluster parameter groups (叢集參數群組)** 窗格中，選取您想要查看詳細資訊的參數群組名稱。

1. 產生的頁面會顯示參數群組的參數、最近的活動和標籤。
   + 在 **Cluster parameters (叢集參數)** 下，您可以看到參數名稱、目前值、允許值、參數是否可修改、套用類型、資料類型和說明。您可以選取 參數，然後在叢集參數區段中選擇**編輯**，以修改個別參數。 ****如需詳細資訊，請參閱[修改 Amazon DocumentDB 叢集參數](cluster_parameter_groups-parameters.md)。
   + 在 **Recent events (最近的事件)** 中，您可以查看此參數群組的最近事件。您可以使用本節中的搜尋列來篩選這些事件。如需詳細資訊，請參閱[管理 Amazon DocumentDB 事件](managing-events.md)。
   + 在 **Tags (標籤)**，您可以查看在此叢集參數群組上的標籤。您可以在標籤區段中選擇**編輯**來新增或移除**標籤**。如需詳細資訊，請參閱[標記 Amazon DocumentDB 資源](tagging.md)。

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

您可以使用 `describe-db-cluster-parameter-groups` AWS CLI 命令來檢視 Amazon DocumentDB 的單一叢集參數群組或所有叢集參數群組的 Amazon Resource Name (ARN)、系列、描述和名稱。您也可以使用 `describe-db-cluster-parameters` AWS CLI 命令，在單一叢集參數群組中檢視參數及其詳細資訊。
+ **--describe-db-cluster-parameter-groups** — 查看所有叢集參數群組及其詳細資訊的清單。
  + **--db-cluster-parameter-group-name** — 選用。您想要說明的叢集參數群組名稱。如果省略這個參數，所有叢集參數群組會加上說明。
+ **--describe-db-cluster-parameters** — 列出參數群組內的所有參數及其值。
  + **--db-cluster-parameter-group name** – 必要。您想要說明的叢集參數群組名稱。

**Example**  
以下程式碼列出高達 100 個叢集參數群組及其 ARN、系列、說明和名稱。  

```
aws docdb describe-db-cluster-parameter-groups
```
此操作的輸出將會如下所示 (JSON 格式)。  

```
{
          "DBClusterParameterGroups": [
              {
                  "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:default.docdb4.0",
                  "DBParameterGroupFamily": "docdb4.0",
                  "Description": "Default cluster parameter group for docdb4.0",
                  "DBClusterParameterGroupName": "default.docdb4.0"
              },
              {
                  "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:sample-parameter-group",
                  "DBParameterGroupFamily": "docdb4.0",
                  "Description": "Custom docdb4.0 parameter group",
                  "DBClusterParameterGroupName": "sample-parameter-group"
              }
          ]
}
```

**Example**  
以下程式碼列出 `sample-parameter-group` 的 ARN、系列、說明和名稱。  
針對 Linux、macOS 或 Unix：  

```
aws docdb describe-db-cluster-parameter-groups \
          --db-cluster-parameter-group-name sample-parameter-group
```
針對 Windows：  

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

```
{
          "DBClusterParameterGroups": [
              {
                  "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group",
                  "Description": "Custom docdb4.0 parameter group",
                  "DBParameterGroupFamily": "docdb4.0",
                  "DBClusterParameterGroupName": "sample-parameter-group"
              }
          ]
}
```

**Example**  
以下程式碼列出 `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": [
         {
            "ParameterName": "audit_logs",
            "ParameterValue": "disabled",
            "Description": "Enables auditing on cluster.",
            "Source": "system",
            "ApplyType": "dynamic",
            "DataType": "string",
            "AllowedValues": "enabled,disabled",
            "IsModifiable": true,
            "ApplyMethod": "pending-reboot"
         },
         {
            "ParameterName": "change_stream_log_retention_duration",
            "ParameterValue": "17777",
            "Description": "Duration of time in seconds that the change stream log is retained and can be consumed.",
            "Source": "user",
            "ApplyType": "dynamic",
            "DataType": "integer",
            "AllowedValues": "3600-86400",
            "IsModifiable": true,
            "ApplyMethod": "pending-reboot"
         }
   ]
}
```

------

## 判斷 Amazon DocumentDB 叢集的參數群組
<a name="cluster_parameter_groups-determine"></a>

若要判斷哪些參數群組與特定叢集相關聯，請使用 AWS 管理主控台 或 完成下列步驟 AWS CLI。

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

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

1. 在左側導覽窗格中選擇**叢集**。

1. 在叢集的清單中，選取您有興趣之叢集的名稱。

1. 產生的頁面會顯示您所選取叢集的詳細資訊。向下捲動至 **Cluster details (叢集詳細資訊)**。在該區段底部的 **Cluster parameter group (叢集參數群組)** 下找到參數群組的名稱。  
![\[螢幕擷取畫面：顯示叢集的參數群組。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/docdb-determine-parameter-group.png)

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

下列 AWS CLI 程式碼會決定管理叢集 的參數群組`sample-cluster`。

```
aws docdb describe-db-clusters \
      --db-cluster-identifier sample-cluster \
      --query 'DBClusters[*].[DBClusterIdentifier,DBClusterParameterGroup]'
```

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

```
[
       [
           "sample-cluster",
           "sample-parameter-group"
       ]
]
```

------

## 判斷與 Amazon DocumentDB 叢集參數群組相關聯的叢集和執行個體
<a name="cluster_parameter_groups-count"></a>

若要判斷有多少叢集和執行個體與每個參數群組相關聯，請使用 完成以下步驟 AWS CLI。

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

下列 AWS CLI 程式碼會決定有多少叢集和執行個體與 相關聯`sample-parameter-group`。

針對 Linux、macOS 或 Unix：

```
aws docdb describe-db-clusters \
      --query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' \
      --output json | \
      jq -r 'group_by(.[0]) | map({
         parameter_group_name: .[0][0],
         total_clusters: length,
         total_instances: map(.[2] | length) | add // 0
      }) | .[]'
```

針對 Windows：

```
aws docdb describe-db-clusters ^
      --query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' ^
      --output json | ^
      jq -r 'group_by(.[0]) | map({
         parameter_group_name: .[0][0],
         total_clusters: length,
         total_instances: map(.[2] | length) | add // 0
      }) | .[]'
```

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

```
{
   "parameter_group_name": "sample-parameter-group",
   "total_clusters": 50,
   "total_instances": 150
}
```

------

# 建立 Amazon DocumentDB 叢集參數群組
<a name="cluster_parameter_groups-create"></a>

當您使用新引擎版本和新區域建立叢集時`default.docdb3.6`，會建立預設叢集參數群組，例如 `default.docdb5.0``default.docdb4.0`、 或 。在此區域中建立且具有相同引擎版本的後續叢集會繼承`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 管理主控台，並在 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. 在 **Cluster parameter groups (叢集參數群組)** 窗格中，選擇 **Create (建立)**。

1. 在 **Create cluster parameter group (建立叢集參數群組)** 窗格中，輸入以下項目：

   1. **新的叢集參數群組名稱** — 輸入叢集參數群組的名稱。例如 `sample-parameter-group`。叢集參數群組具有以下命名限制：
      + 長度為 [1-255] 個英數字元。
      + 第一個字元必須是字母。
      + 不能以連字號結尾，或包含兩個連續連字號。

   1. **系列** — 選擇您要用於叢集的 DocumentDB 版本。

   1. **描述** — 提供此叢集參數群組的描述。

1. 若要建立叢集參數群組，請選擇 **Create (建立)**。若要取消操作，請選擇 **Cancel (取消)**。

1. 選擇 **Create (建立)** 之後，頁面頂端會顯示下列文字，以確認您的叢集參數群組是否已成功建立：

   ```
   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"
    }
}
```

------

# 修改 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"
              }
          ]
   }
   ```

------

# 修改 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",
   ...
}
```

------

# 複製 Amazon DocumentDB 叢集參數群組
<a name="cluster_parameter_groups-copy"></a>

您可以使用 AWS 管理主控台 或 AWS Command Line Interface () 在 Amazon DocumentDB 中複製叢集參數群組AWS CLI。

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

下列程序會藉由製作現有叢集參數群組的複本，引導您建立新的叢集參數群組。

**複製叢集參數群組**

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

1. 在導覽窗格中，選擇 **Parameter groups** (參數群組)。

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

1. 依序選擇 **Actions (動作)** 和 **Copy (複製)** 來複製該參數群組。

1. 在 **Copy options (複製選項)** 下，輸入新叢集參數群組的名稱和說明。接著選擇 **Copy (複製)** 來儲存變更。

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

若要複製叢集參數群組，請使用 `copy-db-cluster-parameter-group` 操作搭配下列參數。
+ **--source-db-cluster-parameter-group-identifier** – 必要。您要複製的叢集參數群組名稱或 Amazon Resource Name (ARN)。

  如果來源和目標叢集參數群組位於相同 中 AWS 區域，識別符可以是名稱或 ARN。

  如果來源和目標叢集參數群組位於不同的 中 AWS 區域，識別符必須是 ARN。
+ **--target-db-cluster-parameter-group-identifier** – 必要。叢集參數群組複本的名稱或 ARN。

  限制條件：
  + 不得為無效、空白或留空。
  + 必須包含 1-255 個字母、數字或連字號。
  + 第一個字元必須是字母。
  + 不能以連字號結尾，或包含兩個連續連字號。
+ **--target-db-cluster-parameter-group-description** – 必要。使用者提供叢集參數群組複本的說明。

**Example**  
以下程式碼複製 `sample-parameter-group`，將複本命名為 `sample-parameter-group-copy`。  
針對 Linux、macOS 或 Unix：  

```
aws docdb copy-db-cluster-parameter-group \
    --source-db-cluster-parameter-group-identifier sample-parameter-group \
    --target-db-cluster-parameter-group-identifier sample-parameter-group-copy \
    --target-db-cluster-parameter-group-description "Copy of sample-parameter-group"
```
針對 Windows：  

```
aws docdb copy-db-cluster-parameter-group ^
    --source-db-cluster-parameter-group-identifier sample-parameter-group ^
    --target-db-cluster-parameter-group-identifier sample-parameter-group-copy ^
    --target-db-cluster-parameter-group-description "Copy of sample-parameter-group"
```
此操作的輸出將會如下所示 (JSON 格式)。  

```
{
    "DBClusterParameterGroup": {
        "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group-copy",
        "DBClusterParameterGroupName": "sample-parameter-group-copy",
        "DBParameterGroupFamily": "docdb4.0",
        "Description": "Copy of sample-parameter-group"
    }
}
```

------

# 重設 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
```

------

# 刪除 Amazon DocumentDB 叢集參數群組
<a name="cluster_parameter_groups-delete"></a>

您可以使用 AWS 管理主控台 或 AWS Command Line Interface () 刪除自訂 Amazon DocumentDB 叢集參數群組AWS CLI。您無法刪除 `default.docdb4.0` 叢集參數群組。

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

**刪除叢集參數群組**

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. 在 **Parameter groups (參數群組)** 窗格中，選擇您想要刪除的叢集參數群組左側旁的選項按鈕。

1. 選擇**動作**，然後選擇**刪除**。

1. 在 **Delete (刪除)** 確認窗格中，選擇 **Delete (刪除)** 來刪除叢集參數群組。如果要保留叢集參數群組，請選擇 **Cancel (取消)**。

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

若要刪除叢集參數群組，請使用 `delete-db-cluster-parameter-group` 操作搭配下列參數。
+ **--db-cluster-parameter-group-name** – 必要。要刪除之叢集參數群組的名稱。這必須是現有叢集的參數群組。*您無法刪除`default.docdb4.0`叢集參數群組。 *

**Example - 刪除叢集參數群組**  
以下範例逐步引導您刪除叢集參數群組的三個步驟：  

1. 尋找您想要刪除的叢集參數群組名稱。

1. 刪除指定的叢集參數群組。

1. 確認已刪除叢集的參數群組。
**1. 尋找您想要刪除的叢集參數群組名稱。**  
以下程式碼列出所有叢集參數群組的名稱。
針對 Linux、macOS 或 Unix：  

```
aws docdb describe-db-cluster-parameter-groups \
       --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
針對 Windows：  

```
aws docdb describe-db-cluster-parameter-groups ^
       --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
上述操作的輸出是與以下 (JSON 格式) 類似的叢集參數群組名稱清單。  

```
[
       [
           "default.docdb4.0"
       ],
       [
           "sample-parameter-group"
       ],
       [
           "sample-parameter-group-copy"
       ]
   ]
```
**2. 刪除特定叢集參數群組。**  
以下程式碼會刪除叢集參數群組 `sample-parameter-group-copy`。
針對 Linux、macOS 或 Unix：  

```
aws docdb delete-db-cluster-parameter-group \
       --db-cluster-parameter-group-name sample-parameter-group-copy
```
針對 Windows：  

```
aws docdb delete-db-cluster-parameter-group ^
       --db-cluster-parameter-group-name sample-parameter-group-copy
```
此操作將不會有輸出。  
**3. 確認已刪除指定的叢集參數群組。**  
以下程式碼列出所有剩餘叢集參數群組的名稱。
針對 Linux、macOS 或 Unix：  

```
aws docdb describe-db-cluster-parameter-groups \
       --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
針對 Windows：  

```
aws docdb describe-db-cluster-parameter-groups ^
       --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
上述操作的輸出是與以下 (JSON 格式) 類似的叢集參數群組清單。您剛刪除的叢集參數群組不應在清單中。  
此操作的輸出將會如下所示 (JSON 格式)。  

```
[
       [
           "default.docdb4.0"
       ],
       [
           "sample-parameter-group"
       ]
   ]
```

------

# Amazon DocumentDB 叢集參數參考
<a name="cluster_parameter_groups-list_of_parameters"></a>

當您變更動態參數並儲存叢集參數群組時，無論 *Apply Immediately (立即套用)* 設定為何，變更都會立即套用。當您變更靜態參數並儲存叢集參數群組時，參數變更會在您手動重新啟動叢集執行個體之後生效。您可以使用 Amazon DocumentDB 主控台或明確呼叫 來重新啟動執行個體`reboot-db-instance`。

下表顯示套用至 Amazon DocumentDB 叢集中所有執行個體的參數。


**Amazon DocumentDB 叢集層級參數**  

| 參數 | 預設值 | 有效值 | 可修改 | 套用類型 | 資料類型 | Description | 
| --- | --- | --- | --- | --- | --- | --- | 
| audit\$1logs | disabled | enabled、disable、ddl、dml\$1read、dml\$1write、全部、無 | 是 | 動態 | String | 定義是否啟用 Amazon CloudWatch 稽核日誌。[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| change\$1stream\$1log\$1retention\$1duration | 10800 | 3600-604800 | 是 | 動態 | Integer | 定義變更串流日誌保留並可使用的持續時間 (以秒為單位)。 | 
| default\$1collection\$1compression | disabled | 啟用、停用 (Amazon DocumentDB 5.0)/zstd、lz4、無 (Amazon DocumentDB8.0) | 是 | 動態 | String | 定義叢集中新集合的預設壓縮設定 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| profiler | 停用 | 啟用，停用 | 是 | 動態 | String | 啟用緩慢操作的分析功能。[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| profiler\$1sampling\$1rate | 1.0 | 0.0-1.0 | 是 | 動態 | Float | 定義已記錄操作的取樣率。 | 
| profiler\$1threshold\$1ms | 100 | 50-2147483646 | 是 | 動態 | Integer | 定義 profiler 的閾值。[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| planner\$1version | 3.0 | 1.0、2.0、3.0 | 是 | 動態 | Float | 定義要用於查詢的查詢規劃器版本。[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| tls | 已啟用 | enabled、disable、fips-140-3、tls1.2\$1、tls1.3\$1 | 是 | 靜態 | String | 定義 Transport Layer Security (TLS) 連線是否必要。[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| ttl\$1monitor | 已啟用 | 啟用，停用 | 是 | 動態 | String | 定義是否為叢集啟用存活期 (TTL) 監控功能。[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 

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

在 Amazon DocumentDB 中，*叢集參數群組*包含的*參數*會套用至您在叢集中建立的所有執行個體。如為自訂叢集參數群組，您隨時可以為您建立的參數群組修改其參數值，或將所有參數值重設為預設值。本節說明如何檢視組成 Amazon DocumentDB 叢集參數群組的參數及其值，以及如何變更或更新這些值。

參數可以是 *dynamic (動態)* 或 *static (靜態)*。當您變更動態參數並儲存叢集參數群組時，無論 `Apply Immediately` 設定為何，變更都會立即套用。當您變更靜態參數並儲存叢集參數群組時，參數變更只會在您手動重新啟動叢集執行個體之後生效。

## 檢視 Amazon DocumentDB 叢集參數群組的參數
<a name="cluster_parameter_groups-describe_details_parameters"></a>

您可以使用 AWS 管理主控台 或 來查看 Amazon DocumentDB 叢集的參數及其值 AWS CLI。

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

**若要檢視叢集參數群組的詳細資訊**

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. 在 **Parameter groups (參數群組)** 窗格中，選擇您想要查看詳細資訊的叢集參數群組名稱。

1. 結果頁面會顯示各個參數的下列值：參數名稱、目前值、允許值、參數是否可修改、來源、資料類型和說明。  
![\[螢幕擷取畫面：參數名稱與值。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/docdb-determine-parameter-value.png)

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

若要查看叢集參數群組的參數和其值，請使用 `describe-db-cluster-parameters` 操作搭配下列參數。
+ **--db-cluster-parameter-group-name** – 必要。您想要詳細參數清單的叢集參數群組名稱。
+ **--source** — 選用。如果提供，只會傳回特定來源的參數。參數來源可以是 `engine-default`、`system` 或 `user`。

**Example**  
以下程式碼列出 `custom3-6-param-grp` 參數群組的參數及其值。如需參數群組的詳細資訊，請省略 `--query` 行。如需所有參數群組的詳細資訊，請省略 `--db-cluster-parameter-group-name` 行。  
針對 Linux、macOS 或 Unix：  

```
aws docdb describe-db-cluster-parameters \
   --db-cluster-parameter-group-name custom3-6-param-grp \
   --query 'Parameters[*].[ParameterName,ParameterValue]'
```
針對 Windows：  

```
aws docdb describe-db-cluster-parameters ^
   --db-cluster-parameter-group-name custom3-6-param-grp ^
   --query 'Parameters[*].[ParameterName,ParameterValue]'
```
此操作的輸出將會如下所示 (JSON 格式)。  

```
[
    [
        "audit_logs",
        "disabled"
    ],
    [
        "tls",
        "enabled"
    ],
    [
        "ttl_monitor",
        "enabled"
    ]
]
```

------

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

您可以使用 AWS 管理主控台 或 修改參數群組的參數 AWS CLI。

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

**更新叢集參數群組的參數**

1. 登入 AWS 管理主控台，並在 [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. 在 **Parameter groups (參數群組)** 窗格中，選擇您想要更新其中參數的叢集參數群組。

1. 結果頁面會顯示這個叢集參數群組的參數，及其對應詳細資訊。選取要更新的參數。

1. 在頁面右上角，選擇 **Edit (編輯)** 以變更此參數值。如需叢集參數類型的詳細資訊，請參閱[Amazon DocumentDB 叢集參數參考](cluster_parameter_groups-list_of_parameters.md)。

1. 進行變更，然後選擇 **Modify cluster parameter (修改叢集參數)** 以儲存變更。若要捨棄變更，請選擇 **Cancel (取消)**。

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

若要修改叢集參數群組的參數，請使用 `modify-db-cluster-parameter-group` 操作搭配下列參數。
+ **--db-cluster-parameter-group-name** – 必要。您想要修改的叢集參數群組名稱。
+ **--parameters** – 必要。您正在修改的一或多個參數。每個參數項目必須包括下列：
  + **ParameterName** — 您要修改的參數名稱。
  + **ParameterValue** — 此參數的新值。
  + **ApplyMethod** — 您希望如何套用此參數的變更。允許值為 `immediate` 和 `pending-reboot`。
**注意**  
`static` 必須擁有使用 `ApplyType` 的參數 `ApplyMethod` `pending-reboot`。

**變更叢集參數群組的參數值 (AWS CLI)**

下列範例會變更 `tls` 參數。

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` 的參數值。**

   針對 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": [
           {
               "ParameterName": "audit_logs",
               "ParameterValue": "disabled",
               "Description": "Enables auditing on cluster.",
               "Source": "system",
               "ApplyType": "dynamic",
               "DataType": "string",
               "AllowedValues": "enabled,disabled",
               "IsModifiable": true,
               "ApplyMethod": "pending-reboot"
           },
           {
               "ParameterName": "tls",
               "ParameterValue": "disabled",
               "Description": "Config to enable/disable TLS",
               "Source": "user",
               "ApplyType": "static",
               "DataType": "string",
               "AllowedValues": "disabled,enabled",
               "IsModifiable": true,
               "ApplyMethod": "pending-reboot"
           }
       ]
   }
   ```

------