Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Administración de grupos de subredes de Amazon DocumentDB
Una nube privada virtual (VPC) es una red virtual dedicada para su Cuenta de AWS. Esta infraestructura en la nube está aislada lógicamente de otras redes virtuales de la nube de AWS. Puede lanzar sus recursos de AWS como por ejemplo clústeres de Amazon DocumentDB en su VPC de Amazon. Puede especificar un intervalo de direcciones IP para la VPC, añadir subredes, asociar grupos de seguridad y configurar tablas de ruteo.
Una subred es un rango de direcciones IP en su VPC de Amazon. Puede lanzar recursos de AWS en una subred especificada. Utilice una subred *pública* para los recursos que deben conectarse a Internet. Utilice una subred *privada* para los recursos que no dispondrán de conexión a Internet. Para obtener más información sobre subredes públicas y privadas, consulte [Conceptos básicos de VPC y subredes](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#vpc-subnet-basics) en la *Guía de usuario de la Nube privada virtual de Amazon*.
Un grupo de subredes de base de datos es una colección de subredes que se crean en una VPC y que después se asignan a los clústeres. Un grupo de subredes le permite especificar una VPC determinada a la hora de crear clústeres. Si utiliza el grupo de subredes `default`, este abarca todas las subredes de la VPC.
Cada grupo de subredes de base de datos debe tener subredes como mínimo en dos zonas de disponibilidad de una región de determinada. Cuando crea un clúster de base de datos en una VPC, debe elegir un grupo de subredes de base de datos. Amazon DocumentDB utiliza ese grupo de subredes de base de datos y su zona de disponibilidad preferida para seleccionar una subred y una dirección IP dentro de esa subred con el fin de asociarla al clúster. Si se produce un error en la instancia principal, Amazon DocumentDB puede promover una instancia de réplica correspondiente para que se convierta en la nueva instancia principal. A continuación, puede crear una nueva instancia de réplica utilizando una dirección IP de la subred en la que se encontraba la instancia principal anterior.
Cuando Amazon DocumentDB crea una instancia en una VPC, asigna una interfaz de red al clúster utilizando la dirección IP seleccionada del grupo de subredes de base de datos. Recomendamos que utilice el nombre de DNS, ya que la dirección IP subyacente puede cambiar durante la conmutación por error. Para obtener más información, consulte [Puntos de conexión de Amazon DocumentDB](how-it-works.md#how-it-works.endpoints).
Para obtener información sobre la creación de su propia VPC y sus subredes, consulte [Uso de VPC y subredes](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html) en la *Guía del usuario de la nube privada virtual de Amazon*.
**Topics**
+ [Creación de un grupo de subredes de Amazon DocumentDB](document-db-subnet-group-create.md)
+ [Descripción de un grupo de subredes de Amazon DocumentDB](document-db-subnet-group-describe.md)
+ [Modificación de un grupo de subredes de Amazon DocumentDB](document-db-subnet-group-modify.md)
+ [Eliminación de un grupo de subredes de Amazon DocumentDB](document-db-subnet-group-delete.md)
# Creación de un grupo de subredes de Amazon DocumentDB
Al crear un clúster de Amazon DocumentDB, debe elegir una VPC de Amazon y el grupo de subredes correspondiente dentro de la VPC de Amazon para lanzar el clúster. Las subredes determinan la zona de disponibilidad y el rango de direcciones IP de la zona de disponibilidad que se deben utilizar para lanzar una instancia.
Un subgrupo de subredes es un determinado grupo de subredes (o AZ) que le permite especificar las zonas de disponibilidad que desea utilizar para lanzar instancias de Amazon DocumentDB. Por ejemplo, en un clúster con tres instancias, se recomienda que cada una de dichas instancias esté aprovisionada en una zona de disponibilidad (AZ) distinta, al hacerlo, optimiza la alta disponibilidad. De esa forma, si una de las AZ falla, solo se verá afectada una sola instancia.
Actualmente, las instancias de Amazon DocumentDB pueden aprovisionarse en hasta tres zonas de disponibilidad. Aunque un grupo de subredes tenga más de tres subredes, solo podrá utilizar tres de esas subredes para crear un clúster de Amazon DocumentDB. Por ello, es recomendable que al crear un grupo de subredes solo elija las tres subredes en las que desee implementar las instancias.
Por ejemplo: se crea un clúster y Amazon DocumentDB elige las AZ \$11A, 1B y 1C\$1. Si intenta crear una instancia en la AZ \$11D\$1, la llamada a la API no funcionará correctamente. Sin embargo, si decide crear una instancia sin especificar la zona de disponibilidad concreta, Amazon DocumentDB elegirá una zona de disponibilidad por usted. Amazon DocumentDB utiliza un algoritmo para equilibrar la carga de las instancias en las AZ para ayudarle a obtener una alta disponibilidad. Si se aprovisionan tres instancias, de forma predeterminada se repartirán entre tres zonas de disponibilidad en lugar de aprovisionar todas ellas en una única AZ.
Prácticas recomendadas
+ A menos que tenga un motivo específico, cree siempre un grupo de subredes con tres subredes. Lo anterior asegurará que los clústeres con tres o más instancias podrán lograr una mayor disponibilidad, debido a que las instancias se aprovisionarán en tres zonas de disponibilidad.
+ Reparta siempre las instancias en varias zonas de disponibilidad para lograr una alta disponibilidad. Nunca ponga todas las instancias de un clúster en una única zona de disponibilidad.
+ Debido a que pueden producirse eventos de conmutación por error en cualquier momento, no debe dar por hecho que una instancia principal o las instancias de réplica siempre estarán en una AZ determinada.
## Cómo crear un grupo de subredes
Puede utilizar la Consola de administración de AWS o la AWS CLI para crear un grupo de subredes de Amazon DocumentDB:
------
#### [ Using the Consola de administración de AWS ]
Siga los siguientes pasos para crear un grupo de subredes de Amazon DocumentDB.
**Creación de un grupo de subredes de Amazon DocumentDB**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon DocumentDB en [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. En el panel de navegación, elija **Subnet groups (Grupos de subredes)**y, a continuación, elija **Create (Crear)**.
**sugerencia**
Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-menu-icon.png)) en la esquina superior izquierda de la página.
1. En la página **Create subnet group (Crear grupo de subredes)**:
1. En la sección **Subnet group details (Detalles del grupo de subredes)**:
1. **Nombre**: introduzca un nombre significativo para el grupo de la subred.
1. **Description (Descripción)**: introduzca una descripción del grupo de subredes.
1. En la sección **Add subnets (Añadir subredes)**:
1. **VPC**: elija una VPC de la lista, para este grupo de subredes.
1. Realice una de las siguientes acciones:
+ Para incluir todas las subredes en la VPC seleccionada, elija **Add all the subnets related to this VPC (Añadir todas las subredes asociadas a esta VPC)**.
+ Para especificar subredes para este grupo de subredes, realice los pasos siguientes para cada zona de disponibilidad para la que desee incluir subredes. Debe incluir al menos dos zonas de disponibilidad.
1. **Zona de disponibilidad**: de la lista, elija una zona de disponibilidad.
1. **Subred**: de la lista, elija una subred de la zona de disponibilidad elegida para este grupo de subredes.
1. Seleccione **Add subnet (Añadir subred)**.
1. Seleccione **Crear**. Cuando se crea el grupo de subredes, se muestra junto con los demás grupos de subredes.
![\[Captura de pantalla que muestra los detalles de un grupo de subredes.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-subnet-groups-list.png)
------
#### [ Using the AWS CLI ]
Para poder crear un grupo de subredes mediante la AWS CLI, primero debe determinar qué subredes se encuentran disponibles. Ejecute la siguiente operación de la AWS CLI para ver una lista de las zonas de disponibilidad y sus subredes.
**Parámetros:**
+ **--db-subnet-group**: opcional. Si especifica un grupo de subredes concreto, puede ver las zonas de disponibilidad y las subredes de dicho grupo. Si omite este parámetro, puede ver las zonas de disponibilidad y las subredes de todos los grupos de subredes. Si especifica el grupo de subredes `default` puede ver todas las subredes de la VPC.
**Example**
Para Linux, macOS o Unix:
```
aws docdb describe-db-subnet-groups \
--db-subnet-group-name default \
--query 'DBSubnetGroups[*].[DBSubnetGroupName,Subnets[*].[SubnetAvailabilityZone.Name,SubnetIdentifier]]'
```
Para Windows:
```
aws docdb describe-db-subnet-groups ^
--db-subnet-group-name default ^
--query 'DBSubnetGroups[*].[DBSubnetGroupName,Subnets[*].[SubnetAvailabilityZone.Name,SubnetIdentifier]]'
```
La salida de esta operación será similar a lo que se indica a continuación (formato JSON).
```
[
[
"default",
[
[
"us-east-1a",
"subnet-4e26d263"
],
[
"us-east-1c",
"subnet-afc329f4"
],
[
"us-east-1e",
"subnet-b3806e8f"
],
[
"us-east-1d",
"subnet-53ab3636"
],
[
"us-east-1b",
"subnet-991cb8d0"
],
[
"us-east-1f",
"subnet-29ab1025"
]
]
]
]
```
Si utiliza el resultado de la operación anterior, puede crear un nuevo grupo de subredes. El grupo de subredes nuevo debe incluir subredes de al menos dos zonas de disponibilidad.
**Parámetros:**
+ **--db-subnet-group-name**: obligatorio. Nombre de este grupo de subredes.
+ **--db-subnet-group-description**: obligatorio. Descripción de este grupo de subredes.
+ **--subnet-ids**: obligatorio. Lista de las subredes que se van a incluir en este grupo de subredes. Ejemplo: : `subnet-53ab3636`.
+ –Etiquetas****: opcional. Lista de las etiquetas (pares clave-valor) que se van a asociar a este grupo de subredes.
El código siguiente crea el grupo de subredes `sample-subnet-group` con tres subredes, `subnet-4e26d263`, `subnet-afc329f4` y `subnet-b3806e8f`.
Para Linux, macOS o Unix:
```
aws docdb create-db-subnet-group \
--db-subnet-group-name sample-subnet-group \
--db-subnet-group-description "A sample subnet group" \
--subnet-ids subnet-4e26d263 subnet-afc329f4 subnet-b3806e8f \
--tags Key=tag1,Value=One Key=tag2,Value=2
```
Para Windows:
```
aws docdb create-db-subnet-group ^
--db-subnet-group-name sample-subnet-group ^
--db-subnet-group-description "A sample subnet group" ^
--subnet-ids subnet-4e26d263 subnet-afc329f4 subnet-b3806e8f ^
--tags Key=tag1,Value=One Key=tag2,Value=2
```
La salida de esta operación será similar a lo que se indica a continuación (formato JSON).
```
{
"DBSubnetGroup": {
"DBSubnetGroupDescription": "A sample subnet group",
"DBSubnetGroupName": "sample-subnet-group",
"Subnets": [
{
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetIdentifier": "subnet-4e26d263",
"SubnetStatus": "Active"
},
{
"SubnetAvailabilityZone": {
"Name": "us-east-1c"
},
"SubnetIdentifier": "subnet-afc329f4",
"SubnetStatus": "Active"
},
{
"SubnetAvailabilityZone": {
"Name": "us-east-1e"
},
"SubnetIdentifier": "subnet-b3806e8f",
"SubnetStatus": "Active"
}
],
"VpcId": "vpc-91280df6",
"DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group",
"SubnetGroupStatus": "Complete"
}
}
```
------
# Descripción de un grupo de subredes de Amazon DocumentDB
Puede utilizar la Consola de administración de AWS o la AWS CLI para obtener detalles de un grupo de subredes de Amazon DocumentDB.
------
#### [ Using the Consola de administración de AWS ]
En el siguiente procedimiento se muestra cómo obtener detalles de un grupo de subredes de Amazon DocumentDB.
**Para obtener los detalles de un grupo de subredes**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon DocumentDB en [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. En el panel de navegación, elija **Subnet groups (grupos de subredes)**.
**sugerencia**
Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-menu-icon.png)) en la esquina superior izquierda de la página.
1. Para consultar los detalles de un grupo de subredes seleccione el nombre de dicho grupo.
![\[Captura de pantalla que muestra los detalles de un grupo de subredes.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-subnet-group-details.png)
------
#### [ Using the AWS CLI ]
Para obtener los detalles de un grupo de subredes de Amazon DocumentDB, utilice la operación `describe-db-subnet-groups` con el siguiente parámetro.
**Parámetro**
+ `--db-subnet=group-name`: opcional. Si se incluye, se muestran los detalles del grupo de subredes nombrado. Si se omite, se muestran los detalles de hasta 100 grupos de subredes.
**Example**
El siguiente código muestra los detalles del grupo de subredes `sample-subnet-group` que creamos en la sección [Creación de un grupo de subredes de Amazon DocumentDB](document-db-subnet-group-create.md).
Para Linux, macOS o Unix:
```
aws docdb describe-db-subnet-groups \
--db-subnet-group-name sample-subnet-group
```
Para Windows:
```
aws docdb describe-db-subnet-groups ^
--db-subnet-group-name sample-subnet-group
```
La salida de esta operación será similar a lo que se indica a continuación (formato JSON).
```
{
"DBSubnetGroup": {
"DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group",
"VpcId": "vpc-91280df6",
"SubnetGroupStatus": "Complete",
"DBSubnetGroupName": "sample-subnet-group",
"Subnets": [
{
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active",
"SubnetIdentifier": "subnet-4e26d263"
},
{
"SubnetAvailabilityZone": {
"Name": "us-east-1c"
},
"SubnetStatus": "Active",
"SubnetIdentifier": "subnet-afc329f4"
},
{
"SubnetAvailabilityZone": {
"Name": "us-east-1e"
},
"SubnetStatus": "Active",
"SubnetIdentifier": "subnet-b3806e8f"
}
],
"DBSubnetGroupDescription": "A sample subnet group"
}
}
```
------
# Modificación de un grupo de subredes de Amazon DocumentDB
Puede utilizar la Consola de administración de AWS 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 Consola de administración de AWS ]
Puede utilizar la Consola de administración de AWS 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 Consola de administración de AWS y abra la consola de Amazon DocumentDB en [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. En el panel de navegación, elija **Subnet groups (grupos de subredes)**. 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ú (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-menu-icon.png)) en la esquina superior izquierda de la página.
1. Elija **Actions (Acciones)** y después **Modify (Modificar)**.
1. **Descripción**: para cambiar la descripción del grupo de subredes, introduzca una descripción nueva.
1. 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.
1. **Subred**: de la lista, elija una subred de la zona de disponibilidad elegida para este grupo de subredes.
1. Seleccione **Add subnet (Añadir subred)**.
1. 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.
**Example**
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](document-db-subnet-group-create.md). 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"
}
}
```
------
# Eliminación de un grupo de subredes de Amazon DocumentDB
Puede utilizar la Consola de administración de AWS o la AWS CLI para eliminar un grupo de subredes de Amazon DocumentDB. Sin embargo, no puede eliminar el grupo de subredes `default`.
------
#### [ Using the Consola de administración de AWS ]
Puede utilizar la Consola de administración de AWS para eliminar un grupo de subredes. Sin embargo, no se puede eliminar el grupo de subredes `default`.
**Para eliminar un grupo de subredes**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon DocumentDB en [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. En el panel de navegación, elija **Subnet groups (grupos de subredes)**. A continuación, elija el botón situado a la izquierda del nombre del grupo de subredes. Recuerde que no puede eliminar 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ú (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-menu-icon.png)) en la esquina superior izquierda de la página.
1. Elija **Acciones** y, a continuación, elija **Eliminar**.
1. En el cuadro de diálogo de confirmación:
+ Para eliminar el grupo de subredes, seleccione **Delete (Eliminar)**.
+ Para mantener el grupo de subredes, seleccione **Cancel (Cancelar)**.
------
#### [ Using the AWS CLI ]
Para eliminar un grupo de subredes de Amazon DocumentDB mediante la AWS CLI, utilice la operación `delete-db-subnet-group` con el siguiente parámetro.
**Parámetro**
+ `--db-subnet-group-name`: obligatorio. Nombre del grupo de subredes de Amazon DocumentDB que se va a eliminar. Recuerde que no puede eliminar el grupo de subredes `default`.
**Example**
El código siguiente elimina `sample-subnet-group`.
Para Linux, macOS o Unix:
```
aws docdb delete-db-subnet-group \
--db-subnet-group-name sample-subnet-group
```
Para Windows:
```
aws docdb delete-db-subnet-group ^
--db-subnet-group-name sample-subnet-group
```
Esta operación no produce ningún resultado.
------