Modificación de un grupo de subredes de Amazon DocumentDB

Puede utilizar la AWS Management Console o la AWS CLI para modificar la descripción de un grupo de subredes o para añadir o eliminar subredes de un grupo de subredes de Amazon DocumentDB. Sin embargo, no puede modificar el grupo de subredes default.

Using the AWS Management Console

Puede utilizar la AWS Management Console para cambiar la descripción de un grupo de subredes o para añadir o eliminar subredes. Recuerde que, cuando termine, debe tener al menos dos zonas de disponibilidad asociadas al grupo de subredes.

Para modificar un grupo de subredes

1. Inicie sesión en la AWS Management Console y abra la consola de Amazon DocumentDB en https://console.aws.amazon.com/docdb.

2. En el panel de navegación, elija Subnet groups. A continuación, elija el botón situado a la izquierda del nombre del grupo de subredes. Recuerde que no puede modificar el grupo de subredes default.

   sugerencia

   Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú () en la esquina superior izquierda de la página.

3. Elija Actions (Acciones) y después Modify (Modificar).

4. Descripción: para cambiar la descripción del grupo de subredes, introduzca una descripción nueva.

5. Para cambiar las subredes asociadas a un grupo de subredes, realice uno o varios de los siguientes pasos en la sección Add subnets (Añadir subredes):

   • Para eliminar todas las subredes de este grupo de subredes, seleccione Remove all (Eliminar todo).

   • Para eliminar subredes específicas de este grupo de subredes, seleccione Remove (Eliminar) en cada subred que desee eliminar.

   • Para añadir todas las subredes asociadas a esta VPC, seleccione Add all the subnets related to this VPC (Añadir todas las subredes asociadas a esta VPC).

   • Para añadir subredes específicas a este grupo de subredes, realice los siguientes pasos para cada zona de disponibilidad para la que desee añadir una subred.

     1. Zona de disponibilidad: de la lista, elija una nueva zona de disponibilidad.

     2. Subred: de la lista, elija una subred de la zona de disponibilidad elegida para este grupo de subredes.

     3. Seleccione Add subnet (Añadir subred).

6. En el cuadro de diálogo de confirmación:

   • Para hacer estos cambios en el grupo de subredes, elija Modify (Modificar).

   • Para que el grupo de subredes permanezca sin modificaciones, seleccione Cancel (Cancelar).

Using the AWS CLI

Puede utilizar la AWS CLI para cambiar la descripción de un grupo de subredes o para añadir o eliminar subredes. Recuerde que, cuando termine, debe tener al menos dos zonas de disponibilidad asociadas al grupo de subredes. No se puede modificar el grupo de subredes default.

Parámetros:

• --db-subnet-group-name: obligatorio. Nombre del grupo de subredes de Amazon DocumentDB que está modificando.

• --subnet-ids: obligatorio. Lista de las subredes que debe haber en el grupo de subredes después de realizar este cambio.

  importante

  Cualquier subred que actualmente se encuentre en el grupo de subredes y que no se incluya en esta lista se eliminará del grupo de subredes. Si desea mantener cualquiera de las subredes que actualmente se encuentra en el grupo de subredes, debe incluirla en esta lista.

• --db-subnet-group-description: opcional. Descripción del grupo de subredes.

El siguiente código modifica la descripción y sustituye las subredes existentes por las subredes subnet-991cb8d0, subnet-53ab3636 y subnet-29ab1025.

Para Linux, macOS o 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"

Para 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 salida de esta operación será similar a lo que se indica a continuación (formato JSON). Tenga en cuenta que este es el mismo grupo de subredes que se creó en la sección Creación de un grupo de subredes de Amazon DocumentDB. Sin embargo, las subredes del grupo de subredes se sustituyen por las que se muestran en la operación 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"
    }
}