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 instancias de Amazon DocumentDB
Los siguientes temas proporcionan información que le ayudarán a administrar sus instancias de Amazon DocumentDB. Incluyen detalles sobre las clases y los estados de instancias, y cómo crear, eliminar y modificar una instancia.
**Topics**
+ [Determinación del estado de una instancia](#db-instance-status)
+ [Ciclo de vida de la instancia](db-instance-life-cycle.md)
+ [Administración de clases de instancias](db-instance-classes.md)
+ [Instancias respaldadas por NVMe](db-instance-nvme.md)
## Determinación del estado de una instancia
Para ver los estados válidos de las instancias, su significado y saber cómo determinar el estado de las instancias, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md).
# Ciclo de vida de instancia de Amazon DocumentDB
El ciclo de vida de una instancia Amazon DocumentDB comprende su creación, modificación, mantenimiento y actualización, ejecución de copias de seguridad y restauraciones, reinicio, actualización y eliminación. En esta sección se proporciona información sobre cómo realizar estos procesos.
**Topics**
+ [Adición de una instancia](db-instance-add.md)
+ [Descripción de instancias](db-instance-view-details.md)
+ [Modificación de una instancia](db-instance-modify.md)
+ [Reinicio de una instancia](db-instance-reboot.md)
+ [Eliminación de una instancia](db-instance-delete.md)
Puede crear una nueva instancia de Amazon DocumentDB mediante el Consola de administración de AWS o el. AWS CLI Para añadir una instancia a un clúster, el clúster debe tener un estado *disponible*. No puede añadir una instancia a un clúster que está detenido. Si el clúster está detenido, inicie primero el clúster, espere a que el clúster esté *disponible* y, a continuación, añada una instancia. Para obtener más información, consulte [Detención e inicio de un clúster de bases de datos de Amazon DocumentDB](db-cluster-stop-start.md).
**nota**
Si crea un clúster de Amazon DocumentDB mediante la consola, se crea automáticamente una instancia al mismo tiempo. Si desea crear instancias adicionales, utilice uno de los siguientes procedimientos.
# Agregación de una instancia de Amazon DocumentDB a un clúster
------
#### [ Using the Consola de administración de AWS ]
El siguiente procedimiento permite crear una instancia de su clúster mediante la consola de Amazon DocumentDB.
1. [Inicie sesión en y abra la Consola de administración de AWS consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
**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 elegir el clúster al que desea añadir una instancia, seleccione el botón situado a la izquierda del nombre del clúster.
1. Elija **Actions (Acciones)** y después **Add instances (Añadir instancias)**.
1. En la página **Add instance to (Añadir instancia a)**, repita los pasos que se describen a continuación para cada instancia que desee añadir al clúster. Puede tener un máximo de 15.
1. **Instance identifier**: puede escribir un identificador único para esta instancia o permitir que Amazon DocumentDB proporcione el identificador de la instancia basándose en el identificador del clúster.
Restricciones en cuanto a la nomenclatura de las instancias:
+ Debe tener [1-63] letras, números o guiones.
+ El primer carácter debe ser una letra.
+ No puede terminar con un guion ni contener dos guiones consecutivos.
+ Debe ser único para todas las instancias de Amazon RDS, Neptune y Amazon DocumentDB por región. Cuenta de AWS
1. **Clase de instancia**: en la lista desplegable, elija el tipo de instancia que desea para esta instancia.
1. **Capa de promoción**: en la lista, elija la capa de promoción de la instancia, o bien elija *Sin preferencia* para permitir que Amazon DocumentDB establezca la capa de promoción de la instancia. Un número menor indica una mayor prioridad. Para obtener más información, consulte [Control del destino de la conmutación por error](failover.md#failover-target_control).
1. Para añadir más instancias, elija **Add additional instances (Agregar instancias adicionales)** y repita los pasos a, b y c.
1. Finalizar la operación.
+ Para añadir las instancias a su clúster, seleccione **Create (Crear)**.
+ Para cancelar la operación, elija **Cancel (Cancelar)**.
La creación de una instancia puede tardar varios minutos. Puede usar la consola o ver el AWS CLI estado de la instancia. Para obtener más información, consulte [Monitorización del estado de una instancia](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Usa la `create-db-instance` AWS CLI operación con los siguientes parámetros para crear la instancia principal del clúster.
+ **--db-instance-class**: obligatorio. La capacidad de memoria e informática de la instancia (por ejemplo, `db.m4.large`). No todas las clases de instancia están disponibles en todas las Regiones de AWS.
+ **--db-instance-identifier**: obligatorio. Una cadena que identifica la instancia.
Restricciones en cuanto a la nomenclatura de las instancias:
+ Debe tener [1-63] letras, números o guiones.
+ El primer carácter debe ser una letra.
+ No puede terminar con un guion ni contener dos guiones consecutivos.
+ Debe ser único para todas las instancias de Amazon RDS, Neptune y Amazon DocumentDB por región. Cuenta de AWS
+ **--engine**: obligatorio. Debe ser `docdb`.
+ **--availability-zone**: opcional. La zona de disponibilidad en la que desea crear esta instancia. Use este parámetro para colocar sus instancias en diferentes zonas de disponibilidad con el fin de aumentar la tolerancia a errores. Para obtener más información, consulte [Alta disponibilidad y replicación de Amazon DocumentDB](replication.md).
+ **--promotion-tier**: opcional. El nivel de prioridad de conmutación por error de esta instancia. Debe ser un número comprendido entre 0 y 15; un número menor indica una mayor prioridad. Para obtener más información, consulte [Control del destino de la conmutación por error](failover.md#failover-target_control).
1. **En primer lugar, determine en qué zonas de disponibilidad puede crear la instancia. **
Si desea especificar la zona de disponibilidad, antes de crear la instancia, ejecute el siguiente comando para determinar en qué zonas de disponibilidad están disponibles para el clúster de Amazon DocumentDB.
Para Linux, macOS o Unix:
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
Para Windows:
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
La salida de esta operación será similar a lo que se indica a continuación.
```
[
[
"sample-cluster",
[
"us-east-1c",
"us-east-1b",
"us-east-1a"
]
]
]
```
1. **En segundo lugar, determine qué clases de instancias puede crear en su región. **
Para determinar qué clases de instancias tiene a su disposición en su región, ejecute el siguiente comando. En el resultado, elija una clase de instancia para la instancia que desea agregar al clúster de Amazon DocumentDB.
Para Linux, macOS o Unix:
```
aws docdb describe-orderable-db-instance-options \
--engine docdb \
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
Para Windows:
```
aws docdb describe-orderable-db-instance-options ^
--engine docdb ^
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
La salida de esta operación será similar a lo que se indica a continuación.
```
[
"db.r5.16xlarge",
"db.r5.2xlarge",
"db.r5.4xlarge",
"db.r5.8xlarge",
"db.r5.large",
"db.r5.xlarge"
]
```
1. **Agregar una instancia a su clúster de Amazon DocumentDB.**
Para agregar una instancia al clúster de Amazon DocumentDB, ejecute el siguiente comando.
Para Linux, macOS o Unix:
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-instance-2 \
--availability-zone us-east-1b \
--promotion-tier 2 \
--db-instance-class db.r5.xlarge \
--engine docdb
```
Para Windows:
```
aws docdb create-db-instance ^
--db-cluster-identifier sample-cluster ^
--db-instance-identifier sample-instance-2 ^
--availability-zone us-east-1b ^
--promotion-tier 2 ^
--db-instance-class db.r5.xlarge ^
--engine docdb
```
La salida de esta operación será similar a lo que se indica a continuación.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.xlarge",
"Engine": "docdb",
"DBInstanceStatus": "creating",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1b",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:11:35-sun:12:05",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 2,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2"
}
}
```
La creación de la instancia puede tardar varios minutos. Puede usar la consola o ver el AWS CLI estado de la instancia. Para obtener más información, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
# Descripción de las instancias de Amazon DocumentDB
Puede utilizar la consola de administración de Amazon DocumentDB o la AWS CLI para ver detalles como los puntos de conexión, los grupos de seguridad, la autoridad de certificación y los grupos VPCs de parámetros relacionados con sus instancias de Amazon DocumentDB.
------
#### [ Using the Consola de administración de AWS ]
Para ver los detalles de las instancias mediante la Consola de administración de AWS, siga los pasos que se indican a continuación.
1. [Inicie sesión en y abra la Consola de administración de AWS consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
**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 el cuadro de navegación de clústeres, verá la columna **Identificador del clúster**. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla.
![\[Tabla de clústeres en la que se muestra la lista de clústeres en la columna de identificador de clúster, con instancias anidadas dentro de los clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/choose-clusters.png)
1. En la lista de instancias, elija el nombre de la instancia cuyos detalles desea ver. La información sobre la instancia se organiza en los siguientes grupos:
+ **Resumen**: información general sobre la instancia, incluida la versión del motor, la clase, el estado y cualquier mantenimiento pendiente.
+ **Conectividad y seguridad**: la sección **Conectar** enumera los puntos de conexión para conectarse a esta instancia con el intérprete de comandos de mongo o con una aplicación. La sección **Grupos de seguridad** muestra los grupos de seguridad asociados a esta instancia y su ID de VPC y descripciones.
+ **Configuración**: la sección **Detalles** muestra las configuraciones y el estado de la instancia, incluidos el nombre de recurso de Amazon (ARN), el punto de conexión, el rol, la clase y la entidad de certificación de la instancia. También enumera la seguridad y la configuración de red de la instancia, así como la información de copia de seguridad. La sección **Detalles del clúster** muestra los detalles del clúster al que pertenece esta instancia. La sección **Instancias del clúster** muestra todas las instancias que pertenecen al clúster con el rol de cada instancia y el estado del grupo de parámetros del clúster.
**nota**
Puede modificar el clúster asociado a la instancia seleccionando **Modificar** junto al encabezado **Detalles del clúster**. Para obtener más información, consulte [Modificación de un clúster de Amazon DocumentDB](db-cluster-modify.md).
+ **Supervisión**: CloudWatch registra las métricas de esta instancia. Para obtener más información, consulte [Supervisión de Amazon DocumentDB con CloudWatch](cloud_watch.md).
+ **Eventos y etiquetas**: la sección de **eventos recientes** muestra los eventos recientes de esta instancia. Amazon DocumentDB mantiene un registro de los eventos relacionados con los clústeres, las instancias, las instantáneas, los grupos de seguridad y los grupos de parámetros de clúster. Esta información incluye la fecha, la hora y el mensaje asociados a cada evento. La sección **Etiquetas** muestra las etiquetas asociadas a este clúster. Para obtener más información, consulte [Etiquetado de recursos de Amazon DocumentDB](tagging.md).
------
#### [ Using the AWS CLI ]
Para ver los detalles de sus instancias de Amazon DocumentDB mediante el AWS CLI, utilice el `describe-db-clusters` comando tal y como se muestra en los ejemplos siguientes. Para obtener más información, consulte [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html) en la *Referencia de la API para administración de recursos de Amazon DocumentDB*.
**nota**
Para ciertas características de administración, como la administración del ciclo de vida de clúster y de instancia, Amazon DocumentDB aprovecha la tecnología operativa que se comparte con Amazon RDS. El parámetro de filtro `filterName=engine,Values=docdb` devuelve solo clústeres de Amazon DocumentDB.
1. **Enumere todas las instancias de Amazon DocumentDB.**
En el siguiente AWS CLI código se enumeran los detalles de todas las instancias de Amazon DocumentDB de una región.
Para Linux, macOS o Unix:
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
Para Windows:
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
1. **Enumeración de todos los detalles de una instancia de Amazon DocumentDB especificada**
El siguiente código enumera los detalles de `sample-cluster-instance`. Incluir el parámetro `--db-instance-identifier` con el nombre de una instancia restringe la salida a la información sobre esa instancia en particular.
Para Linux, macOS o Unix:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
Para Windows:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
El resultado de esta operación será similar a lo que se indica a continuación:
```
{
"DBInstances": [
{
"DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM",
"DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"DBInstanceClass": "db.r5.large",
"DBInstanceStatus": "creating",
"AutoMinorVersionUpgrade": true,
"PreferredMaintenanceWindow": "fri:09:32-fri:10:02",
"BackupRetentionPeriod": 1,
"StorageEncrypted": true,
"DBClusterIdentifier": "sample-cluster",
"EngineVersion": "3.6.0",
"AvailabilityZone": "us-east-1a",
"Engine": "docdb",
"PromotionTier": 2,
"DBInstanceIdentifier": "sample-cluster-instance",
"PreferredBackupWindow": "00:00-00:30",
"PubliclyAccessible": false,
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"Subnets": [
{
"SubnetIdentifier": "subnet-4e26d263",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-afc329f4",
"SubnetAvailabilityZone": {
"Name": "us-east-1c"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-b3806e8f",
"SubnetAvailabilityZone": {
"Name": "us-east-1e"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-53ab3636",
"SubnetAvailabilityZone": {
"Name": "us-east-1d"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-991cb8d0",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-29ab1025",
"SubnetAvailabilityZone": {
"Name": "us-east-1f"
},
"SubnetStatus": "Active"
}
],
"VpcId": "vpc-91280df6",
"DBSubnetGroupDescription": "default",
"SubnetGroupStatus": "Complete"
},
"PendingModifiedValues": {},
"KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b"
}
]
}
```
------
# Modificación de una instancia de base de datos de Amazon DocumentDB
Puede modificar su instancia de Amazon DocumentDB mediante el Consola de administración de AWS o el. AWS CLI Para modificar una instancia, la instancia debe tener el estado *disponible*. No puede modificar una instancia detenida. Si el clúster está detenido, inicie primero el clúster, espere a que la instancia esté *disponible* y, a continuación, realice las modificaciones deseadas. Para obtener más información, consulte [Detención e inicio de un clúster de bases de datos de Amazon DocumentDB](db-cluster-stop-start.md).
------
#### [ Using the Consola de administración de AWS ]
Complete los pasos que se indican a continuación para modificar una instancia de Amazon DocumentDB específica mediante la consola.
1. [Inicie sesión en y abra la Consola de administración de AWS consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
**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 el cuadro de navegación de clústeres, verá la columna **Identificador del clúster**. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla.
![\[Tabla de clústeres en la que se muestra la lista de clústeres en la columna de identificador de clúster, con instancias anidadas dentro de los clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/choose-clusters.png)
1. Marque la casilla de verificación situada a la izquierda de la instancia que desea modificar.
1. Elija **Actions (Acciones)** y después **Modify (Modificar)**.
1. En el panel **Modificar instancia: **, realice los cambios que desee. Puede hacer los siguientes cambios:
+ **Especificaciones de instancia**: el identificador y la clase de la instancia. Restricciones de nombres del identificador de instancia:
+ **Identificador de instancia**: introduzca un nombre que sea único para todas las instancias de su propiedad Cuenta de AWS en la región actual. El identificador de instancia debe contener [1-63] caracteres alfanuméricos o guiones, tener una letra como primer carácter y no puede terminar con un guion ni contener dos guiones consecutivos.
+ **Clase de instancia**: en el menú desplegable, seleccione una clase de instancia para su instancia de Amazon DocumentDB. Para obtener más información, consulte [Administración de clases de instancias](db-instance-classes.md).
+ **Autoridad de certificación**: certificado de servidor para esta instancia. Para obtener más información, consulte [Actualización de los certificados TLS de Amazon DocumentDB](ca_cert_rotation.md).
+ **Conmutación por error**: durante la conmutación por error, la instancia con el nivel de promoción más alto se promoverá a primaria. Para obtener más información, consulte [Conmutación por error a Amazon DocumentDB](failover.md).
+ **Mantenimiento **: la ventana de mantenimiento en la que se aplican las modificaciones o revisiones pendientes a las instancias del clúster.
1. Cuando haya terminado, elija **Continuar** para ver un resumen de los cambios.
1. Después de verificar los cambios, puede aplicarlos inmediatamente o durante el siguiente período de mantenimiento en **Scheduling of modifications (Programación de modificaciones)**. Seleccione **Modify instance (Modificar instancia)** para guardar los cambios. Como alternativa, puede elegir **Cancel (Cancelar)** para descartar los cambios.
Los cambios pueden tardar unos minutos en aplicarse. Solo puede usar la instancia cuando su estado sea *available (disponible)*. Puede monitorizar el estado de la instancia mediante la consola o la AWS CLI. Para obtener más información, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Para modificar una instancia específica de Amazon DocumentDB mediante el AWS CLI, utilice el `modify-db-instance` con los siguientes parámetros. Para obtener más información, consulte [Modificar DBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html). El siguiente código modifica la clase de instancia a `db.r5.large` para la instancia `sample-instance`.
**Parameters**
+ **--db-instance-identifier**: obligatorio. El identificador de la instancia que se va a modificar.
+ **--db-instance-class**: opcional. La nueva capacidad de memoria e informática de la instancia (por ejemplo, `db.r5.large`). No todas las clases de instancia están disponibles en todas las Regiones de AWS. Si modifica la clase de la instancia se produce una interrupción durante el cambio. El cambio se aplica durante la siguiente ventana de mantenimiento, a menos que `ApplyImmediately` se especifique como verdadera para esta solicitud.
+ **--apply-immediately** o **--no-apply-immediately**: opcional. Especifica si esta modificación debe aplicarse inmediatamente o esperar hasta el próximo periodo de mantenimiento. Si se omite este parámetro, la modificación se realiza durante el siguiente período de mantenimiento.
**Example**
Para Linux, macOS o Unix:
```
aws docdb modify-db-instance \
--db-instance-identifier sample-instance \
--db-instance-class db.r5.large \
--apply-immediately
```
Para Windows:
```
aws docdb modify-db-instance ^
--db-instance-identifier sample-instance ^
--db-instance-class db.r5.large ^
--apply-immediately
```
La salida de esta operación será similar a lo que se indica a continuación.
```
{
"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"
]
}
]
}
```
Las modificaciones pueden tardar unos minutos en aplicarse. Solo puede usar la instancia cuando su estado sea *available (disponible)*. Puede supervisar el estado de la instancia mediante la tecla Consola de administración de AWS o AWS CLI. Para obtener más información, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
# Reinicio de la instancia de Amazon DocumentDB
Es posible que en algún momento necesite reiniciar su instancia de Amazon DocumentDB, normalmente por razones de mantenimiento. Si realiza determinados cambios, como cambiar el grupo de parámetros de clúster asociado a un clúster, debe reiniciar las instancias del clúster para que los cambios surtan efecto. Puede reiniciar una instancia específica mediante el Consola de administración de AWS o el AWS CLI.
Cuando se reinicia una instancia, se reinicia el servicio del motor de base de datos. Al reiniciar una instancia, se produce una interrupción momentánea, durante la cual su estado se establece en `rebooting`. Cuando finaliza el reinicio, se crea un evento de Amazon DocumentDB.
El reinicio de una instancia no produce una conmutación por error. Para realizar la conmutación por error de un clúster de Amazon DocumentDB, utilice Consola de administración de AWS la operación o AWS CLI . `failover-db-cluster` Para obtener más información, consulte [Conmutación por error a Amazon DocumentDB](failover.md).
No puede reiniciar su instancia si no tiene el estado *disponible*. La base de datos puede no estar disponible por varias razones, como una modificación solicitada anteriormente o una acción durante un periodo de mantenimiento. Para obtener más información acerca de los estados de las instancias, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the Consola de administración de AWS ]
El siguiente procedimiento reinicia una instancia especificada mediante la consola.
1. [Inicie sesión en y abra la Consola de administración de AWS consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
**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 el cuadro de navegación de clústeres, verá la columna **Identificador del clúster**. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla.
![\[Tabla de clústeres en la que se muestra la lista de clústeres en la columna de identificador de clúster, con instancias anidadas dentro de los clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/choose-clusters.png)
1. Marque la casilla de verificación situada a la izquierda de la instancia que desea reiniciar.
1. Elija **Actions (Acciones)**, después **Reboot (Reiniciar)** y, por último, **Reboot (Reiniciar)** para confirmar el reinicio.
El reinicio de la instancia puede tardar unos minutos. Solo puede usar la instancia cuando su estado sea *available (disponible)*. Puede monitorizar el estado de la instancia mediante la consola o la AWS CLI. Para obtener más información, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Para reiniciar una instancia de Amazon DocumentDB, utilice la operación `reboot-db-instance` con el parámetro `--db-instance-identifier`. Este parámetro especifica el identificador de la instancia que se va a reiniciar.
El siguiente código reinicia la instancia `sample-instance`.
**Example**
Para Linux, macOS o Unix:
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-instance
```
Para Windows:
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-instance
```
La salida de esta operación será similar a lo que se indica a continuación.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "rebooting",
"Endpoint": {
"Address": "sample-instance.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
El reinicio de la instancia puede tardar unos minutos. Solo puede usar la instancia cuando su estado sea *available (disponible)*. Puede monitorizar el estado de la instancia mediante la consola o la AWS CLI. Para obtener más información, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
# Eliminación de una instancia de Amazon DocumentDB
Puede eliminar su instancia de Amazon DocumentDB mediante el Consola de administración de AWS o el. AWS CLI Para eliminar una instancia, la instancia debe estar en el estado *disponible*. No puede eliminar una instancia detenida. Si el clúster de Amazon DocumentDB que contiene la instancia está detenido, inicie primero el clúster, espere a que la instancia esté *disponible* y, a continuación, elimine la instancia. Para obtener más información, consulte [Detención e inicio de un clúster de bases de datos de Amazon DocumentDB](db-cluster-stop-start.md).
**nota**
Amazon DocumentDB almacena todos los datos en el volumen del clúster. Los datos se conservan en ese volumen de clúster, incluso si elimina todas las instancias del clúster. Si necesita obtener acceso a los datos de nuevo, puede agregar una instancia al clúster en cualquier momento y reanudar el trabajo donde lo dejó.
------
#### [ Using the Consola de administración de AWS ]
El siguiente procedimiento elimina una instancia de Amazon DocumentDB especificada mediante la consola.
1. [Inicie sesión en y abra la Consola de administración de AWS consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
**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 el cuadro de navegación de clústeres, verá la columna **Identificador del clúster**. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla.
![\[Tabla de clústeres en la que se muestra la lista de clústeres en la columna de identificador de clúster, con instancias anidadas dentro de los clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/choose-clusters.png)
1. Marque la casilla de verificación situada a la izquierda de la instancia que desea eliminar.
1. Seleccione **Acciones** y, a continuación, elija **Eliminar**.
1. Si va a eliminar la última instancia del clúster:
+ **Create final cluster snapshot? (¿Crear instantánea de clúster final?)** Elija **Sí** si desea crear una instantánea final antes de eliminar el clúster. En caso contrario, elija **No**.
+ **Nombre de la instantánea final**: si ha decidido crear una instantánea final, escriba el identificador de la instantánea de clúster o de la nueva instantánea de clúster que se ha creado.
+ **Delete instance? (¿Eliminar ?)** Escriba la frase **Eliminar clúster completo** en el campo para confirmar la eliminación.
1. Si no va a eliminar la última instancia del clúster:
+ **Delete instance? (¿Eliminar ?)** Escriba la frase **Eliminarme** en el campo para confirmar la eliminación.
1. Seleccione **Delete (Eliminar)** para eliminar la instancia.
La eliminación de una instancia tarda varios minutos. Para monitorear el estado de una instancia, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
El siguiente procedimiento elimina una instancia de Amazon DocumentDB mediante la AWS CLI.
1. **En primer lugar, determine cuántas instancias hay en el clúster de Amazon DocumentDB:**
Para determinar cuántas instancias hay en el clúster, ejecute el comando `describe-db-clusters` de la siguiente manera.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
La salida de esta operación será similar a lo que se indica a continuación.
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
1. **Si hay más de una instancia en el clúster de Amazon DocumentDB:**
Para eliminar una instancia de Amazon DocumentDB especificada, utilice el comando `delete-db-instance` con el parámetro `--db-instance-identifier`, como se muestra a continuación. La eliminación de una instancia tarda varios minutos. Para monitorear el estado de una instancia, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md).
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance-2
```
La salida de esta operación será similar a lo que se indica a continuación.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "deleting",
"Endpoint": {
"Address": "sample-instance-2.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
1. **Si la instancia que desea eliminar es la última instancia del clúster de Amazon DocumentDB: **
Si elimina la última instancia de un clúster de Amazon DocumentDB, también elimina ese clúster, así como las instantáneas automáticas y las copias de seguridad continuas asociadas a ese clúster.
Para eliminar la última instancia del clúster, puede eliminar el clúster y, si lo desea, crear una instantánea final. Para obtener más información, consulte [Eliminación de un clúster de Amazon DocumentDB](db-cluster-delete.md).
------
## Protección contra eliminación
Al eliminar la última instancia de un clúster de Amazon DocumentDB, también se eliminará el clúster, así como las instantáneas automáticas y las copias de seguridad continuas asociadas a ese clúster. Amazon DocumentDB aplica la protección contra la eliminación de un clúster, independientemente de si realiza la operación de eliminación con o con. Consola de administración de AWS AWS CLI Si la protección contra eliminación está habilitada, no podrá eliminar un clúster.
Para eliminar un clúster con la protección contra eliminación habilitada, primero debe modificar el clúster y deshabilitar la protección contra eliminación. Para obtener más información, consulte [Eliminación de un clúster de Amazon DocumentDB](db-cluster-delete.md).
# Administración de clases de instancias
La clase de instancia de base de datos determina la capacidad de cómputo y de memoria de una instancia de Amazon DocumentDB (compatible con MongoDB). La clase de instancia que necesita depende de la potencia de procesamiento y de los requisitos de memoria.
Amazon DocumentDB admite las familias de clases de instancias R4, R5, R6G, R8G, T3 y T4G. Se trata de clases de instancias de la generación actual que se han optimizado para las aplicaciones que hacen un uso intensivo de la memoria. Para conocer las especificaciones de estas clases, consulte [Especificaciones de clases de instancias](#db-instance-class-specs).
**Topics**
+ [Determinación de la clase de una instancia](#db-instance-class-determining)
+ [Cambio de la clase de una instancia](#db-instance-class-changing)
+ [Clases de instancias admitidas por región](#db-instance-classes-by-region)
+ [Especificaciones de clases de instancias](#db-instance-class-specs)
## Determinación de la clase de una instancia
Para determinar la clase de una instancia, puedes usar la `describe-db-instances` AWS CLI operación Consola de administración de AWS o.
------
#### [ Using the Consola de administración de AWS ]
Para determinar la clase de instancia de las instancias del clúster, complete los siguientes pasos en la consola.
1. [Inicie sesión en y abra la Consola de administración de AWS consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Para encontrar la instancia que le interesa, elija **Clústeres** en el panel de navegación.
**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 el cuadro de navegación de clústeres, verá la columna **Identificador del clúster**. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla.
![\[Tabla de clústeres en la que se muestra cómo se anida una instancia en un clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/choose-clusters.png)
1. En la lista de instancias, expande el clúster para encontrar las instancias que le interesan. Encuentre la instancia que desee. A continuación, fíjese en la columna **Tamaño** de la fila correspondiente a la instancia.
En la imagen siguiente, la clase de la instancia `robo3t` es `db.r5.4xlarge`.
![\[Lista de instancias de la tabla de clústeres con la columna Tamaño, en la que se muestra el tipo de instancia.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/instance-class.png)
------
#### [ Using the AWS CLI ]
Para determinar la clase de una instancia mediante el AWS CLI, utilice la `describe-db-instances` operación con los siguientes parámetros.
+ **--db-instance-identifier**— Opcional. Especifica la instancia para la que desea encontrar la clase de instancia. Si se omite este parámetro, `describe-db-instances` devuelve una descripción para un máximo de 100 instancias.
+ **--query**: opcional. Especifica los miembros de la instancia que se van a incluir en los resultados. Si se omite este parámetro, se devuelven todos los miembros de la instancia.
**Example**
En el siguiente ejemplo se busca el nombre y la clase de la instancia para la instancia `sample-instance-1`.
Para Linux, macOS o Unix:
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
--db-instance-identifier sample-instance-1
```
Para Windows:
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
--db-instance-identifier sample-instance-1
```
La salida de esta operación será similar a lo que se indica a continuación.
```
[
[
"sample-instance-1",
"db.r5.large"
]
```
**Example**
En el siguiente ejemplo se busca el nombre y la clase de la instancia para un máximo de 100 instancias de Amazon DocumentDB.
Para Linux, macOS o Unix:
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
--filter Name=engine,Values=docdb
```
Para Windows:
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
--filter Name=engine,Values=docdb
```
La salida de esta operación será similar a lo que se indica a continuación.
```
[
[
"sample-instance-1",
"db.r5.large"
],
[
"sample-instance-2",
"db.r5.large"
],
[
"sample-instance-3",
"db.r5.4xlarge"
],
[
"sample-instance-4",
"db.r5.4xlarge"
]
]
```
Para obtener más información, consulte [Descripción de las instancias de Amazon DocumentDB](db-instance-view-details.md).
------
## Cambio de la clase de una instancia
Puede cambiar la clase de instancia de su instancia mediante el Consola de administración de AWS o el AWS CLI. Para obtener más información, consulte [Modificación de una instancia de base de datos de Amazon DocumentDB](db-instance-modify.md).
## Clases de instancias admitidas por región
Amazon DocumentDB admite las siguientes clases de instancia:
+ `R8G`—Instancias optimizadas para memoria de última generación equipadas con procesadores AWS Graviton4 basados en ARM, que ofrecen un rendimiento hasta un 30% superior al de las instancias R6G.
+ `R6G`—Instancias optimizadas para memoria equipadas con procesadores AWS Graviton2 basados en ARM que ofrecen un rendimiento hasta un 30% superior al de las instancias R5 a un coste un 5% menor.
+ `R6GD`—Instancias R6G optimizadas para memoria con almacenamiento local no volátil en unidades de estado sólido (SSD) basadas en memoria express () no volátil para datos efímeros. NVMe
+ `R5`: instancias optimizadas para memoria que ofrecen un rendimiento hasta un 100 % superior al de las instancias R4 por el mismo coste de instancia.
+ `R4`: instancias optimizadas para memoria de generación anterior.
+ `T4G`—Un tipo de instancia de uso general, de última generación, con capacidad de ráfaga y bajo coste, equipada con procesadores AWS Graviton2 basados en ARM, que proporciona un nivel básico de rendimiento de la CPU, con una relación precio-rendimiento hasta un 35% superior a la de las instancias T3 y es ideal para ejecutar aplicaciones con un uso moderado de la CPU que sufren picos temporales de uso.
+ `T3`: tipo de instancia de uso general y ampliables que proporcionan un nivel básico de rendimiento de la CPU con posibilidad de ampliar el uso de la CPU en cualquier momento durante el tiempo que sea necesario.
Para conocer las especificaciones detalladas de las clases de instancias, consulte [Especificaciones de clases de instancias](#db-instance-class-specs).
**nota**
El almacenamiento optimizado para E/S solo está disponible en las versiones 5.0 y 8.0 del motor (clústeres basados en instancias).
Una clase de instancia determinada se podría admitir o no en una región determinada. En la siguiente tabla, se especifica qué clases de instancias admite Amazon DocumentDB en cada región.
**Clases de instancias admitidas por región**
| | Clases de instancia | Region | R8G | R6GD | R6G | R5 | R4 | T4G | T3 | Sin servidor |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Este de EE. UU. (Ohio) | Soportado | Soportado | Soportado | Soportado | Soportado | Soportado | Soportado | compatible |
| Este de EE. UU. (Norte de Virginia) | Soportado | Soportado | Soportado | Soportado | Soportado | Soportado | Soportado | compatible |
| Oeste de EE. UU. (Oregón) | Soportado | Soportado | Soportado | Soportado | Soportado | Soportado | Soportado | compatible |
| África (Ciudad del Cabo) | | | Soportado | Soportado | | Soportado | Soportado | compatible |
| América del Sur (São Paulo) | | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible |
| Asia-Pacífico (Hong Kong) | | | Soportado | Soportado | | Soportado | Soportado | compatible |
| Asia-Pacífico (Hyderabad) | | | Soportado | Soportado | | Soportado | Soportado | compatible |
| Asia-Pacífico (Malasia) | | | Soportado | | | Soportado | compatible | |
| Asia-Pacífico (Mumbai) | Soportado | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible |
| Asia-Pacífico (Osaka) | | Soportado | Soportado | Soportado | | Soportado | compatible | |
| Asia-Pacífico (Seúl) | Soportado | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible |
| Asia-Pacífico (Sídney) | Soportado | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible |
| Asia-Pacífico (Yakarta) | Soportado | Soportado | Soportado | Soportado | | Soportado | compatible | |
| Asia-Pacífico (Melbourne) | | | Soportado | Soportado | | Soportado | compatible | |
| Asia-Pacífico (Singapur) | Soportado | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible |
| Asia-Pacífico (Tailandia) | | | Soportado | | | Soportado | compatible | |
| Asia-Pacífico (Tokio) | Soportado | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible |
| Canadá (centro) | | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible |
| Europa (Fráncfort) | Soportado | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible |
| Europa (Zúrich) | | Soportado | Soportado | Soportado | | Soportado | compatible | |
| Europa (Irlanda) | Soportado | Soportado | Soportado | Soportado | Soportado | Soportado | Soportado | compatible |
| Europa (Londres) | | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible |
| Europa (Milán) | | | Soportado | Soportado | | Soportado | Soportado | compatible |
| Europa (París) | | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible |
| Europa (España) | Soportado | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible |
| Europa (Estocolmo) | Soportado | Soportado | Soportado | Soportado | | Soportado | compatible | |
| México (centro) | | | Soportado | | | Soportado | compatible | |
| Medio Oriente (EAU) | | | Soportado | Soportado | | Soportado | Soportado | compatible |
| China (Pekín) | | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible |
| China (Ningxia) | | | Soportado | Soportado | | Soportado | Soportado | compatible |
| Israel (Tel Aviv) | | | Soportado | Soportado | | Soportado | Soportado | compatible |
| AWS GovCloud (EE. UU.-Oeste) | Soportado | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible |
| AWS GovCloud (EE. UU.-Este) | | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible |
## Especificaciones de clases de instancias
La siguiente tabla proporciona información detallada de las clases de instancias de Amazon DocumentDB, incluidos los tipos de instancias que se admiten en cada clase. Puede encontrar explicaciones sobre cada columna de la tabla debajo de la tabla.
| Clase de instancia | CPU virtuales1 | Memoria (GiB)2 | NVMe Caché SSD por niveles (GiB) 3 | Temperatura máxima de almacenamiento (GiB) 4 | Ancho de banda de base/con ampliación (Gbps)5 | Motores compatibles6 |
| --- | --- | --- | --- | --- | --- | --- |
| R8G: clase de instancia optimizada para memoria de la generación actual basada en Graviton4 R8G es la familia de instancias más reciente (Graviton4) y solo está disponible en las versiones de motor 5.0 y 8.0. Los tamaños db.r8g.24xlarge y db.r8g.48xlarge aún no están disponibles. |
| db.r8g.large | 2 | 16 | - | 30 | 0,937/12,5 | 5.0.0 y 8.0.0 |
| db.r8g.xlarge | 4 | 32 | - | 60 | 1,875/12,5 | 5.0.0 y 8.0.0 |
| db.r8g.2xlarge | 8 | 64 | - | 121 | 3,75/15,0 | 5.0.0 y 8.0.0 |
| db.r8g.4xlarge | 16 | 128 | - | 243 | 7,5/15,0 | 5.0.0 y 8.0.0 |
| db.r8g.8xlarge | 32 | 256 | - | 488 | 15 | 5.0.0 y 8.0.0 |
| db.r8g.12xlarge | 48 | 384 | - | 732 | 22 | 5.0.0 y 8.0.0 |
| db.r8g.16xlarge | 64 | 512 | - | 987 | 30 | 5.0.0 y 8.0.0 |
| R6G: clase de instancia optimizada para memoria de la generación actual basada en Graviton2 |
| db.r6g.large | 2 | 16 | - | 32 | 0,75/10 | 4.0.0, 5.0.0 y 8.0.0 |
| db.r6g.xlarge | 4 | 32 | - | 63 | 1.25/10 | 4.0.0, 5.0.0 y 8.0.0 |
| db.r6g.2xlarge | 8 | 64 | - | 126 | 2.5/10 | 4.0.0, 5.0.0 y 8.0.0 |
| db.r6g.4xlarge | 16 | 128 | - | 252 | 5.0/10 | 4.0.0, 5.0.0 y 8.0.0 |
| db.r6g.8xlarge | 32 | 256 | - | 504 | 12 | 4.0.0, 5.0.0 y 8.0.0 |
| db.r6g.12xlarge | 48 | 384 | - | 756 | 20 | 4.0.0, 5.0.0 y 8.0.0 |
| db.r6g.16xlarge | 64 | 512 | - | 1008 | 25 | 4.0.0, 5.0.0 y 8.0.0 |
| R6GD: clase de instancia respaldada por la generación NVMe actual basada en Graviton2 |
| db.r6gd.xlarge | 4 | 32 | 173 | 64 | 1.25/10 | 5.0.0 y 8.0.0 |
| db.r6gd.2xlarge | 8 | 64 | 346 | 128 | 2,5/ 10 | 5.0.0 y 8.0.0 |
| db.r6gd.4xlarge | 16 | 128 | 694 | 256 | 5,0/ 10 | 5.0.0 y 8.0.0 |
| db.r6gd.8xlarge | 32 | 256 | 1388 | 512 | 12 | 5.0.0 y 8.0.0 |
| db.r6gd.12xlarge | 48 | 384 | 2082 | 768 | 20 | 5.0.0 y 8.0.0 |
| db.r6gd.16xlarge | 64 | 512 | 2776 | 1024 | 25 | 5.0.0 y 8.0.0 |
| R5: clases de instancia optimizada para memoria de generación anterior |
| db.r5.large | 2 | 16 | - | 31 | 0,75/10 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 |
| db.r5.xlarge | 4 | 32 | - | 62 | 1.25/10 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 |
| db.r5.2xlarge | 8 | 64 | - | 124 | 2.5/10 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 |
| db.r5.4xlarge | 16 | 128 | - | 249 | 5.0/10 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 |
| db.r5.8xlarge | 32 | 256 | - | 504 | 10 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 |
| db.r5.12xlarge | 48 | 384 | - | 748 | 12 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 |
| db.r5.16xlarge | 64 | 512 | - | 1008 | 20 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 |
| db.r5.24xlarge | 96 | 768 | - | 1500 | 25 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 |
| R4: clases de instancia optimizada para memoria de generación anterior Las instancias R4 solo se admiten en la versión 3.6 del motor. Tenga en cuenta que Amazon DocumentDB 3.6 finalizará el soporte estándar el 30 de marzo de 2026. Extended Support (de pago) está disponible hasta marzo de 2029. |
| db.r4.large | 2 | 15,25 | - | 30 | 0.75/10 | Solo 3.6.0 |
| db.r4.xlarge | 4 | 30,5 | - | 60 | 1,25/10 | Solo 3.6.0 |
| db.r4.2xlarge | 8 | 61 | - | 120 | 2.5/10 | Solo 3.6.0 |
| db.r4.4xlarge | 16 | 122 | - | 240 | 5,0 /10 | Solo 3.6.0 |
| db.r4.8xlarge | 32 | 244 | - | 480 | 10 | Solo 3.6.0 |
| db.r4.16xlarge | 64 | 488 | - | 960 | 25 | Solo 3.6.0 |
| T4G: clases de instancia de rendimiento ampliable de última generación basadas en Graviton2 Las instancias de la serie T se ejecutan en modo de ráfaga de CPU ilimitada. El uso de ráfagas por encima de la línea base se factura de forma adicional. No se admite en clústeres globales. |
| db.t4g.medium | 2 | 4 | - | 8.13 | 0,256/ 5 | 4.0.0, 5.0.0 y 8.0.0 |
| T3: clases de instancia de rendimiento ampliable de generación anterior |
| db.t3.medium | 2 | 4 | - | 7.5 | 0,256/5 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/db-instance-classes.html) |
# Instancias respaldadas por NVMe
Las instancias respaldadas por NVMe ofrecen un rendimiento de consultas hasta 7 veces más rápido para aplicaciones con conjuntos de datos grandes que superan la memoria de una instancia normal. Estas instancias aprovechan el almacenamiento local en unidades de estado sólido (SSD) basado en memoria rápida no volátil (NVMe) disponible en las instancias r6gd para almacenar datos efímeros, lo que reduce el acceso al almacenamiento en red y mejora la latencia de lectura y el rendimiento.
El espacio de la SSD local se divide en dos secciones:
+ **Caché por niveles**: aproximadamente el 73 % de la SSD local se asigna como caché de base de datos, lo que permite al sistema almacenar hasta cinco veces más páginas de base de datos que la memoria principal por sí sola. La SSD local actúa como caché de segundo nivel, mientras que la caché del búfer en memoria existente sigue siendo la caché de primer nivel. La consulta accede solamente al almacenamiento externo si se produce un error tanto en la caché de búfer como en la de la SSD.
+ **Almacenamiento temporal**: el 27 % restante se reserva para el almacenamiento temporal no persistente de archivos, que se utiliza para consultas complejas que implican ordenaciones u operaciones con consumo intensivo de recursos, como la compilación de índices. En instancias normales, el espacio temporal se encuentra en un volumen de Amazon Elastic Block Store (EBS). El almacenamiento temporal alojado localmente en la SSD reduce hasta dos veces la latencia de las consultas que implican ordenaciones y acelera las operaciones con consumo intensivo de recursos, como la compilación de índices.
Los detalles sobre el tipo de instancias respaldadas por NVMe compatibles y sus especificaciones se encuentran en [Especificaciones de clases de instancias](db-instance-classes.md#db-instance-class-specs).
**Topics**
+ [Casos de uso recomendados para instancias respaldadas por NVMe](#nvme-use-cases)
+ [Uso de instancias respaldadas por NVMe con Amazon DocumentDB](#using-nvme)
+ [Supervisión de instancias respaldadas por NVMe](#monitoring-nvme)
## Casos de uso recomendados para instancias respaldadas por NVMe
Le recomendamos utilizar instancias respaldadas por NVMe en las siguientes situaciones:
+ **Cargas de trabajo de lectura intensiva**: si su carga de trabajo es de lectura intensiva y su conjunto de datos es más grande que la caché del búfer, lo que se refleja en métricas bajas de `BufferCacheHitRatio` y métricas altas de `ReadIOPS`, las instancias respaldadas por NVMe pueden ofrecer ventajas de rendimiento.
+ **Cargas de trabajo con actualización intensiva**: si su carga de trabajo es de actualizaciones intensivas y la recopilación de elementos no utilizados no puede mantener el ritmo debido a la latencia de lectura en el almacenamiento de red, las instancias respaldadas por NVMe podrían ayudar a mitigar el problema.
Las instancias respaldadas por NVMe pueden ser beneficiosas en varios casos de uso, entre los que se incluyen los siguientes:
+ **Aplicaciones a escala de Internet**: las aplicaciones como el procesamiento de pagos, la facturación y el comercio electrónico con Acuerdos de nivel de servicio (SLA) de rendimiento estrictos pueden aprovechar las ventajas de rendimiento de las instancias respaldadas por NVMe.
+ **Paneles de informes en tiempo real**: los paneles que ejecutan cientos de consultas para la recopilación de métricas/datos pueden beneficiarse de la baja latencia y el alto rendimiento de las instancias respaldadas por NVMe.
+ **Aplicaciones de IA generativa**: las aplicaciones que utilizan la búsqueda vectorial para encontrar vecinos exactos o más cercanos entre millones de incrustaciones vectoriales pueden aprovechar el alto rendimiento de las instancias respaldadas por NVMe.
## Uso de instancias respaldadas por NVMe con Amazon DocumentDB
Cómo usar instancias de Amazon DocumentDB respaldadas por NVMe:
+ Cree un clúster de Amazon DocumentDB y añada una de las clases de instancia respaldadas por NVMe. Para obtener más información, consulte [Creación de un clúster de Amazon DocumentDB](db-cluster-create.md).
+ Como alternativa, modifique un clúster de Amazon DocumentDB existente para utilizar una de las clases de instancia respaldadas por NVMe. Para obtener más información, consulte [Modificación de un clúster de Amazon DocumentDB](db-cluster-modify.md).
Para comprobar la disponibilidad de las instancias respaldadas por NVMe en diferentes regiones de AWS, consulte [Clases de instancias admitidas por región](db-instance-classes.md#db-instance-classes-by-region).
Si desea volver a cambiar de una instancia respaldada por NVMe a una instancia normal, modifique la clase de instancia de base de datos de su instancia de Amazon DocumentDB por una clase de instancia similar sin el almacenamiento de NVMe. Por ejemplo, si la clase de instancia actual es «db.r6gd.4xlarge», elija «db.r6g.4xlarge» para volver atrás. Para obtener más información, consulte [Modificación de un clúster de Amazon DocumentDB](db-cluster-modify.md).
## Supervisión de instancias respaldadas por NVMe
Además de las métricas de instancia normales disponibles en Amazon CloudWatch, las instancias respaldadas por NVMe emiten métricas adicionales específicas para el almacenamiento en SSD basado en NVMe, las IOPS y el rendimiento.
```
NVMeStorageCacheHitRatio
FreeNVMeStorage
ReadIOPSNVMeStorage
ReadLatencyNVMeStorage
ReadThroughputNVMeStorage
WriteIOPSNVMeStorage
WriteLatencyNVMeStorage
WriteThroughputNVMeStorage
```
Para obtener más información acerca de estas métricas, consulte [NVMe-métricas de instancias respaldadas](cloud_watch.md#nvme-metrics)