Ändern einer Amazon DocumentDB Documente-Gruppe

Sie können dasAWS Management Console oder verwendenAWS CLI, um die Beschreibung einer Subnetzgruppe zu ändern oder Subnetze zu einer Amazon DocumentDB-Subnetzgruppe hinzuzufügen oder zu entfernen. Sie können die default-Subnetzgruppe jedoch nicht ändern.

Using the AWS Management Console

Sie können die AWS Management Console verwenden, um die Beschreibung eines Subnetzes zu ändern oder um Subnetze hinzuzufügen oder zu entfernen. Denken Sie daran, dass beim Abschluss des Vorgangs mindestens zwei Availability Zones mit Ihrer Subnetzgruppe verbunden sein müssen.

So ändern Sie Ihre Subnetzgruppe

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

2. Wählen Sie im Navigationsbereich Subnetzgruppe aus. Klicken Sie dann auf die Schaltfläche links neben dem Namen der Subnetzgruppe. Denken Sie daran, dass Sie die default-Subnetzgruppe nicht ändern können.

   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. Wählen Sie Actions (Aktionen) und dann Modify (Ändern) aus.

4. Beschreibung — Um die Beschreibung Ihrer Subnetzgruppe zu ändern, geben Sie eine neue Beschreibung ein.

5. Wenn Sie die mit Ihrer Subnetzgruppe verbundenen Subnetze ändern möchten, führen Sie im Abschnitt Add subnets (Subnetze hinzufügen) eine oder mehrere der folgenden Aktionen durch:

   • Um alle Subnetze aus dieser Subnetzgruppe zu entfernen, wählen Sie Remove all (Alle entfernen) aus.

   • Wenn Sie bestimmte Subnetze aus dieser Subnetzgruppe entfernen möchten, wählen Sie für jedes einzelne Subnetz, das Sie entfernen möchten, Remove (Entfernen) aus.

   • Wenn Sie alle mit dieser VPC verbundenen Subnetze hinzufügen möchten, wählen Sie Add all the subnets related to this VPC (Alle zu dieser VPC gehörenden Subnetze hinzufügen) aus.

   • Wenn Sie bestimmte Subnetze zu dieser Subnetzgruppe hinzufügen möchten, führen Sie die folgenden Aufgaben für jede Availability Zone aus, der Sie ein Subnetz hinzufügen möchten.

     1. Availability Zone —Wählen Sie in der Liste eine neue Availability Zone aus.

     2. Subnetz —Wählen Sie in der Liste ein Subnetz aus der ausgewählten Availability Zone für diese Subnetzgruppe aus.

     3. Wählen Sie Add subnet (Subnetz hinzufügen) aus.

6. Im Bestätigungsdialogfeld:

   • Wählen Sie Modify (Ändern), um diese Änderungen an der Subnetzgruppe vorzunehmen.

   • Wenn die Subnetzgruppe unverändert bleiben soll, wählen Sie Cancel (Abbrechen) aus.

Using the AWS CLI

Sie können die AWS CLI verwenden, um die Beschreibung eines Subnetzes zu ändern oder um Subnetze hinzuzufügen oder zu entfernen. Denken Sie daran, dass beim Abschluss des Vorgangs mindestens zwei Availability Zones mit Ihrer Subnetzgruppe verbunden sein müssen. Es ist nicht möglich, die default- Subnetzgruppe zu ändern.

Parameter:

• --db-subnet-group-name—Erforderlich. Der Name der Amazon DocumentDB-Subnetzgruppe, die Sie ändern.

• --subnet-ids—Erforderlich. Eine Liste aller Subnetze, die nach dieser Änderung Teil der Subnetzgruppe sein sollen.

  Wichtig

  Alle Subnetze, die sich derzeit in der Subnetzgruppe befinden und die nicht in dieser Liste aufgeführt sind, werden aus der Subnetzgruppe entfernt. Wenn Sie Subnetze, die sich derzeit in der Subnetzgruppe befinden, beibehalten möchten, müssen Sie diese in die Liste aufnehmen.

• --db-subnet-group-description—Fakultativ. Beschreibung der Subnetzgruppe.

Der folgende Code ändert die Beschreibung und ersetzt die vorhandenen Subnetze durch die Subnetze subnet-991cb8d0, subnet-53ab3636 und subnet-29ab1025.

Für Linux, macOS oder Unix:

aws docdb modify-db-subnet-group \
    --db-subnet-group-name sample-subnet-group \
    --subnet-ids subnet-991cb8d0 subnet-53ab3636 subnet-29ab1025 \
    --db-subnet-group-description "Modified subnet group"

Für Windows:

aws docdb modify-db-subnet-group ^
    --db-subnet-group-name sample-subnet-group ^
    --subnet-ids subnet-991cb8d0 subnet-53ab3636 subnet-29ab1025 ^
    --db-subnet-group-description "Modified subnet group"

Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format). Beachten Sie, dass dies die gleiche Subnetzgruppe ist, die im Abschnitt Erstellen einer Amazon DocumentDB Documente-Gruppe erstellt wurde. Die Subnetze in der Subnetzgruppe werden jedoch durch die in der Operationmodify-db-subnet-group angegebenen ersetzt.

{
    "DBSubnetGroup": {
        "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group",
        "DBSubnetGroupDescription": "Modified subnet group",
        "SubnetGroupStatus": "Complete",
        "Subnets": [
            {
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1d"
                },
                "SubnetStatus": "Active",
                "SubnetIdentifier": "subnet-53ab3636"
            },
            {
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1b"
                },
                "SubnetStatus": "Active",
                "SubnetIdentifier": "subnet-991cb8d0"
            },
            {
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1f"
                },
                "SubnetStatus": "Active",
                "SubnetIdentifier": "subnet-29ab1025"
            }
        ],
        "VpcId": "vpc-91280df6",
        "DBSubnetGroupName": "sample-subnet-group"
    }
}