Amazon DocumentDB-Cluster-Parametergruppen zurücksetzen

Sie können einige oder alle Parameterwerte einer Amazon DocumentDB-Cluster-Parametergruppe auf ihre Standardwerte zurücksetzen, indem Sie das AWS Management Console oder das AWS Command Line Interface (AWS CLI) verwenden, um die Cluster-Parametergruppe zurückzusetzen.

Using the AWS Management Console

Führen Sie die folgenden Schritt aus, um einige oder alle Parameterwerte einer Cluster-Parametergruppe auf die Standardwerte zurückzusetzen.

So setzen Sie die Parameterwerte einer Cluster-Parametergruppe zurück

1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter https://console.aws.amazon.com/docdb.

2. Wählen Sie im Navigationsbereich auf der linken Seite der Konsole Parameter groups (Parametergruppen) aus.

3. Wählen Sie im Bereich Cluster parameter groups (Cluster-Parametergruppen) den Namen der Cluster-Parametergruppe aus, die Sie zurücksetzen möchten.

4. Wählen Sie Actions (Aktionen) und anschließend Reset (Zurücksetzen) aus, um diese Parametergruppe zurückzusetzen.

5. Bestätigen Sie auf der Seite Cluster parameter group reset confirmation (Zurücksetzen der Cluster-Parametergruppe bestätigen), dass Sie alle Cluster-Parameter für diese Parametergruppe auf die Standardwerte zurücksetzen möchten. Wählen Sie anschließend Reset (Zurücksetzen) aus, um die Parametergruppe zurückzusetzen. Sie können auch Cancel (Abbrechen) auswählen, um die Änderungen zu verwerfen.

Using the AWS CLI

Um einige oder alle Parameterwerte einer Cluster-Parametergruppe auf ihre Standardwerte zurückzusetzen, verwenden Sie die reset-db-cluster-parameter-group-Operation mit den folgenden Parametern.

• --db-cluster-parameter-group-name – Erforderlich. Der Name der zurückzusetzenden Cluster-Parametergruppe.

• --parameters— Fakultativ. Eine Liste von ParameterName und ApplyMethod in der Cluster-Parametergruppe, die auf ihre Standardwerte zurücksetzt werden sollen. Statische Parameter müssen auf pending-reboot gesetzt sein, damit sie beim nächsten Neustart der Instance oder reboot-db-instance-Anforderung wirksam werden. Sie müssen reboot-db-instance für alle Instances in Ihrem Cluster aufrufen, auf die der aktualisierte statische Parameter angewendet werden soll.

  Dieser Parameter und --reset-all-parameters schließen sich gegenseitig aus. Sie können jede der beiden Optionen verwenden, jedoch nicht beide.

• --reset-all-parametersoder --no-reset-all-parameters — Fakultativ. Gibt an, ob alle Parameter (--reset-all-parameters) oder nur einige der Parameter (--no-reset-all-parameters) auf ihre Standardwerte zurückgesetzt werden sollen. Der --reset-all-parameters-Parameter und --parameters schließen sich gegenseitig aus. Sie können jede der beiden Optionen verwenden, jedoch nicht beide.

  Wenn Sie die gesamte Gruppe zurücksetzen, werden dynamische Parameter sofort aktualisiert. Statische Parameter werden auf pending-reboot festgelegt, damit sie beim nächsten Neustart der Instance oder bei der nächsten reboot-db-instance-Anforderung wirksam werden. Sie müssen reboot-db-instance für alle Instances in Ihrem Cluster aufrufen, auf die der aktualisierte statische Parameter angewendet werden soll.

Beispiel 1: Zurücksetzen aller Parameter auf ihre Standardwerte

Der folgende Code setzt alle Parameter in der Cluster-Parametergruppe sample-parameter-group auf ihre Standardwerte zurück.

Für Linux, macOS oder Unix:

aws docdb reset-db-cluster-parameter-group \
       --db-cluster-parameter-group-name sample-parameter-group \
       --reset-all-parameters

Für Windows:

aws docdb reset-db-cluster-parameter-group ^
       --db-cluster-parameter-group-name sample-parameter-group ^
       --reset-all-parameters

Beispiel 2: Zurücksetzen von angegebenen Parametern auf ihre Standardwerte

Der folgende Code setzt den tls-Parameter in der Cluster-Parametergruppe sample-parameter-group auf seinen Standardwert zurück.

Für Linux, macOS oder 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

Für 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

Die Ausgabe dieses Vorgangs sieht etwa wie folgt aus (JSONFormat).

{
       "DBClusterParameterGroupName": "sample-parameter-group"
   }

Neustarten einer Cluster-Instance

Bevor ein statischer Parameterwert geändert wird, muss die Cluster-Instance neu gestartet werden. Starten Sie alle Instances in Ihrem Cluster neu, auf die der aktualisierte statische Parameter angewendet werden soll.

Für Linux, macOS oder Unix:

aws docdb reboot-db-instance \
       --db-instance-identifier sample-cluster-instance

Für Windows:

aws docdb reboot-db-instance ^
       --db-instance-identifier sample-cluster-instance