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.
# 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).