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 del clúster de Amazon DocumentDB
El ciclo de vida de un clúster de Amazon DocumentDB incluye crear, describir, modificar y eliminar el clúster. En esta sección se proporciona información sobre cómo realizar estos procesos.
**Topics**
+ [creación de un clúster](db-cluster-create.md)
+ [Descripción de los clústeres](db-cluster-view-details.md)
+ [Modificación de un clúster](db-cluster-modify.md)
+ [Determinación de las tareas de mantenimiento pendientes](db-cluster-determine-pending-maintenance.md)
+ [Parche para actualizar la versión del motor de un clúster](db-cluster-version-upgrade.md)
+ [Detención e inicio de un clúster](db-cluster-stop-start.md)
+ [Eliminación de un clúster](db-cluster-delete.md)
# Creación de un clúster de Amazon DocumentDB
Un clúster de Amazon DocumentDB consta de instancias y de un volumen de clúster que representa los datos del clúster. El volumen de clúster se replica de seis formas en tres zonas de disponibilidad como un único volumen virtual. El clúster contiene una instancia principal y, opcionalmente, hasta 15 instancias de réplica.
En las siguientes secciones se muestra cómo crear un clúster de Amazon DocumentDB utilizando el Consola de administración de AWS o el. AWS CLI A continuación, puede añadir instancias de réplica al clúster. Si utiliza la consola para crear el clúster de Amazon DocumentDB, se crea automáticamente una instancia principal al mismo tiempo. Si lo usa AWS CLI para crear su clúster de Amazon DocumentDB, una vez que el estado del clúster esté *disponible*, debe crear la instancia principal para ese clúster.
## Requisitos previos
A continuación, se describen los requisitos previos para crear un clúster de Amazon DocumentDB.
Si no tiene uno Cuenta de AWS, complete los siguientes pasos para crearlo.
**Para suscribirte a una Cuenta de AWS**
1. Abrir [https://portal.aws.amazon.com/billing/registro](https://portal.aws.amazon.com/billing/signup).
1. Siga las instrucciones que se le indiquen.
Parte del procedimiento de registro consiste en recibir una llamada telefónica o mensaje de texto e indicar un código de verificación en el teclado del teléfono.
Cuando te registras en un Cuenta de AWS, *Usuario raíz de la cuenta de AWS*se crea un. El usuario raíz tendrá acceso a todos los Servicios de AWS y recursos de esa cuenta. Como práctica recomendada de seguridad, asigne acceso administrativo a un usuario y utilice únicamente el usuario raíz para realizar [Tareas que requieren acceso de usuario raíz](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
### Requisitos previos de VPC
Solo puede crear un clúster de Amazon DocumentDB en una instancia de Amazon Virtual Private Cloud (Amazon VPC). Amazon VPC debe tener como mínimo una subred en al menos dos de las zonas de disponibilidad para que la use con un clúster de base de datos de Amazon DocumentDB. Mediante la distribución de las instancias del clúster en las zonas de disponibilidad, se garantiza que habrá instancias disponibles en el clúster en el caso improbable de que se produzca un error en una zona.
### Requisitos previos de la subred
Al crear un clúster de Amazon DocumentDB, debe elegir una VPC y el grupo de subredes correspondiente dentro de la VPC para lanzar el clúster. Las subredes determinan la zona de disponibilidad y el rango de direcciones IP de esa zona de disponibilidad que se quieran utilizar para lanzar una instancia. Para los fines de esta exposición, usaremos los términos *subred* y *zona de disponibilidad* indistintamente. Un grupo de subredes es un conjunto de subredes (o zonas de disponibilidad). Un grupo de subredes le permite especificar las zonas de disponibilidad que desea utilizar para lanzar instancias de Amazon DocumentDB. Por ejemplo, para ofrecer un alto nivel de disponibilidad en un clúster con tres instancias, se recomienda que cada una de dichas instancias esté aprovisionada en una zona de disponibilidad distinta. De esa forma, si una de las zonas de disponibilidad deja de funcionar, solo se verá afectada una sola instancia.
Las instancias de Amazon DocumentDB actualmente pueden aprovisionarse en hasta tres zonas de disponibilidad. Aunque un grupo de subredes tenga más de tres subredes, solo podrá utilizar tres de esas subredes para crear un clúster de Amazon DocumentDB. Por ello, es aconsejable que al crear un grupo de subredes solo elija las tres subredes en las que desee implementar las instancias. En el Este de EE. UU. (Norte de Virginia), el grupo de subredes puede tener seis subredes (o zonas de disponibilidad). Sin embargo, cuando se aprovisione un clúster de Amazon DocumentDB, Amazon DocumentDB elige tres de estas zonas de disponibilidad que utiliza para aprovisionar instancias.
Por ejemplo, supongamos que al crear un clúster, Amazon DocumentDB elige las zonas de disponibilidad \$11A, 1B y 1C\$1. Si intenta crear una instancia en la zona de disponibilidad \$11D\$1, la llamada a la API no funcionará correctamente. Sin embargo, si decide crear una instancia sin especificar la zona de disponibilidad concreta, Amazon DocumentDB elegirá una zona de disponibilidad por usted. Amazon DocumentDB utiliza un algoritmo para equilibrar la carga de las instancias en las zonas de disponibilidad para ayudarle a obtener una alta disponibilidad. Por ejemplo, si se aprovisionan tres instancias, de forma predeterminada se repartirán entre tres zonas de disponibilidad en lugar de aprovisionar todas ellas en una única zona de disponibilidad.
**Recomendaciones:**
+ A menos que tenga un motivo específico, cree siempre un grupo de subredes con tres subredes. De esta forma, se asegurará de que los clústeres con tres o más instancias puedan lograr una mayor disponibilidad, debido a que las instancias se aprovisionarán en tres zonas de disponibilidad distintas.
+ Reparta siempre las instancias en varias zonas de disponibilidad para lograr una alta disponibilidad. Nunca ponga todas las instancias de un clúster en una única zona de disponibilidad.
+ Debido a que pueden producirse eventos de conmutación por error en cualquier momento, no debe dar por hecho que una instancia principal o las instancias de réplica siempre están en una zona de disponibilidad determinada.
### Requisitos previos adicionales
A continuación se indican algunos requisitos adicionales para crear un clúster de Amazon DocumentDB:
+ Si se va a conectar AWS mediante credenciales AWS Identity and Access Management (IAM), su cuenta de IAM debe tener políticas de IAM que concedan los permisos necesarios para realizar las operaciones de Amazon DocumentDB.
Si utiliza una cuenta de IAM para acceder a la consola de Amazon DocumentDB, primero debe iniciar sesión en ella con su cuenta Consola de administración de AWS de IAM. [A continuación, vaya a la consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
+ Si desea adaptar los parámetros de configuración a un clúster, debe especificar un grupo de parámetros de clúster y un grupo de parámetros con la configuración de parámetros necesaria. Para obtener información acerca de cómo crear o modificar un grupo de parámetros de clúster o un grupo de parámetros de base de datos, consulte [Administración de los grupos de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups.md).
+ Debe determinar el número de TCP/IP puerto que desea especificar para el clúster. Los firewalls de algunas compañías bloquean las conexiones a estos puertos predeterminados para Amazon DocumentDB. Si el firewall de su compañía bloquea el puerto predeterminado, elija otro puerto para el clúster. Todas las instancias de un clúster usan el mismo puerto.
## Crear un clúster y una instancia principal mediante Consola de administración de AWS
Los siguientes procedimientos describen cómo se usa la consola para lanzar un clúster de Amazon DocumentDB con una o varias instancias.
### Creación de un clúster: uso de la configuración predeterminada
**Para crear un clúster con instancias que utilicen la configuración predeterminada, utilice la Consola de administración de AWS**
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. Si desea crear su clúster en una región que no Región de AWS sea EE. UU. Este (Virginia del Norte), elija la región de la lista que aparece en la sección superior derecha de la consola.
1. En el panel de navegación, elija **Clusters (Clústeres)** y, a continuación, elija **Create (Crear)**.
**sugerencia**
Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-menu-icon.png)) en la esquina superior izquierda de la página.
1. En la página **Crear clúster de Amazon DocumentDB**, complete el panel de **Configuración**.
1. **Identificador de clúster**: acepte el nombre que ha proporcionado Amazon DocumentDB o introduzca un nombre para el clúster; por ejemplo, **sample-cluster**.
Restricciones en cuanto a la nomenclatura de los clústeres:
+ 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 todos los clústeres de Amazon RDS, Neptune y Amazon DocumentDB por región. Cuenta de AWS
1. **Versión del motor**: acepte la versión 5.0.0 del motor predeterminada o, si lo desea, elija la 8.0.0, 4.0.0 o 3.6.0.
1. **Clase de instancia**: puede aceptar la `db.r5.large` predeterminada o elegir una en la lista desplegable.
1. **Número de instancias**: en la lista, elija el número de instancias que desee crear cuando se restaure el clúster. La primera es la instancia principal, todas las demás instancias son instancias de réplica de solo lectura. Puede añadir y eliminar instancias más adelante si las necesita. De forma predeterminada, un clúster de Amazon DocumentDB se lanzará con tres instancias (una principal y dos réplicas).
1. Complete la sección **Configuración del almacenamiento en clúster**.
Elija **Amazon DocumentDB estándar** (predeterminado) o **Amazon DocumentDB optimizado para E/S**. Para obtener más información, consulte [Configuraciones de almacenamiento en clústeres de Amazon DocumentDB](db-cluster-storage-configs.md).
1. Rellene el panel **Authentication (Autenticación)**.
1. **Nombre de usuario**: ingrese un nombre para el usuario principal. Para iniciar sesión en el clúster, debe utilizar el nombre de usuario principal.
Restricciones de denominación de usuario principal:
+ La longitud es de [1-63] caracteres alfanuméricos.
+ El primer carácter debe ser una letra.
+ No puede ser una palabra reservada por el motor de base de datos.
1. Seleccione una de las siguientes opciones de contraseña:
+ **Administrado en AWS Secrets Manager**: elija esta opción si desea administrar automáticamente la contraseña de AWS Secrets Manager su usuario principal.
Si elige esta opción, configure la clave de KMS. Para ello, cree la suya propia o utilice una clave creada por Secrets Manager.
+ **Autoadministrado**: elija esta opción si desea autoadministrar la contraseña de su usuario principal. Si elige esta opción, introduzca una contraseña para el usuario principal y confírmela. Para iniciar sesión en el clúster, debe utilizar la contraseña del usuario principal.
Restricciones para la contraseña:
+ La longitud es de [8-100] caracteres ASCII imprimibles.
+ Se puede utilizar cualquier carácter ASCII imprimible, excepto los siguientes:
+ **/** (barra inclinada)
+ **"** (comillas dobles)
+ **@** (símbolo de arroba)
1. En la parte inferior de la pantalla, elija una de las opciones siguientes:
+ Para crear el clúster ahora, elija **Create cluster (Crear clúster)**.
+ Si no desea crear el clúster, elija **Cancel (Cancelar)**.
+ Para configurar el clúster antes de crearlo, elija **Show additional configurations (Mostrar configuraciones adicionales)** y, a continuación, continúe en [Creación de un clúster: configuraciones adicionales](#db-cluster-create-con-additional-configs).
Las configuraciones que aparecen en **Additional Configurations (Configuraciones adicionales)** son las siguientes:
+ **Configuración de red**: el valor predeterminado es utilizar el grupo de seguridad de VPC `default`.
+ **Opciones de clúster**: de forma predeterminada, se utilizan el puerto 27017 y el grupo de parámetros predeterminado.
+ **Cifrado**: el valor predeterminado es habilitar el cifrado con la clave `(default) aws/rds`.
**importante**
Después de que se cifra un clúster, no es posible descifrarlo.
+ **Copia de seguridad**: el valor predeterminado es conservar las copias de seguridad durante 1 día y dejar que Amazon DocumentDB seleccione el periodo de copia de seguridad.
+ **Exportaciones de registros**: el valor predeterminado es no exportar los registros de auditoría a los CloudWatch registros.
+ **Mantenimiento**: de forma predeterminada, Amazon DocumentDB elige el período de mantenimiento.
+ **Protección contra la eliminación**: proteja sus clústeres contra la eliminación accidental. El valor predeterminado para el clúster creado con la consola es *enabled* (habilitado).
Si acepta los valores predeterminados ahora, podrá cambiar la mayoría de ellos más adelante modificando el clúster.
1. Habilite la conexión entrante del grupo de seguridad de su clúster.
Si no ha cambiado la configuración predeterminada de su clúster, ha creado un clúster mediante el grupo de seguridad predeterminado para la VPC predeterminada en una región en concreto. Para conectarse a Amazon DocumentDB, tiene que habilitar las conexiones entrantes en el puerto 27017 (o el puerto que prefiera) para el grupo de seguridad de su clúster.
**Cómo añadir una conexión entrante al grupo de seguridad de su clúster**
1. Inicie sesión en la consola Amazon EC2 Consola de administración de AWS y ábrala en. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. En la sección **Resources (Recursos)** de la ventana principal, seleccione **Security groups (Grupos de seguridad)**.
![\[Imagen: lista de recursos que destaca la opción de enlace a los grupos de seguridad.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-ec2-security-groups.png)
1. En la lista de grupos de seguridad, localice el grupo de seguridad que utilizó para crear el clúster (lo más probable es que fuera el grupo de seguridad *predeterminado*) y seleccione la casilla situada a la izquierda del nombre del grupo de seguridad.
![\[Imagen: lista de grupos de seguridad que destaca un grupo de seguridad con la casilla seleccionada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-ec2-default-sg.png)
1. En el menú **Actions** (Acciones), elija **Edit inbound rules** (Editar reglas entrantes) y, a continuación, seleccione o especifica las restricciones de las reglas.
1. **Tipo**: en la lista, elija el protocolo para abrir al tráfico de la red.
1. **Protocolo**: en la lista, elija el tipo de protocolo.
1. **Intervalo de puertos**: para una regla personalizada, introduzca un número de puerto o un intervalo de puertos. Asegúrese de que el número de puerto o el rango de puertos incluye el puerto que especificó cuando creó el clúster (predeterminado: 27017).
1. **Origen**: especifica el tráfico que puede llegar a su instancia. En la lista, elija el origen del tráfico. Si selecciona **Custom (Personalizado)**, especifique una única dirección IP o un rango de direcciones IP en notación CIDR (p. ej., 203.0.113.5/32).
1. **Descripción**: escriba una descripción para la regla.
1. Cuando finalice la creación de la regla, seleccione **Save (Guardar)**.
### Creación de un clúster: configuraciones adicionales
Si desea aceptar los valores predeterminados para el clúster, puede omitir los pasos que se describen a continuación y elegir **Create cluster (Crear clúster)**.
1. Rellene el panel **Network settings (Configuración de red)**.
![\[Captura de pantalla que muestra el panel de configuración de red y los pasos para ajustar la configuración de la red.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/create-db-cluster-console-network-settings.png)
1. **Nube privada virtual (VPC):** en la lista, elija la Amazon VPC en la que desea lanzar este clúster.
1. **Grupo de subredes**: en la lista, elija el grupo de subredes que desea utilizar para este clúster.
1. **Grupos de seguridad de VPC**: en la lista, elija el grupo de seguridad para el clúster.
1. Rellene el panel **Cluster options (Opciones de clúster)**.
![\[Captura de pantalla que muestra el panel de opciones de clúster con los pasos para ajustar la configuración del clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/create-db-cluster-console-cluster-options.png)
1. **Puerto de base de datos**: utilice las flechas arriba y abajo para configurar el TCP/IP puerto que utilizarán las aplicaciones para conectarse a la instancia.
1. **Grupo de parámetros de clúster**: en la lista de grupos de parámetros, elija el grupo de parámetros de clúster para este clúster.
1. Rellene el panel **Encryption (Cifrado)**.
![\[Captura de pantalla del panel de cifrado con los pasos para configurar el cifrado del clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/encrypt-at-rest.png)
1. **E ncryption-at-rest**: elija una de las siguientes opciones:
+ **Habilitar el cifrado**: de manera predeterminada. Se cifran todos los datos en reposo. Si decide cifrar los datos, no puede deshacer esta acción.
+ **Deshabilitar cifrado**: los datos no se cifran.
1. **AWS Clave KMS**: solo está disponible si está cifrando sus datos. En la lista, elija la clave que desee utilizar para cifrar los datos de este clúster. El valor predeterminado es `(default) aws/rds`.
Si ha elegido, **Enter a key ARN (Escribir un ARN de clave)**, tendrá que introducir un nombre de recurso de Amazon (ARN) para la clave.
1. Rellene el panel **Backup (Copia de seguridad)**.
![\[Captura de pantalla del panel de copia de seguridad con los pasos para configurar el periodo de copia de seguridad del clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/create-db-cluster-console-backup.png)
1. **Periodo de retención de copias de seguridad**: en la lista, elija el número de días que se deben conservar las copias de seguridad automáticas de este clúster antes de eliminarlas.
1. **Periodo de copia de seguridad**: especifique la hora del día en que Amazon DocumentDB debe hacer las copias de seguridad de este clúster y la duración de las mismas.
1. **Hora de inicio**: en la primera lista, elija la hora de inicio (UTC) para las copias de seguridad automáticas. En la segunda lista, elija el minuto de la hora en que desea que comiencen las copias de seguridad automáticas.
1. **Duración**: en la lista, elija el número de horas que se deben asignar para crear las copias de seguridad automáticas.
1. Complete el panel de **exportaciones de registros** seleccionando los tipos de registros que desea exportar a CloudWatch Logs.
![\[Captura de pantalla del panel de exportaciones de registros con los pasos para configurar el registro de DML del clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/create-db-cluster-console-log-exports.png)
+ **Registros de auditoría**: seleccione esta opción para permitir la exportación de registros de auditoría a Amazon CloudWatch Logs. Si selecciona **Audit logs (Registros de auditoría)**, debe habilitar `audit_logs` en el grupo de parámetros personalizado del clúster. Para obtener más información, consulte [Auditoría de eventos de Amazon DocumentDB](event-auditing.md).
+ **Registros del generador de perfiles**: seleccione esta opción para permitir la exportación de los registros del generador de perfiles de operaciones a Amazon Logs. CloudWatch Si selecciona **Profiler logs (Registros del generador de perfiles)**, también debe modificar los siguientes parámetros en el grupo de parámetros personalizado del clúster:
+ `profiler` establezca en `enabled`.
+ `profiler_threshold_ms` establezca en un valor `[0-INT_MAX]` para definir el umbral para las operaciones de creación de perfiles.
+ `profiler_sampling_rate` establezca en un valor `[0.0-1.0]` para establecer el porcentaje de operaciones lentas en el perfil.
Para obtener más información, consulte [Creación de perfiles de operaciones en Amazon DocumentDB](profiling.md).
1. Rellene el panel **Maintenance (Mantenimiento)**.
![\[Captura de pantalla del panel de mantenimiento con los pasos para configurar el periodo de mantenimiento del clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/create-db-cluster-console-maintenance.png)
1. Elija una de las opciones siguientes.
+ **Seleccionar periodo**: permite especificar el día de la semana y la hora de inicio UTC en que Amazon DocumentDB debe realizar el mantenimiento del clúster y la duración de esta operación.
1. **Día de inicio**: en la lista, elija el día de la semana en que debe iniciarse el mantenimiento del clúster.
1. **Hora de inicio**: en las listas, elija la hora UTC y el minuto UTC en que debe iniciarse el mantenimiento.
1. **Duración**: en la lista, elija el tiempo que se debe asignar para mantenimiento del clúster. Si el mantenimiento no puede finalizar en el tiempo especificado, el proceso de mantenimiento continuará pasado ese tiempo hasta que finalice.
+ **Sin preferencia**: Amazon DocumentDB selecciona el día de la semana, la hora de inicio y la duración para realizar el mantenimiento.
1. Si desea añadir una o más etiquetas a este clúster, complete el panel **Tags** (Etiquetas).
![\[Captura de pantalla de la casilla de verificación Enable deletion protection (Habilitar la protección contra eliminación), que está seleccionada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/create-db-cluster-console-tags.png)
Para cada etiqueta que desee añadir al clúster, repita los pasos siguientes. Puede disponer de hasta 10 en un clúster.
1. Elija **Add tags** (Añadir etiquetas).
1. Escriba la **clave** de la etiqueta.
1. Si lo desea, escriba el **valor** de la etiqueta.
Para quitar una etiqueta, elija **Remove tag** (Eliminar etiqueta).
1. La **protección contra eliminación** se habilita de forma predeterminada cuando crea un clúster mediante la consola. Para deshabilitar la protección contra eliminación, desactive **Habilitar la protección contra eliminación**. Cuando esté habilitada, la protección contra eliminación evitará que se elimine un clúster. Para quitar un clúster protegido contra eliminación, en primer lugar debe modificar el clúster para deshabilitar la protección contra eliminación.
![\[Captura de pantalla de la casilla de verificación Enable deletion protection (Habilitar la protección contra eliminación), que está seleccionada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/create-db-cluster-console-deletion-protection.png)
Para obtener más información sobre la protección contra eliminación, consulte [Eliminación de un clúster de Amazon DocumentDB](db-cluster-delete.md).
1. Para crear el clúster, elija **Create cluster** (Crear clúster). De lo contrario, seleccione **Cancelar**.
## Creación de un clúster mediante AWS CLI
Los siguientes procedimientos describen cómo utilizarlos AWS CLI para lanzar un clúster de Amazon DocumentDB y crear una réplica de Amazon DocumentDB.
**Parameters**
+ **--db-cluster-identifier**: obligatorio. Una cadena en minúsculas que identifica este clúster.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/db-cluster-create.html)
+ **--engine**: obligatorio. Debe ser **docdb**.
+ **--deletion-protection \$1 --no-deletion-protection**: opcional. Cuando la protección contra eliminación esté habilitada, evitará que se elimine un clúster. Cuando se utiliza AWS CLI, la configuración predeterminada es desactivar la protección contra la eliminación.
Para obtener más información sobre la protección contra eliminación, consulte [Eliminación de un clúster de Amazon DocumentDB](db-cluster-delete.md).
+ **--storage-type standard \$1 iopt1**: opcional. Predeterminado: **standard**. Configuración de almacenamiento en clústeres. Los valores válidos son `standard` (estándar) o `iopt1` (optimizado para E/S).
+ **--master-username**: obligatorio. El nombre de usuario que se utiliza para autenticar al usuario.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/db-cluster-create.html)
+ **--master-user-password**: opcional. La contraseña de usuario que se utiliza para autenticar al usuario.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/db-cluster-create.html)
+ **--manage-master-user-password**: opcional. Amazon DocumentDB genera la contraseña del usuario maestro y la administra durante todo su ciclo de vida en Secrets Manager.
Para ver otros parámetros, consulte [CreateDBCluster](API_CreateDBCluster.md).
**Para lanzar un clúster de Amazon DocumentDB mediante AWS CLI**
Para crear un clúster de Amazon DocumentDB, llame a. `create-db-cluster` AWS CLI El siguiente AWS CLI comando crea un clúster de Amazon DocumentDB denominado `sample-cluster` con la protección de eliminación habilitada. Para obtener más información sobre la protección contra eliminación, consulte [Eliminación de un clúster de Amazon DocumentDB](db-cluster-delete.md).
Además, `--engine-version` es un parámetro opcional que utiliza de forma predeterminada la última versión principal del motor. La versión predeterminada actual del motor es 5.0.0 (nota: Amazon DocumentDB 8.0 está disponible, pero debe especificarse de forma explícita). Cuando se publiquen nuevas versiones principales del motor, la versión del motor predeterminada para `--engine-version` se actualizará para reflejar la última versión principal del motor. En consecuencia, para las cargas de trabajo de producción, y especialmente las que dependen de la creación de scripts, la automatización o CloudFormation las plantillas, le recomendamos que especifique de forma explícita la versión principal `--engine-version` prevista.
**nota**
Si no se especifica un `db-subnet-group-name` o un `vpc-security-group-id`, Amazon DocumentDB utilizará el grupo de subredes y el grupo de seguridad de Amazon VPC predeterminados para la región determinada.
Para Linux, macOS o Unix:
```
aws docdb create-db-cluster \
--db-cluster-identifier sample-cluster \
--engine docdb \
--engine-version 5.0.0 \
--deletion-protection \
--master-username masteruser \
--master-user-password password
```
Para Windows:
```
aws docdb create-db-cluster ^
--db-cluster-identifier sample-cluster ^
--engine docdb ^
--engine-version 5.0.0 ^
--deletion-protection ^
--master-username masteruser ^
--master-user-password password
```
La salida de esta operación será similar a lo que se indica a continuación (formato JSON).
```
{
"DBCluster": {
"StorageEncrypted": false,
"DBClusterMembers": [],
"Engine": "docdb",
"DeletionProtection" : "enabled",
"ClusterCreateTime": "2018-11-26T17:15:19.885Z",
"DBSubnetGroup": "default",
"EngineVersion": "5.0.0",
"MasterUsername": "masteruser",
"BackupRetentionPeriod": 1,
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"DBClusterIdentifier": "sample-cluster",
"MultiAZ": false,
"DBClusterParameterGroup": "default.docdb5.0",
"PreferredBackupWindow": "09:12-09:42",
"DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
"PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
"Port": 27017,
"Status": "creating",
"ReaderEndpoint": "sample-cluster.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
"AssociatedRoles": [],
"HostedZoneId": "ZNKXTT8WH85VW",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"AvailabilityZones": [
"us-east-1a",
"us-east-1c",
"us-east-1e"
],
"Endpoint": "sample-cluster.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
}
}
```
La creación del clúster puede tardar varios minutos. Puede utilizar la Consola de administración de AWS o AWS CLI para supervisar el estado de su clúster. Para obtener más información, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-cluster_status.md).
**importante**
Cuando se utiliza AWS CLI para crear un clúster de Amazon DocumentDB, no se crea ninguna instancia. Por lo tanto, tendrá que crear de forma explícita una instancia principal y las instancias de réplica que necesite. Puede usar la consola o AWS CLI para crear las instancias. Para obtener más información, consulte [Agregación de una instancia de Amazon DocumentDB a un clúster](db-instance-add.md).
Para obtener más información, consulte [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html) en la *Referencia de la API de Amazon DocumentDB*.
# Descripción de los clústeres 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 y los grupos de parámetros relacionados con sus clústeres de Amazon DocumentDB. VPCs
Para obtener más información, consulte los siguientes temas:
+ [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-cluster_status.md)
+ [Búsqueda de puntos de conexión de un clúster](db-cluster-endpoints-find.md)
------
#### [ Using the Consola de administración de AWS ]
Use el siguiente procedimiento para ver los detalles de un clúster de Amazon DocumentDB especificado 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 la lista de clústeres, elija el nombre del clúster cuyos detalles desea ver. La información sobre el clúster está organizada en las siguientes agrupaciones:
+ **Resumen**: información general sobre el clúster, incluida la versión del motor, el estado del clúster, el mantenimiento pendiente y el estado de su grupo de parámetros.
+ **Conectividad y seguridad**: la sección **Conectar** muestra los puntos de conexión para conectarse a este clúster 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 este clúster y su ID de VPC y descripciones.
+ **Configuración** la sección **Detalles del clúster** muestra detalles sobre el clúster, incluidos el nombre de recurso de Amazon (ARN), el punto de conexión y el grupo de parámetros de clúster. También muestra la información de copia de seguridad del clúster, los detalles de mantenimiento y la configuración de seguridad y red. La sección **Instancias del clúster** muestra las instancias que pertenecen a este clúster con el rol de cada instancia y el estado del grupo de parámetros del clúster.
+ **Supervisión**: las métricas de Amazon CloudWatch Logs de este clúster. Para obtener más información, consulte [Supervisión de Amazon DocumentDB con CloudWatch](cloud_watch.md).
+ **Eventos y etiquetas**: en la sección de **eventos recientes** se enumeran los eventos recientes de este clúster. 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.
------
#### [ Using the AWS CLI ]
Para ver los detalles de sus clústeres 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_DescribeDBClusters.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.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.
**Example**
**Ejemplo 1: enumerar todos los clústeres de Amazon DocumentDB**
El AWS CLI código siguiente muestra los detalles de todos los clústeres de Amazon DocumentDB de una región.
```
aws docdb describe-db-clusters --filter Name=engine,Values=docdb
```
La salida de esta operación será similar a lo que se indica a continuación.
```
{
"DBClusters": [
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-1",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-2",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-3",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
}
]
}
```
**Example**
**Ejemplo 2: mostrar todos los detalles de un clúster de Amazon DocumentDB especificado**
En el AWS CLI código siguiente se enumeran los detalles del clúster`sample-cluster`.
Para Linux, macOS o Unix:
```
aws docdb describe-db-clusters \
--filter Name=engine,Values=docdb \
--db-cluster-identifier sample-cluster
```
Para Windows:
```
aws docdb describe-db-clusters ^
--filter Name=engine,Values=docdb ^
--db-cluster-identifier sample-cluster
```
La salida de esta operación será similar a lo que se indica a continuación.
```
{
"DBClusters": [
{
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-east-1c",
"us-east-1a",
"us-east-1d"
],
"BackupRetentionPeriod": 2,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
"EarliestRestorableTime": "2023-11-07T22:34:08.148000+00:00",
"Endpoint": "sample-cluster.node.us-east-1.amazon.com",
"ReaderEndpoint": "sample-cluster.node.us-east-1.amazon.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "5.0.0",
"LatestRestorableTime": "2023-11-10T07:21:16.772000+00:00",
"Port": 27017,
"MasterUsername": "chimeraAdmin",
"PreferredBackupWindow": "22:22-22:52",
"PreferredMaintenanceWindow": "sun:03:01-sun:03:31",
"ReadReplicaIdentifiers": [],
"DBClusterMembers": [
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-9084c2ec",
"Status": "active"
}
],
"HostedZoneId": "Z06853723JYKYBXTJ49RB",
"StorageEncrypted": false,
"DbClusterResourceId": "cluster-T4LGLANHVAPGQYYULWUDKLVQL4",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"AssociatedRoles": [],
"IAMDatabaseAuthenticationEnabled": false,
"ClusterCreateTime": "2023-11-06T18:05:41.568000+00:00",
"EngineMode": "provisioned",
"DeletionProtection": false,
"HttpEndpointEnabled": false,
"CopyTagsToSnapshot": false,
"CrossAccountClone": false,
"DomainMemberships": [],
"TagList": [],
"StorageType": "iopt1",
"AutoMinorVersionUpgrade": false,
"NetworkType": "IPV4",
"IOOptimizedNextAllowedModificationTime": "2023-12-07T18:05:41.580000+00:00"
}
]
}
```
**Example**
**Ejemplo 3:** mostrar detalles específicos de un clúster de Amazon DocumentDB
Para enumerar un subconjunto de los detalles de los clústeres mediante el AWS CLI, añada un elemento `--query` que especifique los miembros del clúster que se van a enumerar en la `describe-db-clusters` operación. El parámetro de `--db-cluster-identifier` es el identificador del clúster concreto del que desea mostrar los detalles. Para obtener más información sobre consultas, consulte [Cómo filtrar la salida con la opción `--query`](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output.html#controlling-output-filter) en la *Guía de usuario de AWS Command Line Interface *.
En el siguiente ejemplo de la se muestran las instancias de un clúster de Amazon DocumentDB.
Para Linux, macOS o Unix:
```
aws docdb describe-db-clusters \
--filter Name=engine,Values=docdb \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterMembers]'
```
Para Windows:
```
aws docdb describe-db-clusters ^
--filter Name=engine,Values=docdb ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterMembers]'
```
La salida de esta operación será similar a lo que se indica a continuación.
```
[
[
[
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": false,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
]
]
]
```
------
# Modificación de un clúster de Amazon DocumentDB
Para modificar un clúster, el clúster debe tener el estado *available (disponible)*. No puede modificar 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, 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 ]
Utilice el siguiente procedimiento para modificar un clúster de Amazon DocumentDB específico mediante la consola.
**Modificación de un clúster 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. Especifique el clúster que desee modificar seleccionando el botón situado a la izquierda del nombre del clúster.
1. Elija **Actions (Acciones)** y después **Modify (Modificar)**.
1. En el panel **Modify Cluster: (Modificar clúster: **, realice los cambios que desee. Puede realizar cambios en las siguientes áreas:
+ **Especificaciones del clúster**: nombre del clúster, grupos de seguridad y administración de credenciales.
+ **Configuración del almacenamiento en clúster**: el modo de almacenamiento de datos del clúster. Elija entre configuración estándar u optimizada para E/S.
+ **Opciones del clúster**: el grupo de parámetros y el puerto del clúster.
+ **Copia de seguridad**: el período de copia de seguridad y de retención de la copia de seguridad del clúster.
+ **Exportación de registros**: permite habilitar o deshabilitar los registros de auditoría o perfiles de exportación.
+ **Mantenimiento**: permite establecer la ventana de mantenimiento del clúster.
+ **Protección de eliminación**: permite habilitar o deshabilitar la protección de eliminación en el clúster. La protección contra eliminación está habilitada de forma predeterminada.
1. Cuando haya terminado, elija **Continuar** para ver un resumen de los cambios.
1. Si está satisfecho con los cambios, puede elegir **Modificar clúster** para modificar el clúster. También puede elegir **Atrás** o **Cancelar** para editar o cancelar los cambios, respectivamente.
Los cambios pueden tardar unos minutos en aplicarse. Solo se puede usar el clúster cuando su estado sea *available (disponible)*. Puede monitorizar el estado del clúster 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-cluster_status.md).
------
#### [ Using the AWS CLI ]
Utilice la operación `modify-db-cluster` para modificar el clúster especificado mediante la AWS CLI. Para obtener más información, consulte [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html) en la *Referencia de la API de Amazon DocumentDB*.
**Parameters**
+ **--db-cluster-identifier**: obligatorio. El identificador del clúster de Amazon DocumentDB que va a modificar.
+ **--backup-retention-period**: opcional. El número de días durante los que se retienen las copias de seguridad automatizadas. Los valores válidos están comprendidos entre 1 y 35.
+ **--storage-type**: opcional. Configuración de almacenamiento en clústeres. Los valores válidos son `standard` (estándar) o `iopt1` (optimizado para E/S).
+ **--db-cluster-parameter-group-name**: opcional. El nombre del grupo de parámetros de clúster que se va a usar para el clúster.
+ **--manage-master-user-password**: opcional. Amazon DocumentDB genera la contraseña del usuario maestro y la administra durante todo su ciclo de vida en Secrets Manager.
+ **--rotate-master-user-password**: opcional. Secrets Manager genera una nueva versión de secreto para el secreto existente. La nueva versión del secreto contiene la nueva contraseña de usuario principal. Amazon DocumentDB cambia la contraseña del usuario principal para el clúster para que coincida con la contraseña de la nueva versión del secreto.
Debe especificar la opción **--apply-immediately** cuando rota la contraseña principal.
+ **--master-user-password**: opcional. La nueva contraseña del usuario de la base de datos principal.
Restricciones para la contraseña:
+ La longitud es de 8 a 100 caracteres ASCII imprimibles.
+ Se puede utilizar cualquier carácter ASCII imprimible, excepto los siguientes:
+ **/** (barra inclinada)
+ **"** (comillas dobles)
+ **@** (símbolo de arroba)
+ **--new-db-cluster-identifier**: opcional. El nuevo identificador del clúster cuando se cambia el nombre de un clúster. Este valor se almacena como una cadena en minúsculas.
Restricciones en la nomenclatura:
+ 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 todos los clústeres de Amazon RDS, Amazon Neptune y Amazon DocumentDB por región. Cuenta de AWS
+ **--preferred-backup-window**: opcional. El intervalo de tiempo diario (en Tiempo Universal Coordinado [UTC]) durante el cual se crean copias de seguridad automatizadas.
+ Formato: `hh24:mm-hh24:mm`
+ **--preferred-maintenance-window**: opcional. El intervalo de tiempo semanal (en UTC) durante el cual puede llevarse a cabo el mantenimiento del sistema.
+ Formato: `ddd:hh24:mm-ddd:hh24:mm`
+ Días válidos: `Sun`, `Mon`, `Tue`, `Wed`, `Thu`, `Fri` y `Sat`.
+ **--deletion-protection** o **--no-deletion-protection**: opcional. Si la protección contra eliminación se debe habilitar en este clúster. La protección contra eliminación evita que el clúster se elimine accidentalmente hasta que se modifique para 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).
+ **--apply-immediately** o **--no-apply-immediately**: utilice `--apply-immediately` para aplicar los cambios inmediatamente. Utilice `--no-apply-immediately` para aplicar el cambio durante el próximo periodo de mantenimiento de su clúster.
**Example**
El siguiente código cambia el periodo de retención de copia de seguridad del clúster `sample-cluster`.
Para Linux, macOS o Unix:
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--apply-immediately \
--backup-retention-period 7
```
Para Windows:
```
aws docdb modify-db-cluster ^
--db-cluster-identifier sample-cluster ^
--apply-immediately ^
--backup-retention-period 7
```
La salida de esta operación será similar a lo que se indica a continuación.
```
{
"DBCluster": {
"BackupRetentionPeriod": 7,
"DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE",
"Status": "available",
"DBClusterMembers": [
{
"PromotionTier": 1,
"DBClusterParameterGroupStatus": "in-sync",
"DBInstanceIdentifier": "sample-cluster-instance",
"IsClusterWriter": true
}
],
"ReadReplicaIdentifiers": [],
"AvailabilityZones": [
"us-east-1b",
"us-east-1c",
"us-east-1a"
],
"ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PreferredMaintenanceWindow": "sat:09:51-sat:10:21",
"EarliestRestorableTime": "2018-06-17T00:06:19.374Z",
"StorageEncrypted": false,
"MultiAZ": false,
"AssociatedRoles": [],
"MasterUsername": "",
"DBClusterIdentifier": "sample-cluster",
"VpcSecurityGroups": [
{
"Status": "active",
"VpcSecurityGroupId": "sg-77186e0d"
}
],
"HostedZoneId": "Z2SUY0A1719RZT",
"LatestRestorableTime": "2018-06-18T21:17:05.737Z",
"AllocatedStorage": 1,
"Port": 27017,
"Engine": "docdb",
"DBClusterParameterGroup": "default.docdb3.4",
"Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBSubnetGroup": "default",
"PreferredBackupWindow": "00:00-00:30",
"EngineVersion": "3.4",
"ClusterCreateTime": "2018-06-06T19:25:47.991Z",
"IAMDatabaseAuthenticationEnabled": false
}
}
```
Los cambios pueden tardar unos minutos en aplicarse. Solo se puede usar el clúster cuando su estado sea *available (disponible)*. Puede monitorizar el estado del clúster 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-cluster_status.md).
------
# Determinación de las tareas de mantenimiento pendientes
Para saber si tiene la versión del motor de Amazon DocumentDB más reciente, determine si hay pendientes tareas de mantenimiento del clúster.
------
#### [ Using the Consola de administración de AWS ]
Puede usarlo Consola de administración de AWS para determinar si un clúster tiene tareas pendientes de mantenimiento.
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. Localice la columna **Maintenance (Mantenimiento)** para determinar si un clúster tiene tareas de mantenimiento pendientes.
![\[Captura de pantalla de la consola en la que se muestra el campo de mantenimiento de clústeres de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-cluster-pending-maintenance.png)
**None (Ninguno)** indica que el clúster está ejecutando la versión más reciente del motor. **Available (Disponible)** indica que el clúster tiene pendientes tareas de mantenimiento, lo que podría significar que es necesario realizar una actualización del motor.
1. Si el clúster tiene pendientes tareas de mantenimiento, continúe con los pasos que se indican en [Actualización de un parche a la versión del motor de un clúster](db-cluster-version-upgrade.md).
------
#### [ Using the AWS CLI ]
Puede utilizarla AWS CLI para determinar si un clúster tiene la última versión del motor mediante la `describe-pending-maintenance-actions` operación con los siguientes parámetros.
**Parameters**
+ **--resource-identifier**: opcional. El ARN del recurso (clúster). Si este parámetro se omite, se enumeran las operaciones de mantenimiento pendientes de todos los clústeres.
+ **--region**: opcional. La región de AWS en la que desea ejecutar esta operación, por ejemplo, `us-east-1`.
**Example**
Para Linux, macOS o Unix:
```
aws docdb describe-pending-maintenance-actions \
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster \
--region us-east-1
```
Para Windows:
```
aws docdb describe-pending-maintenance-actions ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
--region us-east-1
```
La salida de esta operación será similar a lo que se indica a continuación.
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PendingMaintenanceActionDetails": [
{
"Description": "New feature",
"Action": "db-upgrade",
"ForcedApplyDate": "2019-02-25T21:46:00Z",
"AutoAppliedAfterDate": "2019-02-25T07:41:00Z",
"CurrentApplyDate": "2019-02-25T07:41:00Z"
}
]
}
]
}
```
Si el clúster tiene pendientes tareas de mantenimiento, continúe con los pasos que se indican en [Actualización de un parche a la versión del motor de un clúster](db-cluster-version-upgrade.md).
------
# Actualización de un parche a la versión del motor de un clúster
En esta sección, explicaremos cómo implementar una actualización de parche mediante el Consola de administración de AWS o el AWS CLI. Una actualización de parche es una actualización dentro de la misma versión del motor (por ejemplo, la actualización de una versión del motor 3.6 a una versión del motor 3.6 más reciente). Puede actualizarla inmediatamente o durante el próximo periodo de mantenimiento del clúster. Para determinar si el motor necesita una actualización, consulte [Determinación de las tareas de mantenimiento pendientes](db-cluster-determine-pending-maintenance.md). Tenga en cuenta que, al aplicar la actualización, su clúster sufrirá algún tiempo de inactividad.
**nota**
Si está intentando actualizar desde una versión principal del motor a otra, como de la 3.6 a la 5.0, consulte [Actualización local de la versión principal Amazon DocumentDB](docdb-mvu.md) o [Actualización del clúster de Amazon DocumentDB mediante AWS Database Migration Service](docdb-migration.versions.md). Una actualización local de la versión principal solo admite docdb 5.0 como versión del motor de destino.
Existen dos requisitos de configuración para obtener las actualizaciones de parches más recientes para la versión del motor de un clúster:
+ El estado del clúster debe ser *disponible*.
+ El clúster debe estar ejecutando una versión del motor más antigua.
------
#### [ Using the Consola de administración de AWS ]
El siguiente procedimiento actualiza los parches de la versión del motor de su clúster a la versión más reciente con la consola. Puede actualizarla inmediatamente o durante el próximo periodo de mantenimiento del clúster.
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)**. En la lista de clústeres, elija el botón situado a la izquierda del clúster que desee actualizar. El estado del clúster debe ser *disponible*.
**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 menú **Actions (Acciones)**, elija una de las opciones siguientes. Estas opciones de menú solo se pueden seleccionar si en el clúster elegido no se está ejecutando la última versión del motor.
![\[Imagen: acciones de actualización de Amazon DocumentDB\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-upgrade-action.png)
+ **Actualizar ahora**: inicia inmediatamente el proceso de actualización. El clúster se quedará sin conexión durante un tiempo mientras se actualiza a la última versión del motor.
+ **Actualizar en el siguiente periodo**: inicia el proceso de actualización durante el próximo periodo de mantenimiento del clúster. El clúster se quedará sin conexión durante un tiempo mientras se actualiza a la última versión del motor.
1. Cuando se abra la ventana de confirmación, seleccione una de las siguientes opciones:
+ **Actualizar**: para actualizar el clúster a la última versión del motor de acuerdo con el plan elegido en el paso anterior.
+ **Cancelar**: para cancelar la actualización del motor del clúster y continuar con la versión actual del motor del clúster.
------
#### [ Using the AWS CLI ]
Puede aplicar actualizaciones de parches a su clúster mediante la `apply-pending-maintenance-action` operación AWS CLI y con los siguientes parámetros.
**Parameters**
+ **--resource-identifier**: obligatorio. El ARN del clúster de Amazon DocumentDB que va a actualizar.
+ **--apply-action**: obligatorio. Se permiten los siguientes valores. Para actualizar la versión de su motor de clúster, utilice `db-upgrade`.
+ **db-upgrade**
+ **system-update**
+ **--opt-in-type**: obligatorio. Se permiten los siguientes valores.
+ `immediate`: aplicar inmediatamente la acción de mantenimiento.
+ `next-maintenance`: aplicar la operación de mantenimiento durante el siguiente período de mantenimiento.
+ `undo-opt-in`: cancelar todas las solicitudes de alta `next-maintenance` existentes.
**Example**
En el siguiente ejemplo se actualiza la versión del motor de `sample-cluster` a la versión 4.0.0.
Para Linux, macOS o Unix:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
--apply-action db-upgrade \
--opt-in-type immediate
```
Para Windows:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
--apply-action db-upgrade ^
--opt-in-type immediate
```
El resultado de esta operación será similar a lo que se indica a continuación:
```
{
"ResourcePendingMaintenanceActions": {
"ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
"PendingMaintenanceActionDetails": [
{
"CurrentApplyDate": "2019-02-20T20:57:06.904Z",
"Description": "Bug fixes",
"ForcedApplyDate": "2019-02-25T21:46:00Z",
"OptInStatus": "immediate",
"Action": "db-upgrade",
"AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
}
]
}
}
```
------
# Detención e inicio de un clúster de bases de datos de Amazon DocumentDB
La detención e inicio de los clústeres de Amazon DocumentDB puede ayudarle a administrar los costos de entornos de desarrollo y pruebas. En lugar de crear y eliminar clústeres y las instancias cada vez que utilice Amazon DocumentDB, puede detener temporalmente todas las instancias en el clúster cuando ya no son necesarias. A continuación, puede iniciarlos de nuevo cuando reanude sus pruebas.
**Topics**
+ [Información general de detención e inicio de un clúster](#db-cluster-stop-start-overview)
+ [Operaciones que puede llevar a cabo en un clúster detenido](#db-cluster-stopped-operations)
## Información general de detención e inicio de un clúster
Durante los periodos en los que no necesite un clúster de Amazon DocumentDB, puede detener todas las instancias de ese clúster a la vez. A continuación, puede volver a iniciar el clúster en cualquier momento que necesite usarlo. El inicio y la detención simplifican los procesos de configuración y eliminación de clústeres usados para desarrollo, pruebas o actividades similares que no requieren disponibilidad continua. Puede detener e iniciar un clúster con Consola de administración de AWS o AWS CLI con una sola acción, independientemente del número de instancias que haya en el clúster.
Aunque el clúster se detenga, el volumen de almacenamiento del clúster permanece sin cambios. Solo se le cobrará el almacenamiento, las instantáneas manuales y el almacenamiento de la copia de seguridad automática dentro de su intervalo de retención especificado. No se le cobrarán las horas de ninguna instancia. Después de siete días, Amazon DocumentDB vuelve a iniciar automáticamente el clúster de base de datos para asegurarse de llevar a cabo las actualizaciones de mantenimiento necesarias. Cuando el clúster comience después de siete días, se le comenzará a cobrar las instancias en el clúster de nuevo. Cuando el clúster se detenga, no podrá consultar el volumen de almacenamiento, ya que la consulta requiere que las instancias estén disponibles.
Cuando se detiene un clúster de Amazon DocumentDB, ni el clúster ni sus instancias se pueden modificar en modo alguno. Esto incluye añadir o eliminar instancias o eliminar el clúster.
------
#### [ Using the Consola de administración de AWS ]
El procedimiento siguiente le muestra cómo detener un clúster con una o varias instancias en un estado disponible o iniciar un clúster detenido.
**Detención o inicio de un clúster 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. En la lista de clústeres, elija el botón situado a la izquierda del nombre del clúster que quiera detener o iniciar.
1. Elija **Actions** (Acciones) y, a continuación, elija la acción que desea realizar en el clúster.
+ Si desea detener el clúster y el clúster está disponible:
1. Elija **Detener**.
![\[Imagen: detención de un clúster\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cluster-stop.png)
Para evitar la activación del mecanismo de conmutación por error, la operación de detención para primero las instancias de réplica y, a continuación, la instancia principal.
1. En el cuadro de diálogo de confirmación, acepte que desea detener el clúster seleccionado **Stop cluster** (Detener clúster) o mantenga el clúster en ejecución mediante **Cancel** (Cancelar).
![\[Imagen: inicio de un clúster\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cluster-stop-confirm.png)
+ Si desea iniciar el clúster y este se detiene, seleccione **Start** (Iniciar).
![\[Imagen: inicio de un clúster\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cluster-start.png)
1. Monitorice el estado del clúster y sus instancias. Si ha iniciado el clúster, podrá volver a utilizar el clúster cuando este y sus instancias estén *disponibles*. Para obtener más información, consulte [Determinación del estado de un clúster](db-cluster-status.md).
![\[Imagen: estado de los clústeres detenidos e iniciados\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cluster-stop-start-status.png)
------
#### [ Using the AWS CLI ]
Los siguientes ejemplos de código le muestras cómo detener un clúster con una o varias instancias en un estado disponible o iniciar un clúster detenido.
Para detener un clúster con una o más instancias disponibles mediante el AWS CLI, utilice la operación. `stop-db-cluster` Para iniciar un clúster detenido, utilice la operación `start-db-cluster`. En ambas operaciones se utiliza el parámetro `--db-cluster-identifier`.
**Parámetro**
+ **--db-cluster-identifier**: obligatorio. El nombre del clúster que detener e iniciar.
**Example — Para detener un clúster mediante el AWS CLI**
El siguiente código detiene el clúster `sample-cluster`. El clúster debe tener una o más instancias en un estado disponible.
Para Linux, macOS o Unix:
```
aws docdb stop-db-cluster \
--db-cluster-identifier sample-cluster
```
Para Windows:
```
aws docdb stop-db-cluster ^
--db-cluster-identifier sample-cluster
```
**Example — Para iniciar un clúster mediante el AWS CLI**
El siguiente código inicia el clúster `sample-cluster`. El clúster debe estar detenido actualmente.
Para Linux, macOS o Unix:
```
aws docdb start-db-cluster \
--db-cluster-identifier sample-cluster
```
Para Windows:
```
aws docdb start-db-cluster ^
--db-cluster-identifier sample-cluster
```
------
## Operaciones que puede llevar a cabo en un clúster detenido
Mientras un clúster de Amazon DocumentDB esté detenido, puede realizar una point-in-time restauración en cualquier punto dentro del período de retención de copias de seguridad automatizado especificado. Para obtener más información sobre cómo realizar una point-in-time restauración, consulte[Restauración a un momento dado](backup_restore-point_in_time_recovery.md).
No se puede modificar la configuración de un clúster de Amazon DocumentDB ni de ninguna de sus instancias mientras el clúster esté detenido. Tampoco puede añadir ni quitar instancias del clúster, ni eliminar el clúster si todavía tiene alguna instancia asociada. Debe iniciar el clúster antes de realizar cualquier tarea administrativa de ese tipo.
Amazon DocumentDB aplica cualquier mantenimiento programado a su clúster detenido solo después de que se vuelva a iniciar. Después de siete días, Amazon DocumentDB inicia automáticamente un clúster detenido para que no se quede demasiado rezagado en su estado de mantenimiento. Cuando el clúster se reinicie, se le comenzará a cobrar las instancias en el clúster de nuevo.
Cuando un clúster está detenido, Amazon DocumentDB no realiza los copias de seguridad automatizadas ni amplía el período de retención de copia de seguridad.
# Eliminación de un clúster de Amazon DocumentDB
Puede eliminar un clúster de Amazon DocumentDB mediante el Consola de administración de AWS o el. AWS CLI Para eliminar un clúster, el clúster debe tener el estado *disponible* y no debe tener ninguna instancia asociada a él. Si el clúster está detenido, inicie primero el clúster, espere a que el clúster esté *disponible*, y, a continuación, elimine el clúster. 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).
## Protección contra eliminación
Para proteger su clúster contra la eliminación accidental, puede habilitar la *protección contra eliminación*. La protección contra eliminación se habilita de forma predeterminada cuando crea un clúster mediante la consola. Sin embargo, la protección contra eliminación está deshabilitada de forma predeterminada si crea un clúster con la AWS CLI.
Amazon DocumentDB aplica la protección contra eliminación para un clúster si realiza la operación de eliminación mediante la consola o la 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.
Cuando use la consola con la protección contra eliminación habilitada en un clúster, no podrá eliminar la última instancia del clúster, ya que también se eliminará el clúster. Puede eliminar la última instancia de un clúster con protección contra eliminación con la AWS CLI. Sin embargo, el propio clúster sigue existiendo y se conservan los datos. Puede acceder a los datos mediante la creación de nuevas instancias para el clúster. Para obtener más información sobre cómo habilitar y deshabilitar la protección contra eliminación, consulte:
+ [Creación de un clúster de Amazon DocumentDB](db-cluster-create.md)
+ [Modificación de un clúster de Amazon DocumentDB](db-cluster-modify.md)
------
#### [ Using the Consola de administración de AWS ]
Para eliminar un clúster mediante el Consola de administración de AWS, la protección de eliminación debe estar deshabilitada.
**Para determinar si un clúster tiene habilitada la protección contra eliminación, realice el siguiente procedimiento:**
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. Tenga en cuenta que en el cuadro de navegación de clústeres, la columna **Identificador de clústeres** muestra tanto los clústeres como las instancias. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla.
![\[Imagen: cuadro de navegación de clústeres que muestra una lista de los enlaces de clústeres existentes y sus correspondientes enlaces de instancia.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/clusters.png)
1. Elija el nombre del clúster y seleccione la pestaña **Configuración**. En la sección **Detalles del clúster** busque **Protección contra eliminación**. Si la protección contra eliminación está habilitada, modifique el clúster para deshabilitar la protección contra eliminación. Para obtener más información sobre la modificación de un clúster, consulte [Modificación de un clúster de Amazon DocumentDB](db-cluster-modify.md).
Una vez que se deshabilite la **protección contra eliminación**, podrá eliminar el clúster.
**Para eliminar un clúster:**
1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
1. Determine si el clúster tiene alguna instancia; para ello, compruebe la columna **Identificador de clústeres** para determinar si aparecen las instancias enumeradas a continuación. Para poder eliminar un clúster, debe eliminar todas sus instancias. Para obtener más información, consulte [Eliminación de una instancia de Amazon DocumentDB](db-instance-delete.md).
1. Si su clúster dispone de instancias, realice uno de los siguientes pasos.
+ Si el clúster no tiene instancias, seleccione el botón situado a la izquierda del nombre del clúster y elija **Acciones**. En el menú desplegable, seleccione **Eliminar**. Complete el cuadro de diálogo **Delete ** (Eliminar ) y, a continuación, elija **Delete** (Eliminar).
+ Si el clúster tiene una o varias instancias, haga lo siguiente:
1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
1. Elimine cada una de las instancias del clúster. Para ello, seleccione la casilla de verificación situada a la izquierda del nombre del clúster. Seleccione **Acciones** y, a continuación, elija **Eliminar**. Complete el cuadro de diálogo **Delete ** (Eliminar ) y, a continuación, elija **Delete** (Eliminar).
Cuando elimine la última instancia, el clúster también se eliminará. Para obtener más información sobre la eliminación de instancias, consulte [Eliminación de una instancia de Amazon DocumentDB](db-instance-delete.md).
La eliminación del clúster puede tardar varios minutos. Para monitorizar el estado del clúster, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
#### [ Using the AWS CLI ]
No puede eliminar un clúster que tenga instancias asociadas. Para determinar qué instancias están asociadas al clúster, ejecute el comando `describe-db-clusters` y elimine todas las instancias del clúster. A continuación, si es necesario, deshabilite la protección contra eliminación de su clúster y, por último, elimine el clúster.
1. **En primer lugar, elimine todas las instancias del clúster.**
Para determinar qué instancias necesita eliminar, ejecute el siguiente comando.
```
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 (formato JSON).
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
Si el clúster que desea eliminar tiene instancias, elimínelas como se muestra a continuación.
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance
```
1. **En segundo lugar, deshabilite la protección contra eliminación.**
El uso de AWS CLI para eliminar todas las instancias de un clúster no elimina el clúster. También debe eliminar el clúster, pero puede hacerlo solo si se deshabilita la protección contra eliminación.
Para determinar si el clúster tiene la protección contra eliminación habilitada, ejecute el siguiente comando.
**sugerencia**
Para ver el estado de la protección contra eliminación de todos los clústeres de Amazon DocumentDB, omita el parámetro `--db-cluster-identifier`.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DeletionProtection]'
```
La salida de esta operación será similar a lo que se indica a continuación.
```
[
[
"sample-cluster",
"true"
]
]
```
Si el clúster tiene la protección contra eliminación habilitada, modifique el clúster y deshabilite la protección contra eliminación. Para deshabilitar la protección contra eliminación en el clúster, ejecute el siguiente comando.
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--no-deletion-protection \
--apply-immediately
```
1. **Por último, elimine el clúster.**
Una vez que la protección contra eliminación esté deshabilitada, podrá eliminar el clúster. Para eliminar un clúster, utilice la operación `delete-db-cluster` con los siguientes parámetros.
+ **--db-cluster-identifier**: obligatorio. El identificador del clúster que desee eliminar.
+ **--final-db-snapshot-identifier**: opcional. Si desea una instantánea final, debe incluir este parámetro con un nombre para la instantánea final. Debe incluir `--final-db-snapshot-identifier` o `--skip-final-snapshot`.
Restricciones en la nomenclatura:
+ 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 todos los clústeres de Amazon RDS, Amazon Neptune y Amazon DocumentDB por región. Cuenta de AWS
+ **--skip-final-snapshot**: opcional. Use este parámetro solo si no desea realizar una instantánea final antes de eliminar el clúster. El comportamiento predeterminado es realizar una instantánea final. Debe incluir `--final-db-snapshot-identifier` o `--skip-final-snapshot`.
El siguiente AWS CLI código elimina el clúster `sample-cluster` con una instantánea final. La operación genera un error si hay las instancias asociadas al clúster o si está habilitada la protección contra eliminación.
**Example**
Para Linux, macOS o Unix:
```
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--final-db-snapshot-identifier sample-cluster-final-snapshot
```
Para Windows:
```
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--final-db-snapshot-identifier sample-cluster-final-snapshot
```
**Example**
El siguiente AWS CLI código elimina el clúster `sample-cluster` sin tomar una instantánea final.
Para Linux, macOS o Unix:
```
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--skip-final-snapshot
```
Para Windows:
```
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--skip-final-snapshot
```
El resultado de la operación `delete-db-cluster` es el clúster que se va a eliminar.
La eliminación del clúster puede tardar varios minutos. Para monitorizar el estado del clúster, consulte [Monitorización del estado de un clúster](monitoring_docdb-cluster_status.md).
------