Amazon DocumentDB クラスターパラメータグループをリセットする

Amazon DocumentDB クラスターパラメータグループのパラメータ値の一部またはすべてをデフォルト値にリセットするには、 AWS Management Console または AWS Command Line Interface （AWS CLI) を使用してクラスターパラメータグループをリセットします。

Using the AWS Management Console

以下のステップに従って、クラスターパラメータグループのパラメータ値の一部または全部をデフォルト値にリセットします。

クラスターパラメータグループのパラメータ値をリセットするには

1. にサインインし AWS Management Console、https://console.aws.amazon.com/docdb で Amazon DocumentDB コンソールを開きます。

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

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

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

5. 結果の [クラスターパラメータグループのリセットの確認] ページで、そのパラメータグループのすべてのクラスターパラメータをデフォルトにリセットすることを確認します。次に、[リセット] を選択してパラメータグループをリセットします。[キャンセル] を選択して変更を破棄することもできます。

Using the AWS CLI

クラスターパラメータグループのパラメータ値の一部またはすべてをデフォルト値にリセットするには、次のパラメータを指定して reset-db-cluster-parameter-group オペレーションを使用します。

• --db-cluster-parameter-group-name — 必須。リセットするクラスターパラメータグループの名前。

• --parameters - オプション。デフォルト値にリセットするクラスターパラメータグループの ParameterName と ApplyMethod のリスト。次のインスタンスの再起動または reboot-db-instance リクエストで有効にするには、静的パラメータを pending-reboot に設定する必要があります。更新された静的パラメータを適用するクラスター内のすべてのインスタンスに対して、reboot-db-instance を呼び出す必要があります。

  このパラメータおよび --reset-all-parameters は相互に排他的です。いずれかを使用できますが、両方を使用することはできません。

• --reset-all-parameters または --no-reset-all-parameters - オプション。すべてのパラメータ (--reset-all-parameters) または一部のパラメータのみ (--no-reset-all-parameters) をデフォルト値にリセットするかどうかを指定します。--reset-all-parameters パラメータおよび --parameters は相互に排他的です。いずれかを使用できますが、両方を使用することはできません。

  グループ全体をリセットすると、動的パラメータはただちに更新されます。次のインスタンスの再起動または reboot-db-instance リクエストで有効にするには、静的パラメータを pending-reboot に設定します。更新された静的パラメータを適用するクラスター内のすべてのインスタンスに対して、reboot-db-instance を呼び出す必要があります。

例 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