Ändern einer Amazon DocumentDB-Instance

Sie können Ihre Amazon DocumentDB-Instance entweder über die AWS Management Console oder die ändern AWS CLI. Nur Instances im Status available können geändert werden. Eine angehaltene Instance kann nicht geändert werden. Wenn der Cluster angehalten ist, starten Sie zuerst den Cluster, warten Sie, bis die Instance verfügbar wird, und nehmen Sie dann die gewünschten Änderungen vor. Weitere Informationen finden Sie unter Einen Amazon DocumentDB-Cluster stoppen und starten.

Using the AWS Management Console

Führen Sie die folgenden Schritte aus, um eine bestimmte Amazon DocumentDB-Instance mithilfe der Konsole zu ändern.

1. Melden Sie sich bei der an AWS Management Consoleund öffnen Sie die Amazon 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 Navigationsfeld Cluster sehen Sie die Spalte Cluster-ID . Ihre Instances sind unter Cluster aufgeführt, ähnlich wie im folgenden Screenshot.

   

4. Aktivieren Sie das Kontrollkästchen links neben der Instance, die Sie ändern möchten.

5. Wählen Sie Actions (Aktionen) und dann Modify (Ändern) aus.

6. Nehmen Sie im Bereich Modify instance: <instance-name> (Instance ändern: <instance-name>) die gewünschten Änderungen vor. Sie können die folgenden Änderungen ausführen:

   • Instance-Spezifikationen – Die Instance-ID und -Klasse. Benennungseinschränkungen für Instance-IDs:

     • Instance-Kennung – Geben Sie einen Namen ein, der für alle Instances, die Ihrem AWS-Konto in der aktuellen Region gehören, eindeutig ist. Die Instance-ID muss [1–63] alphanumerische Zeichen oder Bindestriche enthalten, einen Buchstaben als erstes Zeichen haben und darf nicht mit einem Bindestrich enden oder zwei aufeinanderfolgende Bindestriche enthalten.

     • Instance-Klasse – Wählen Sie im Dropdown-Menü eine Instance-Klasse für Ihre Amazon DocumentDB-Instance aus. Weitere Informationen finden Sie unter Verwalten von Instance-Klassen.

   • Zertifizierungsstelle – Serverzertifikat für diese Instance. Weitere Informationen finden Sie unter Aktualisierung Ihrer Amazon DocumentDB-TLS-Zertifikate.

   • Failover – Während des Failovers wird die Instance mit der höchsten Hochstufungsstufe zur primären Instance hochgestuft. Weitere Informationen finden Sie unter Amazon DocumentDB DocumentDB-Failover.

   • Wartung – Das Wartungsfenster, in dem ausstehende Änderungen oder Patches auf Instances im Cluster angewendet werden.

7. Wenn Sie fertig sind, wählen Sie Continue (Weiter) aus, um eine Zusammenfassung Ihrer Änderungen anzuzeigen.

8. Nachdem Sie Ihre Änderungen überprüft haben, können Sie diese sofort oder während des nächsten Wartungsfensters unter Scheduling of modifications (Planen von Änderungen) anwenden. Klicken Sie auf Modify instance (Instance ändern), um Ihre Änderungen zu speichern. Alternativ können Sie auf Cancel (Abbrechen) klicken, um Ihre Änderungen zu verwerfen.

Es dauert einige Minuten, bis Ihre Änderungen übernommen werden. 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 Überwachung des Status einer Amazon DocumentDB DocumentDB-Instance.

Using the AWS CLI

Um eine bestimmte Amazon DocumentDB-Instance mithilfe der zu ändern AWS CLI, verwenden Sie die modify-db-instance mit den folgenden Parametern. Weitere Informationen finden Sie unter ModifyDBInstance. Der folgende Code ändert die Instance-Klasse für die Instance sample-instance in db.r5.large.

Parameter

• --db-instance-identifier – Erforderlich. Die Kennung der zu ändernden Instance.

• --db-instance-class – Optional. Die neue Rechen- und Speicherkapazität der Instance, z. B. db.r5.large. Nicht alle Instance-Klassen sind in allen verfügbar AWS-Regionen. Wenn Sie die Instance-Klasse ändern, kommt es während der Änderung zu einem Ausfall. Die Änderung wird während des nächsten Wartungsfensters angewendet, es sei denn, für diese Anforderung ApplyImmediately wird als wahr angegeben.

• --apply-immediately oder --no-apply-immediately – Optional. Gibt an, ob diese Änderung sofort angewandt oder bis zum nächsten Wartungszeitraum verschoben werden sollte. Wenn dieser Parameter weggelassen wird, wird die Änderung im nächsten Wartungszeitraum ausgeführt.

Für Linux, macOS oder Unix:

aws docdb modify-db-instance \
       --db-instance-identifier sample-instance \
       --db-instance-class db.r5.large \
       --apply-immediately

Für Windows:

aws docdb modify-db-instance ^
       --db-instance-identifier sample-instance ^
       --db-instance-class db.r5.large ^
       --apply-immediately

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

{
    "DBInstances": [
        {
            "DBInstanceIdentifier": "sample-instance-1",
            "DBInstanceClass": "db.r5.large",
            "Engine": "docdb",
            "DBInstanceStatus": "modifying",
            "Endpoint": {                     
                "Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com",
                "Port": 27017,   
                "HostedZoneId": "ABCDEFGHIJKLM"
            },
            "InstanceCreateTime": "2020-01-10T22:18:55.921Z",
            "PreferredBackupWindow": "02:00-02:30",
            "BackupRetentionPeriod": 1,
            "VpcSecurityGroups": [
                {                             
                    "VpcSecurityGroupId": "sg-abcd0123",
                    "Status": "active"
                }
            ],
            "AvailabilityZone": "us-east-1a",
            "DBSubnetGroup": {
                "DBSubnetGroupName": "default",
                "DBSubnetGroupDescription": "default",
                "VpcId": "vpc-abcd0123",
                "SubnetGroupStatus": "Complete",
                "Subnets": [
                    {
                        "SubnetIdentifier": "subnet-abcd0123",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1a"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-abcd0123",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1b"
                        },
                        "SubnetStatus": "Active"
                    }
                ]
            },
            "PreferredMaintenanceWindow": "sun:10:57-sun:11:27",
            "PendingModifiedValues": {
                "DBInstanceClass": "db.r5.large"
            },
            "EngineVersion": "3.6.0",
            "AutoMinorVersionUpgrade": true,
            "PubliclyAccessible": false,
            "DBClusterIdentifier": "sample-cluster",
            "StorageEncrypted": true,
            "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
            "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
            "CACertificateIdentifier": "rds-ca-2019",
            "PromotionTier": 1,                     
            "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1",
            "EnabledCloudwatchLogsExports": [
                "profiler"
            ]
        }
    ]
}

Es dauert einige Minuten, bis Ihre Änderungen angewendet werden. Sie können die Instance nur verwenden, wenn ihr Status available ist. Sie können den Status der Instance mit der AWS Management Console oder der überwachen AWS CLI. Weitere Informationen finden Sie unter Überwachung des Status einer Amazon DocumentDB DocumentDB-Instance.