Eine Amazon DocumentDB DocumentDB-Instance neu starten

Gelegentlich müssen Sie Ihre Amazon DocumentDB DocumentDB-Instance möglicherweise neu starten, normalerweise aus Wartungsgründen. Wenn Sie bestimmte Änderungen vornehmen, z. B. die Clusterparametergruppe, die einem Cluster zugeordnet ist, müssen Sie die Instances im Cluster neu starten, damit die Änderungen wirksam werden. Sie können eine angegebene Instance mit dem AWS Management Console oder dem AWS CLI neu starten.

Durch den Neustart einer Instance wird der Datenbank-Engine-Service neu gestartet. Das Neustarten bewirkt einen vorübergehenden Nutzungsausfall, wobei der Status für die Instance währenddessen auf rebooting gesetzt wird. Ein Amazon DocumentDB DocumentDB-Ereignis wird erstellt, wenn der Neustart abgeschlossen ist.

Ein Neustart einer Instance führt nicht zu einem Failover. Verwenden Sie die Operation AWS Management Console oder, um ein Failover für einen Amazon DocumentDB-Cluster durchzuführen. AWS CLI failover-db-cluster Weitere Informationen finden Sie unter Amazon DocumentDB-Failover.

Sie können Ihre Instance nicht neu starten, wenn sie sich nicht im verfügbaren Zustand befindet. Ihre Datenbank kann aus mehreren Gründen nicht verfügbar sein, zum Beispiel aufgrund einer zuvor angeforderten Änderung oder einer Aktion im Wartungsfenster. Weitere Informationen zu Instance-Status finden Sie unter Den Status einer Amazon DocumentDB DocumentDB-Instance überwachen.

Using the AWS Management Console

Das folgende Verfahren startet eine Instance neu, die Sie unter Verwendung der Konsole angeben.

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. Klicken Sie im Navigationsbereich auf Cluster.

   Tipp

   Wenn der Navigationsbereich auf der linken Seite des Bildschirms nicht angezeigt wird, wählen Sie links oben auf der Seite das Menüsymbol () aus.

3. Im Cluster-Navigationsfeld sehen Sie die Spalte Cluster-ID. Ihre Instances werden unter Clustern aufgeführt, ähnlich wie in der Abbildung unten.

   

4. Markieren Sie das Kästchen links neben der Instanz, die Sie neu starten möchten.

5. Wählen Sie Actions (Aktionen), Reboot (Neustart) und dann Reboot (Neustart)aus, um den Neustart zu bestätigen.

Es dauert einige Minuten, bis Ihre Instance neu gestartet wird. Sie können die Instance nur verwenden, wenn ihr Status available ist. Sie können mit der Konsole oder der AWS CLI den Status der Instance überwachen. Weitere Informationen finden Sie unter Den Status einer Amazon DocumentDB DocumentDB-Instance überwachen.

Using the AWS CLI

Um eine Amazon DocumentDB DocumentDB-Instance neu zu starten, verwenden Sie den reboot-db-instance Vorgang mit dem --db-instance-identifier Parameter. Dieser Parameter gibt den Bezeichner für die Instance an, die neu gestartet werden soll.

Der folgende Code startet die Instance sample-instance neu.

Für Linux, macOS oder Unix:

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

Für Windows:

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

Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.

{
    "DBInstance": {
        "DBInstanceIdentifier": "sample-instance",
        "DBInstanceClass": "db.r5.large",
        "Engine": "docdb",
        "DBInstanceStatus": "rebooting",
        "Endpoint": {
            "Address": "sample-instance.node.us-east-1.docdb.amazonaws.com",
            "Port": 27017,   
            "HostedZoneId": "ABCDEFGHIJKLM"
        },
        "InstanceCreateTime": "2020-03-27T08:05:56.314Z",
        "PreferredBackupWindow": "02:00-02:30",
        "BackupRetentionPeriod": 1,
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-abcd0123",
                "Status": "active"
            }
        ],
        "AvailabilityZone": "us-east-1c",
        "DBSubnetGroup": {
            "DBSubnetGroupName": "default",
            "DBSubnetGroupDescription": "default",
            "VpcId": "vpc-abcd0123",
            "SubnetGroupStatus": "Complete",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-abcd0123",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1a"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-wxyz0123",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1b"
                    },
                    "SubnetStatus": "Active"
                }
            ]
        },
        "PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
        "PendingModifiedValues": {},
        "EngineVersion": "3.6.0",
        "AutoMinorVersionUpgrade": true,
        "PubliclyAccessible": false,
        "DBClusterIdentifier": "sample-cluster",
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:<accountID>:key/sample-key",
        "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "CACertificateIdentifier": "rds-ca-2019",
        "PromotionTier": 1,
        "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>:db:sample-instance",
        "EnabledCloudwatchLogsExports": [
            "profiler"
        ]
    }
}
                    

Es dauert einige Minuten, bis Ihre Instance neu gestartet wird. Sie können die Instance nur verwenden, wenn ihr Status available ist. Sie können mit der Konsole oder der AWS CLI den Status der Instance überwachen. Weitere Informationen finden Sie unter Den Status einer Amazon DocumentDB DocumentDB-Instance überwachen.