Modification d'un groupe de sous-réseaux Amazon DocumentDB

Vous pouvez utiliser leAWS Management Console ouAWS CLI pour modifier la description d'un groupe de sous-réseaux ou pour ajouter ou supprimer des sous-réseaux d'un groupe de sous-réseaux Amazon DocumentDB. Toutefois, vous ne pouvez pas modifier le groupe de sous-réseaux default.

Using the AWS Management Console

Vous pouvez utiliser la AWS Management Console pour modifier la description d’un groupe de sous-réseaux ou pour ajouter ou supprimer des sous-réseaux. Souvenez-vous que lorsque vous avez terminé, vous devez disposer d'au moins deux zones de disponibilité associées à votre groupe de sous-réseaux.

Pour modifier votre groupe de sous-réseaux

1. Connectez-vous à laAWS Management Console et ouvrez la console Amazon DocumentDB à l'adresse https://console.aws.amazon.com/docdb.

2. Dans le panneau de navigation, choisissez Subnet groups (Groupes de sous-réseaux). Choisissez ensuite le bouton situé à gauche du nom du groupe de sous-réseaux. Souvenez-vous que vous ne pouvez pas modifier le groupe de sous-réseaux default.

   Astuce

   Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu () dans le coin supérieur gauche de la page.

3. Choisissez Actions, puis Modify (Modifier).

4. Description —Pour modifier la description de votre groupe de sous-réseaux, entrez une nouvelle description.

5. Pour modifier les sous-réseaux associés à votre groupe de sous-réseaux, effectuez l’une des actions suivantes dans la section Add subnets (Ajouter des sous-réseaux) :

   • Pour supprimer tous les sous-réseaux de ce groupe, choisissez Remove all (Supprimer tout).

   • Pour supprimer des sous-réseaux spécifiques de ce groupe, choisissez Remove (Supprimer) pour chaque sous-réseau à supprimer.

   • Pour ajouter tous les sous-réseaux associés à ce VPC, choisissez Add all the subnets related to this VPC (Ajouter tous les sous-réseaux associés à ce VPC).

   • Pour ajouter des sous-réseaux spécifiques à ce groupe, procédez comme suit pour chaque zone de disponibilité à laquelle vous souhaitez ajouter un sous-réseau.

     1. Zone de disponibilité : dans la liste, choisissez une nouvelle zone de disponibilité.

     2. Sous-réseau —Dans la liste, choisissez un sous-réseau dans la zone de disponibilité choisie pour ce groupe de sous-réseaux.

     3. Sélectionnez Add subnet (Ajouter le sous-réseau).

6. Dans la boîte de dialogue de confirmation :

   • Pour appliquer ces modifications au groupe de sous-réseaux, choisissez Modify (Modifier).

   • Pour ne pas les appliquer, choisissez Cancel (Annuler).

Using the AWS CLI

Vous pouvez utiliser la AWS CLI pour modifier la description d’un groupe de sous-réseaux ou pour ajouter ou supprimer des sous-réseaux. Souvenez-vous que lorsque vous avez terminé, vous devez disposer d'au moins deux zones de disponibilité associées à votre groupe de sous-réseaux. Vous ne pouvez pas modifier le groupe de sous-réseaux default.

Paramètres :

• --db-subnet-group-name : obligatoire. Nom du groupe de sous-réseaux Amazon DocumentDB que vous modifiez.

• --subnet-ids : obligatoire. Liste de tous les sous-réseaux qui doivent être dans le groupe de sous-réseaux une fois que cette modification est effectuée.

  Important

  Tous les sous-réseaux qui se trouvent actuellement dans le groupe de sous-réseaux et qui ne sont pas inclus dans cette liste seront supprimés du groupe. Si vous souhaitez conserver les sous-réseaux actuellement présents dans le groupe de sous-réseaux, incluez-les dans cette liste.

• --db-subnet-group-description—Facultatif. La description du groupe de sous-réseaux.

Le code suivant modifie la description et remplace les sous-réseaux existants par les sous-réseaux subnet-991cb8d0, subnet-53ab3636 et subnet-29ab1025.

Pour Linux, macOS ou 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"

Pour 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"

La sortie de cette opération ressemble à ceci (format JSON). Notez qu'il s'agit du groupe de sous-réseaux qui a été créé dans la section Création d'un groupe de sous-réseaux Amazon DocumentDB. Cependant, les sous-réseaux du groupe de sous-réseaux sont remplacés par ceux qui sont répertoriés dans l'opération modify-db-subnet-group.

{
    "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"
    }
}