Amazon DocumentDB クラスターパラメータグループをコピーする - Amazon DocumentDB

Amazon DocumentDB クラスターパラメータグループをコピーする

Amazon DocumentDB のクラスターパラメータグループのコピーは、AWS マネジメントコンソール または AWS Command Line Interface（AWS CLI）を使用して作成できます。

Using the AWS マネジメントコンソール

以下の手順では、既存のクラスターパラメータグループのコピーを作成して、新しいクラスターパラメータグループを作成する手順について説明します。

クラスターパラメータグループをコピーするには

  1. AWS マネジメントコンソール にサインインして、Amazon DocumentDB コンソール https://console.aws.amazon.com/docdb を開いてください。

  2. ナビゲーションペインで、[パラメータグループ] を選択します。

  3. [クラスターパラメータグループ] ペインで、コピーするクラスターパラメータグループの名前を選択します。

  4. [アクション] を選択し、[コピー] を選択して、そのパラメータグループをコピーします。

  5. [コピーのオプション] で、新しいクラスターパラメータグループの名前と説明を入力します。次に、[コピー] を選択して変更を保存します。

Using the AWS CLI

クラスターパラメータグループのコピーを作成するには、以下のパラメータを指定して copy-db-cluster-parameter-group オペレーションを使用します。

  • --source-db-cluster-parameter-group-identifier — 必須。コピーを作成するクラスターパラメータグループの名前または Amazon リソースネーム (ARN)。

    ソースとターゲットのクラスターパラメータグループが同じ AWS リージョン である場合、識別子は名前、または ARN のいずれかになります。

    ソースとターゲットのクラスターパラメータグループが異なる AWS リージョン である場合、識別子は ARN である必要があります。

  • --target-db-cluster-parameter-group-identifier — 必須。クラスターパラメータグループコピーの名前または ARN。

    制約:

    • null、空、または空白にすることはできません。

    • 1 ～ 255 の英字、数字、またはハイフンを含む必要があります。

    • 1 字目は英字である必要があります。

    • ハイフンを、文字列の最後に使用したり、2 つ続けて使用したりすることはできません。

  • --target-db-cluster-parameter-group-description — 必須。クラスターパラメータグループのコピーについてユーザーが入力する説明。

次のコードは、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"
    }
}