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

# 複製 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"
    }
}
```

------