翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon DocumentDB クラスターパラメータグループを作成する
<a name="cluster_parameter_groups-create"></a>

`default.docdb5.0`、`default.docdb4.0`、`default.docdb3.6` などのデフォルトのクラスターパラメータグループは、新しいエンジンバージョンを使って新しいリージョンでクラスターを作成したときに作成されます。このリージョンで同じエンジンバージョンを使用して作成された後続のクラスターは、`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://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) で Amazon DocumentDB コンソールを開きます。

1. ナビゲーションペインで、**[パラメータグループ]** を選択します。
**ヒント**  
画面の左側にナビゲーションペインが表示されない場合は、ページの左上隅にあるメニューアイコン (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/docdb-menu-icon.png)) を選択します。

1. [**クラスターパラメータグループ**] ペインで、[**作成**] を選択します。

1. [**クラスターパラメータグループの作成**] ペインで、次のように入力します。

   1. **新しいクラスターパラメータグループ名** - クラスターパラメーターグループの名前を入力します。例えば、`sample-parameter-group`。クラスターパラメータグループには、次のような命名に関する制約があります。
      + 長さは [1 ～ 255] 個の英数字です。
      + 1 字目は英字である必要があります。
      + ハイフンで終わることも、2 つのハイフンを連続して含むこともできません。

   1. **ファミリー** — クラスターに使用する DocumentDB バージョンを選択します。

   1. **説明** - このクラスターパラメーターグループの説明を入力します。

1. クラスターパラメータグループを作成するには、[**作成**] を選択します。操作をキャンセルするには、[**キャンセル**] を選択します。

1. [**作成**] を選択すると、ページの上部に次のテキストが表示され、クラスターパラメータグループが正常に作成されたことを確認できます。

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

------