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

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

AWS マネジメントコンソール または AWS Command Line Interface（AWS CLI）を使用してクラスターパラメータグループをリセットすることで、Amazon DocumentDB クラスターパラメータグループの一部またはすべてのパラメータ値をデフォルト値にリセットすることができます。

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

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

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

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

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

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

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

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

Using the AWS CLI

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

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

  • --parameters - オプション。デフォルト値にリセットするクラスターパラメータグループの ParameterName と ApplyMethod のリスト。次のインスタンスの再起動または 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 を呼び出す必要があります。

例 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: 指定されたパラメータをデフォルト値にリセットする

次のコードでは、クラスターパラメータグループ tls の sample-parameter-group パラメータをデフォルト値にリセットします。

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