Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Administración de clústeres de Amazon DocumentDB
Para administrar un clúster de Amazon DocumentDB, debe disponer de una política de IAM con los permisos del plano de control de Amazon DocumentDB. Estos permisos le permiten crear, modificar y eliminar clústeres e instancias. La política `AmazonDocDBFullAccess` proporciona todos los permisos necesarios para administrar un clúster de Amazon DocumentDB.
Los siguientes temas muestran cómo realizar diversas tareas cuando se trabaja con clústeres de Amazon DocumentDB, incluida la creación, eliminación, modificación, conexión y consulta de clústeres.
**Topics**
+ [Descripción de clúster](db-clusters-understanding.md)
+ [Configuración del clúster](db-cluster-parameters.md)
+ [Configuración de almacenamiento en clústeres](db-cluster-storage-configs.md)
+ [Determinación del estado de un clúster](db-cluster-status.md)
+ [Ciclo de vida del clúster](db-cluster-life-cycle.md)
+ [Escalado de clústeres](db-cluster-manage-performance.md)
+ [Clonación de un volumen de clúster](db-cluster-cloning.md)
+ [Información general de tolerancia a errores para un clúster](db-cluster-fault-tolerance.md)
# Descripción de clúster
Amazon DocumentDB divide la capacidad informática y de almacenamiento, y descarga la replicación de datos y las copias de seguridad en el volumen del clúster. Un volumen de clúster proporciona una capa de almacenamiento duradera, fiable y altamente disponible que replica los datos de seis formas distintas entre tres zonas de disponibilidad. Las réplicas permiten una mayor disponibilidad de los datos y del escalado de lectura. Cada clúster se puede escalar verticalmente hasta 15 réplicas.
| Nombre | Description (Descripción) | Operaciones de API (Verbos) |
| --- | --- | --- |
| Clúster | Se compone de una o varias instancias y de un volumen de almacenamiento del clúster que administra los datos para esas instancias. | `create-db-cluster` `delete-db-cluster` `describe-db-clusters` `modify-db-cluster` |
| Instancia | La lectura y escritura de los datos en el volumen de almacenamiento del clúster se realiza a través de las instancias. En cualquier clúster, hay dos tipos de instancias: principal y de réplica. Un clúster siempre tiene una instancia principal y puede tener 0-15 réplicas. | `create-db-instance` `delete-db-instance` `describe-db-instances` `modify-db-instance` `describe-orderable-db-instance-options` `reboot-db-instance` |
| Volumen del clúster | Un volumen de almacenamiento de base de datos virtual que abarca tres zonas de disponibilidad, de modo que cada una de estas zonas tenga dos copias de los datos del clúster. | N/A |
| Instancia principal | Admite operaciones de lectura y escritura, y realiza todas las modificaciones de los datos en el volumen del clúster. Cada clúster tiene una instancia principal. | N/A |
| Instancia de réplica | Solo admite operaciones de lectura. Cada clúster de Amazon DocumentDB puede tener hasta 15 instancias de réplica, además de la instancia principal. Varias réplicas distribuyen la carga de trabajo real. Al colocar las réplicas en distintas zonas de disponibilidad, también puede aumentar la disponibilidad de la base de datos. | N/A |
| Punto de conexión de clúster | Un punto de conexión de un clúster de Amazon DocumentDB que se conecta a la instancia principal actual del clúster. Cada clúster de Amazon DocumentDB tiene un punto de conexión de clúster y una instancia principal. | N/A |
| Punto de conexión del lector | Un punto de conexión de un clúster de Amazon DocumentDB que se conecta a una de las réplicas disponibles de ese clúster. Cada clúster de base de datos de Amazon DocumentDB tiene un punto de conexión del lector. Si hay más de una réplica, el punto de conexión del lector dirige cada solicitud de conexión a una de las réplicas de Amazon DocumentDB. | N/A |
| Punto de conexión de instancia | Un punto de conexión de una instancia de un clúster de Amazon DocumentDB que se conecta a una instancia específica. Cada instancia de un clúster de base de datos, independientemente del tipo de instancia, tiene su propio punto de conexión de instancia único. | N/A |
# Configuración del clúster de Amazon DocumentDB
Al crear o modificar un clúster, es importante saber qué parámetros son inmutables y cuáles se pueden modificar una vez creado el clúster. La siguiente tabla muestra todas las configuraciones o parámetros que son específicos en un clúster. Tal y como se indica en la tabla; algunos de ellos se pueden modificar y otros no.
**nota**
Esta configuración no debe confundirse con los grupos de parámetros de clúster de Amazon DocumentDB y sus parámetros. Para obtener más información acerca de los grupos de parámetros de clúster, consulte [Administración de los grupos de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups.md).
| Parámetro | Modificable | Notas |
| --- | --- | --- |
| DBClusterIdentifier | Sí | Restricciones en la nomenclatura: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/db-cluster-parameters.html) |
| Engine | No | Debe ser docdb. |
| BackupRetentionPeriod | Sí | Debe estar comprendido entre [1-35] días. |
| DBClusterParameterGroupName | Sí | Restricciones en la nomenclatura: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/db-cluster-parameters.html) |
| DBSubnetGroupName | No | Una vez creado un clúster, no puede modificar la subred del clúster. |
| EngineVersion | No | El valor puede ser 5.0.0 (predeterminado), 4.0.0 o 3.6.0. |
| KmsKeyId | No | Si decide cifrar el clúster, no podrá cambiar la AWS KMS clave que utilizó para cifrarlo. |
| MasterUsername | No | Una vez creado un clúster, no puede modificar el `MasterUsername`. Restricciones en la nomenclatura: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/db-cluster-parameters.html) |
| MasterUserPassword | Sí | Restricciones: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/db-cluster-parameters.html) |
| Port | Sí | El número de puerto se aplica a todas las instancias del clúster. |
| PreferredBackupWindow | Sí | |
| PreferredMaintenanceWindow | Sí | |
| StorageEncrypted | No | Si elige cifrar el clúster, no se puede descifrar. |
| StorageType | Sí | Tipo de almacenamiento para el clúster de DB: estándar (`standard`) u optimizado para E/S (`iopt1`). Valor predeterminado: `standard` Este parámetro se puede configurar con `CreateDBCluster` y. `ModifyDBCluster` Para obtener más información, consulte [Configuraciones de almacenamiento en clústeres de Amazon DocumentDB](db-cluster-storage-configs.md). |
| Tags | Sí | |
| VpcSecurityGroupIds | No | Una vez creado un clúster, no puede modificar la VPC en la que reside el clúster. |
# Configuraciones de almacenamiento en clústeres de Amazon DocumentDB
A partir de Amazon DocumentDB 5.0, los clústeres basados en instancias admiten dos tipos de configuraciones de almacenamiento:
+ **Almacenamiento estándar de Amazon DocumentDB**: diseñado para clientes con un consumo bajo a moderado I/O . Si espera que sus I/O costes sean inferiores al 25% del total de su clúster de Amazon DocumentDB, esta opción puede ser ideal para usted. Con la configuración de almacenamiento estándar de Amazon DocumentDB, se le facturará de pay-per-request I/O forma independiente a los cargos de instancia y almacenamiento. Esto significa que su facturación puede variar de un ciclo a otro en función del uso. La configuración está diseñada para adaptarse a las I/O demandas fluctuantes de su aplicación.
+ **Almacenamiento optimizado para E/S de Amazon DocumentDB**: diseñado para clientes que priorizan la previsibilidad de los precios o que tienen aplicaciones intensivas. I/O Las I/O-optimized configuration offers improved performance, increased throughput, and reduced latency for customers with I/O intensive workloads. If you expect your I/O costs to exceed 25% of your total Amazon DocumentDB cluster costs, this option offers enhanced price performance. With the Amazon DocumentDB I/O-optimized storage configuration, you won't be charged based on I/O operaciones, que garantizan costos predecibles en cada ciclo de facturación. La configuración estabiliza los costos y, al mismo tiempo, mejora el rendimiento.
Puede cambiar los clústeres de bases de datos existentes una vez cada 30 días a Amazon DocumentDB: I/O-optimized storage. You can switch back to Amazon DocumentDB standard storage at any time. The next date to modify the storage configuration to I/O optimizados y se puede realizar un seguimiento con el `describe-db-clusters` comando mediante la página de configuración del Consola de administración de AWS clúster AWS CLI o a través de ella.
Puede crear un nuevo clúster de bases de datos que incluya la configuración optimizada para E/S de Amazon DocumentDB o convertir los clústeres de bases de datos existentes con unos pocos clics en el [Consola de administración de AWS](https://console.aws.amazon.com/docdb/), un solo cambio de parámetro en [AWS Command Line Interface (AWS CLI)](https://aws.amazon.com/cli/) o mediante. [AWS SDKs](https://aws.amazon.com/developer/tools/) No es necesario interrumpir ni reiniciar las instancias durante o después de modificar la configuración de almacenamiento.
![\[Imagen: tabla en la que se describen las diferencias entre el almacenamiento estándar y el almacenamiento optimizado de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/io-diagram-1.png)
## Creación de un clúster con optimización de E/S
------
#### [ Using the Consola de administración de AWS ]
Cómo crear o modificar un clúster optimizado para E/S mediante la Consola de administración de AWS:
1. En la consola de administración de Amazon DocumentDB, en **Clústeres**, elija **Crear** o seleccione el clúster, elija **Acciones** y, a continuación, elija **Modificar**.
1. Si va a crear un clúster nuevo, asegúrese de elegir **Clúster basado en instancias** en la sección **Tipo de clúster** (esta es la opción predeterminada).
![\[Imagen: captura de pantalla de la consola con las opciones de tipo de clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/create-cluster/cc-type.png)
1. En la sección **Configuración**, en **Configuración del almacenamiento en clúster**, elija **Amazon DocumentDB optimizado para E/S**.
![\[Imagen: captura de pantalla de la consola con las opciones de configuración de almacenamiento en clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/storage-config-1.png)
1. Complete la creación o modificación del clúster y elija **Crear clúster** o **Modificar clúster**.
Para ver el proceso completo de creación de un clúster, consulte [Crear un clúster y una instancia principal mediante Consola de administración de AWS](db-cluster-create.md#db-cluster-create-con).
Para ver el proceso completo de modificación de un clúster, consulte [Modificación de un clúster de Amazon DocumentDB](db-cluster-modify.md).
------
#### [ Using the AWS CLI ]
Cómo crear un clúster optimizado para E/S mediante la AWS CLI:
En los siguientes ejemplos, sustituya cada uno por su *user input placeholder* propia información.
Para Linux, macOS o Unix:
```
aws docdb create-db-cluster \
--db-cluster-identifier sample-cluster \
--engine docdb \
--engine-version 5.0.0 \
--storage-type iopt1 \
--deletion-protection \
--master-username username \
--master-user-password password
```
Para Windows:
```
aws docdb create-db-cluster ^
--db-cluster-identifier sample-cluster ^
--engine docdb ^
--engine-version 5.0.0 ^
--storage-type iopt1 ^
--deletion-protection ^
--master-username username ^
--master-user-password password
```
------
## Análisis de costos para determinar la configuración del almacenamiento
Con Amazon DocumentDB, tiene la flexibilidad de elegir la configuración de almacenamiento para cada clúster de bases de datos que tenga. Para asignar correctamente sus clústeres entre la opción estándar y optimizada para E/S, puede hacer un seguimiento de los costos de Amazon DocumentDB por clústeres. Para ello, puede agregar etiquetas a los clústeres existentes, habilitar el etiquetado de asignación de costos en el [panel de Administración de facturación y costos de AWS](https://aws.amazon.com/pricing/) y analizar los costos de un clúster determinado en el [AWS Cost Explorer Service](https://aws.amazon.com/aws-cost-management/aws-cost-explorer/). Para obtener información sobre el análisis de costos, consulte nuestro blog [Using cost allocation tags](https://aws.amazon.com/blogs/database/using-cost-allocation-tags-with-amazon-documentdb-with-mongodb-compatibility/).
# Determinación del estado de un clúster
Para determinar el estado de un clúster, utilice la tecla Consola de administración de AWS o AWS CLI.
------
#### [ Using the Consola de administración de AWS ]
Utilice el siguiente procedimiento para ver el estado del clúster de Amazon DocumentDB mediante el 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. En el panel de navegación, seleccione **Clusters (Clústeres)**.
1. En la columna **Cluster identifier (Identificador de clúster)**, busque el nombre del clúster que le interese. A continuación, para encontrar el estado del clúster, consulte en esa fila la columna **Status (Estado)**, tal y como se muestra a continuación.
![\[Captura de pantalla de página del clúster que muestra el estado activo de sample-cluster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cluster-status-con.png)
------
#### [ Using the AWS CLI ]
Utilice la operación `describe-db-clusters` para ver el estado del clúster de Amazon DocumentDB mediante la AWS CLI.
El siguiente código busca el estado del clúster `sample-cluster`.
Para Linux, macOS o Unix:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
Para Windows:
```
aws docdb describe-db-clusters ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
La salida de esta operación será similar a lo que se indica a continuación (formato JSON).
```
[
[
"sample-cluster",
"available"
]
]
```
------
# 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).
------
# Escalado de clústeres de Amazon DocumentDB
Amazon DocumentDB le permite escalar el almacenamiento y la computación en los clústeres en función de sus necesidades. En esta sección se describe cómo puede utilizar el escalado de almacenamiento, el escalado de instancia y el escalado de lectura para administrar el rendimiento y el escalado de los clústeres e instancias de Amazon DocumentDB.
**Topics**
+ [Escalado del almacenamiento](#db-cluster-manage-scaling-storage)
+ [Escalado de instancia](#db-cluster-manage-scaling-instance)
+ [Escalado de lectura](#db-cluster-manage-scaling-reads)
+ [Escalado de escritura](#db-cluster-manage-scaling-writes)
## Escalado del almacenamiento
El almacenamiento de Amazon DocumentDB se escala automáticamente con los datos del volumen de clúster. A medida que crecen los datos, el almacenamiento del volumen de clúster aumenta en incrementos de 10 GiB hasta un máximo de 128 TiB.
## Escalado de instancia
Puede escalar el clúster de base de datos de Amazon DocumentDB como considere necesario modificando la clase de instancia de base de datos para cada instancia de base de datos del clúster de base de datos. Amazon DocumentDB admite varias clases de instancias que están optimizadas para Amazon DocumentDB.
Para obtener más información, consulte [Modificación de una instancia de base de datos de Amazon DocumentDB](db-instance-modify.md).
## Escalado de lectura
Puede realizar el escalado de lectura de su clúster de Amazon DocumentDB creando un máximo de 15 réplicas de Amazon DocumentDB en el clúster. Cada réplica de Amazon DocumentDB devuelve los mismos datos del volumen de clúster con un retardo de réplica mínimo, normalmente menos de 100 milisegundos una vez que la instancia principal ha escrito una actualización. A medida que el tráfico de lectura aumenta, puede crear réplicas de Amazon DocumentDB adicionales y conectarlas directamente para distribuir la carga de lectura del clúster de base de datos. Las réplicas de Amazon DocumentDB no tienen que ser de la misma clase de instancia de base de datos que la instancia principal.
Para obtener más información, consulte [Agregación de una instancia de Amazon DocumentDB a un clúster](db-instance-add.md).
Para escalar las lecturas con Amazon DocumentDB, recomendamos que se conecte al clúster como conjunto de réplicas y distribuya las lecturas a las instancias de réplica mediante las funciones integradas de preferencias de lectura del controlador. Para obtener más información, consulte [Conexión a Amazon DocumentDB como conjunto de réplicas](connect-to-replica-set.md).
## Escalado de escritura
Puede escalar la capacidad de escritura en el clúster de Amazon DocumentDB aumentando el tamaño de la instancia principal del clúster. En esta sección se proporcionan dos métodos para escalar la instancia principal del clúster en función de sus necesidades. La primera opción busca minimizar el impacto de la aplicación, pero requiere completar más pasos. La segunda opción optimiza la simplicidad ya que tiene menos pasos, pero conlleva el inconveniente de tener más impacto potencial en la aplicación.
En función de la aplicación, puede elegir cuál de los enfoques siguientes es el mejor en su caso. Para obtener más información sobre los tamaños y costos de instancias disponibles, consulte la página [Precios de Amazon DocumentDB](https://aws.amazon.com/documentdb/pricing/).
1. **Optimizar para obtener una alta disponibilidad y rendimiento**: si se conecta al clúster en el [modo de conjunto de réplicas](connect-to-replica-set.md) (recomendado), puede utilizar el siguiente proceso para minimizar el impacto en la aplicación al escalar la instancia principal. Este método minimiza el impacto porque mantiene el clúster en alta disponibilidad o por encima de ella y los destinos de escalado de lectura se agregan al clúster como instancias, en lugar de actualizarse en su lugar.
1. Agregue una o varias réplicas del tipo de instancia mayor al clúster (consulte [Agregación de una instancia de Amazon DocumentDB a un clúster](db-instance-add.md)). Se recomienda que todas las réplicas sean del mismo tipo de instancia o mayor que la principal. Esto evita una reducción involuntaria en el rendimiento de escritura al conmutar por error a un tipo de instancia más pequeño. Para la mayoría de los clientes, esto significa duplicar temporalmente el número de instancias de su clúster y, a continuación, eliminar las réplicas más pequeñas después de completar el escalado.
1. Establezca el nivel de conmutación por error en todas las réplicas nuevas en prioridad cero, garantizando que una réplica del tipo de instancia más pequeño tenga la prioridad de conmutación por error más alta. Para obtener más información, consulte [Control del destino de la conmutación por error](failover.md#failover-target_control).
1. Inicie una conmutación por error manual, que promoverá una de las nuevas réplicas para que sea la instancia principal. Para obtener más información, consulte [Prueba de conmutación por error](failover.md#failover-testing).
**nota**
Esto incurrirá en \$130 segundos de tiempo de inactividad para el clúster. Por favor, planifique en consecuencia.
1. Elimine todas las réplicas de un tipo de instancia menor que la nueva instancia principal del clúster.
1. Vuelva a establecer el nivel de conmutación por error de todas las instancias en la misma prioridad (normalmente, esto significa volver a establecerlas en 1).
Como ejemplo, suponga que tiene un clúster que contiene actualmente tres instancias `r5.large` (una principal y dos réplicas) y desea escalar a un tipo de instancia `r5.xlarge`. Para ello, primero agregaría tres instancias de réplica `r5.xlarge` al clúster y, a continuación, establecería el nivel de conmutación por error de las nuevas réplicas `r5.xlarge` en cero. A continuación, iniciaría una conmutación por error manual (entendiendo que su aplicación experimentará \$130 segundos de tiempo de inactividad). Una vez completada la conmutación por error, eliminaría las tres instancias `r5.large` del clúster, dejando el clúster escalado a instancias `r5.xlarge`.
Para ayudar a optimizar los costos, las instancias de Amazon DocumentDB se facturan en incrementos de un segundo con un cargo mínimo de 10 minutos a partir de la implementación de un cambio de estado que se pueda facturar, como la creación, la modificación o la eliminación de una instancia. Para obtener más información, consulte [Optimización de costos](best_practices.md#best_practices-cost_optimization) en la documentación de prácticas recomendadas.
1. **Optimizar la simplicidad**: este enfoque optimiza la simplicidad. No expande ni contrae el clúster, pero podría reducir temporalmente la capacidad de lectura.
Es posible que al cambiar la clase de instancia de una réplica, la instancia deje de atender las solicitudes durante un breve período de tiempo, desde unos pocos segundos a menos de 30 segundos. Si se conecta al clúster en el [modo de conjunto de réplicas](connect-to-replica-set.md) (recomendado), esto reduciría su capacidad de lectura en una réplica (por ejemplo, hasta el 66 % de la capacidad en un clúster de 3 nodos o el 75 % de la capacidad en un clúster de 4 nodos, etc.) durante la operación de escalado.
1. Escale una de las instancias de réplica del clúster. Para obtener más información, consulte [Administración de clases de instancias](db-instance-classes.md).
1. Espere hasta que la instancia esté disponible (consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md)).
**nota**
Esto incurrirá en \$130 segundos de tiempo de inactividad para el clúster. Por favor, planifique en consecuencia.
1. Continúe ejecutando los pasos 1 y 2 hasta que se hayan escalado todas las instancias de réplicas, una por una.
1. Iniciar una conmutación por error manual. Esto promoverá una de las réplicas para que sea la instancia principal. Para obtener más información, consulte [Conmutación por error a Amazon DocumentDB](failover.md).
**nota**
Esto provocará un tiempo de inactividad de hasta 30 segundos para el clúster, aunque suele llevar menos tiempo. Por favor, planifique en consecuencia.
1. Escale la anterior instancia principal (que ahora es una réplica).
# Clonación de un volumen de clúster de base de datos de Amazon DocumentDB
Con la clonación de Amazon DocumentDB, puede crear un nuevo clúster que utilice el mismo volumen de clúster de Amazon DocumentDB y tenga los mismos datos que el original. El proceso está diseñado para ser rápido y rentable. El nuevo clúster con su volumen de datos asociado se conoce como *clon*. La creación de un clon es más rápido y más eficiente en el espacio que copiar físicamente los datos mediante una técnica diferente, como la restauración de una instantánea.
Amazon DocumentDB admite la creación de un clon aprovisionado de Amazon DocumentDB a partir de un clúster de Amazon DocumentDB aprovisionado. Cuando crea un clon con una configuración de implementación diferente a la de origen, el clon se crea con la versión secundaria más reciente del motor de base de datos Amazon DocumentDB.
Cuando crea clones a partir de sus clústeres de Amazon DocumentDB, los clones se crean en su cuenta, la misma cuenta que posee AWS el clúster de Amazon DocumentDB de origen.
**Topics**
+ [Información general de la clonación de Amazon DocumentDB](#db-cloning-overview)
+ [Limitaciones de la clonación de Amazon DocumentDB](#db-cloning-limitations)
+ [Cómo funciona la clonación de Amazon DocumentDB](#db-how-db-cloning-works)
+ [Creación de un clon de Amazon DocumentDB](#db-creating-db-clone)
## Información general de la clonación de Amazon DocumentDB
Amazon DocumentDB utiliza un *copy-on-write protocolo* para crear un clon. Este mecanismo utiliza un espacio adicional mínimo para crear un clon inicial. Cuando se crea el clon por primera vez, Amazon DocumentDB guarda una sola copia de los datos que utiliza el clúster de base de datos de Amazon DocumentDB de origen y el nuevo clúster de base de datos de Amazon DocumentDB (clonado). El almacenamiento adicional solo se asigna cuando el clúster de base de datos de Amazon DocumentDB de origen o el clon del clúster de base de datos de Amazon DocumentDB realizan cambios en los datos (en el volumen de almacenamiento de Amazon DocumentDB). Para obtener más información sobre el copy-on-write protocolo, consulte[Cómo funciona la clonación de Amazon DocumentDB](#db-how-db-cloning-works).
La clonación de Amazon DocumentDB es especialmente útil para configurar rápidamente entornos de prueba mediante sus datos de producción, sin riesgo de corrupción de datos. Puede utilizar clones para muchos tipos de aplicaciones de corta duración, como las siguientes:
+ Experimente con cambios potenciales (por ejemplo, cambios de esquema y cambios de grupo de parámetros) para evaluar todos los impactos.
+ Realice operaciones intensivas de carga de trabajo, como exportar datos o ejecutar consultas analíticas en el clon.
+ Cree una copia del clúster de base de datos de producción para desarrollo, pruebas u otros fines.
Puede crear más de un clon desde el mismo clúster de base de datos de Amazon DocumentDB. También puede crear varios clones desde otro clon.
Tras crear un clon de Amazon DocumentDB, puede configurar las instancias de Amazon DocumentDB de forma diferente a la del clúster de Amazon DocumentDB de origen. Por ejemplo, es posible que no necesite un clon con fines de desarrollo para cumplir con los mismos requisitos de alta disponibilidad que el clúster de base de datos Amazon DocumentDB de producción de origen. En este caso, puede configurar el clon con una única instancia de base de datos de Amazon DocumentDB en lugar de las múltiples instancias de base de datos utilizadas por el clúster de base de datos de Amazon DocumentDB.
Cuando termine de utilizar el clon para realizar pruebas, desarrollo u otros fines, puede eliminarlo.
## Limitaciones de la clonación de Amazon DocumentDB
La clonación de Amazon DocumentDB tiene las siguientes limitaciones:
+ Puede crear tantos clones como desee, hasta el número máximo de clústeres de base de datos permitido en la Región de AWS. No obstante, después de crear 15 clones, el siguiente es una copia completa. La operación de clonación actúa como una point-in-time recuperación.
+ No puede crear un clon en una AWS región diferente del clúster de Amazon DocumentDB de origen.
+ No se puede crear un clon desde un clúster de base de datos de Amazon DocumentDB que no tiene instancias de base de datos. Solo se pueden clonar clústeres de base de datos de Amazon DocumentDB que tengan al menos una instancia de base de datos.
+ Se puede crear un clon en una nube privada virtual (VPC) diferente de la del clúster de base de datos de Amazon DocumentDB. Si lo hace, las subredes del mismo VPCs deben asignarse a las mismas zonas de disponibilidad.
## Cómo funciona la clonación de Amazon DocumentDB
La clonación de Amazon DocumentDB funciona en la capa de almacenamiento de un clúster de Amazon DocumentDB. Utiliza un *copy-on-write*protocolo que es rápido y ahorra espacio en cuanto al soporte duradero subyacente que soporta el volumen de almacenamiento de Amazon DocumentDB. Puede obtener más información sobre volúmenes de clúster de Amazon DocumentDB en [Administración de clústeres de Amazon DocumentDB](db-clusters.md).
**Topics**
+ [Comprensión del protocolo copy-on-write](#db-copy-on-write-protocol)
+ [Eliminación de un volumen del clúster de origen](#db-deleting-source-cluster-volume)
### Comprensión del protocolo copy-on-write
Un clúster de Amazon DocumentDB almacena datos en páginas en el volumen de almacenamiento de Amazon DocumentDB subyacente.
Por ejemplo, en el siguiente diagrama puede encontrar un clúster de base de datos de Amazon DocumentDB (A) que tiene cuatro páginas de datos, 1, 2, 3 y 4. Imagine que un clon, B, se crea desde del clúster de base de datos de Amazon DocumentDB. Cuando se crea el clon, no se copian datos. Más bien, el clon apunta al mismo conjunto de páginas que el clúster de base de datos de Amazon DocumentDB de origen.
![\[Volumen del clúster de Amazon DocumentDB con 4 páginas para clúster de origen, A y clon, B\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-1.png)
Cuando se crea el clon, generalmente no se necesita almacenamiento adicional. El copy-on-write protocolo utiliza el mismo segmento en el medio de almacenamiento físico que el segmento de origen. Solo se requiere almacenamiento adicional si la capacidad del segmento de origen no es suficiente para todo el segmento de clones. Si ese es el caso, el segmento de origen se copia en otro dispositivo físico.
En los siguientes diagramas, puede encontrar un ejemplo del copy-on-write protocolo en acción que utiliza el mismo clúster A y su clon, B, como se muestra anteriormente. Supongamos que realiza un cambio en su clúster de base de datos de Amazon DocumentDB (A) que da lugar a un cambio en los datos almacenados en la página 1. En lugar de escribir en la página original 1, Amazon DocumentDB crea una nueva página 1 [A]. El volumen del clúster de base de datos de Amazon DocumentDB para el clúster (A) ahora apunta a la página 1 [A], 2, 3 y 4, mientras que el clon (B) sigue haciendo referencia a las páginas originales.
![\[Volumen del clúster de base de datos de origen de Amazon DocumentDB y su clon, ambos con cambios.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-2.png)
En el clon, se realiza un cambio en la página 4 del volumen de almacenamiento. En lugar de escribir en la página original 4, Amazon DocumentDB crea una nueva página 4 [B]. El clon ahora apunta a las páginas 1, 2, 3 y a la página 4 [B], mientras que el clúster (A) continúa apuntando a 1 [A], 2, 3 y 4.
![\[Volumen del clúster de base de datos de origen de Amazon DocumentDB y su clon, ambos con cambios.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-3.png)
A medida que se producen más cambios a lo largo del tiempo en el clon y el volumen del clúster de base de datos de Amazon DocumentDB de origen, necesitará cada vez más almacenamiento para capturar y almacenar los cambios.
### Eliminación de un volumen del clúster de origen
Cuando elimina un volumen del clúster de origen que tiene uno o más clones asociados, los clones no se ven afectados. Los clones siguen apuntando a las páginas que antes pertenecían al volumen del clúster de origen.
## Creación de un clon de Amazon DocumentDB
Puede crear un clon en la misma AWS cuenta que el clúster de Amazon DocumentDB de origen. Para ello, puede utilizar los procedimientos siguientes Consola de administración de AWS o AWS CLI los siguientes.
Al utilizar la clonación de Amazon DocumentDB, puede crear un clon de clúster de Amazon DocumentDB aprovisionado a partir de un clúster de Amazon DocumentDB aprovisionado.
------
#### [ Using the Consola de administración de AWS ]
El siguiente procedimiento describe cómo clonar un clúster de Amazon DocumentDB usando la Consola de administración de AWS.
Crear un clon con los Consola de administración de AWS resultados de un clúster de Amazon DocumentDB con una instancia de Amazon DocumentDB.
Estas instrucciones se aplican a los clústeres de bases de datos que pertenecen a la misma AWS cuenta que está creando el clon. El clúster de base de datos debe ser propiedad de la misma AWS cuenta, ya que Amazon DocumentDB no admite la clonación entre cuentas.
**Para crear un clon de un clúster de base de datos que sea propiedad de su AWS cuenta mediante el 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. En el panel de navegación, seleccione **Clusters (Clústeres)**.
1. Elija su clúster de base de datos de Amazon DocumentDB de la lista y para **Acciones**, elija **Crear clon**.
![\[La creación de un clon comienza seleccionando su clúster de base de datos de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cloning-create-clone-1.png)
Se abre la página Crear clon, donde puede configurar un **Identificador de clúster** y una **Clase de instancia**, y otras opciones para el clon del clúster de Amazon DocumentDB.
1. En la sección **Settings**, realice lo siguiente:
1. Para el **identificador de clúster de base de datos**, ingrese el nombre que desea dar a su clúster de base de datos de Amazon DocumentDB clonado.
1. Para la **Configuración de instancias**, seleccione una **Clase de instancia** adecuada para su clúster clonado de Amazon DocumentDB.
![\[La creación de un clon comienza seleccionando su clúster de Amazon DocumentDB y especificando el tamaño de la instancia de base de datos.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cloning-create-clone-2.png)
1. En la **Configuración de red**, elija un **Grupo de subredes** para su caso de uso y los grupos de seguridad de VPC asociados.
1. En el caso de **E ncryption-at-rest**, si el clúster de origen (el clúster que se está clonando) tiene el cifrado activado, el clúster clonado también debe tener el cifrado activado. Si se da este escenario, las opciones de **Habilitar el cifrado** aparecen atenuadas (deshabilitadas), pero con la opción **Habilitar el cifrado** seleccionada. Por el contrario, si el clúster de origen no tiene el cifrado habilitado, están disponibles las opciones de **Habilitar el cifrado** y puede elegir habilitar o deshabilitar el cifrado.
![\[Especifique la configuración de red y cifrado para el clon del clúster de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cloning-create-clone-3-nw-encryption.png)
1. Complete la nueva configuración del clon del clúster seleccionando el tipo de registros que desea exportar (opcional), introduciendo un puerto específico utilizado para conectarse al clúster y habilitando la protección contra la eliminación accidental del clúster (esta opción está habilitada de forma predeterminada).
![\[Complete la nueva configuración del clon del clúster seleccionando el tipo de registros que desea exportar (opcional), introduciendo un puerto específico utilizado para conectarse al clúster y habilitando la protección contra la eliminación accidental del clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cloning-create-clone-4-log-options-del-prot-b.png)
1. Termine de ingresar todos los ajustes para su clon de clúster de base de datos de Amazon DocumentDB. Para obtener más información sobre la configuración del clúster y de la instancia de base de datos de Amazon DocumentDB, consulte [Administración de clústeres de Amazon DocumentDB](db-clusters.md).
1. Seleccione **Crear clon** para lanzar el clon de Amazon DocumentDB del clúster de Amazon DocumentDB que haya elegido.
Cuando se crea el clon, aparece junto con los otros clústeres de base de datos de Amazon DocumentDB en la sección **Bases de datos** de la consola y muestra su estado actual. Su clon está listo para utilizar cuando su estado es **Available** (Disponible).
------
#### [ Using the AWS CLI ]
El uso de AWS CLI para clonar el clúster de Amazon DocumentDB implica un par de pasos.
El `restore-db-cluster-to-point-in-time` AWS CLI comando que utiliza da como resultado un clúster de Amazon DocumentDB vacío con 0 instancias de Amazon DocumentDB. Es decir, el comando restaura solo el clúster de base de datos de Amazon DocumentDB, no las instancias de base de datos de dicho clúster. Lo hace por separado después de que el clon está disponible. Los dos pasos en el proceso son los siguientes:
1. Cree el clon mediante el comando [restore-db-cluster-to- point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI. Los parámetros que utiliza con este comando controlan el tipo de capacidad y otros detalles del clúster vacío (clon) de base de datos de Amazon DocumentDB que se está creando.
1. Cree la instancia de Amazon DocumentDB para el clon mediante el comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI para volver a crear la instancia de Amazon DocumentDB en el clúster de Amazon DocumentDB restaurado.
Los comandos siguientes asumen que AWS CLI está configurado con su AWS región como predeterminada. Este enfoque le ahorra pasar el nombre de `--region` en cada uno de los comandos. Para obtener más información, consulte [Configuración de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html). También puede especificar la `--region` en cada uno de los comandos de la CLI que siguen.
**Topics**
**Creación del clon**
Los parámetros específicos que se pasan al comando `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)` de la CLI varían. Lo que pase dependerá del tipo de clon que desea crear.
Utilice el siguiente procedimiento para crear un clon de Amazon DocumentDB aprovisionado a partir de un clúster de Amazon DocumentDB aprovisionado.
**Creación de un clon del mismo modo de motor que el clúster de base de datos de Amazon DocumentDB de origen**
+ Utilice el comando `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)` de la CLI y especifique los valores para los siguientes parámetros:
+ `--db-cluster-identifier`: elija un nombre significativo para su clon. Se asigna un nombre al clon cuando se utiliza el comando [restore-db-cluster-to- point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI.
+ `--restore-type`: utilice `copy-on-write` para crear un clon del clúster de base de datos de origen. Sin este parámetro, `restore-db-cluster-to-point-in-time` restaura el clúster de base de datos de Amazon DocumentDB en lugar de crear un clon. El valor predeterminado para `restore-type` es `full-copy`.
+ `--source-db-cluster-identifier`: utilice el nombre del clúster de base de datos de Amazon DocumentDB de origen que desea clonar.
+ `--use-latest-restorable-time`: este valor apunta a los datos de volumen restaurables más recientes para el clon. Este parámetro es obligatorio para `restore-type copy-on-write`, pero no se puede utilizar `restore-to-time parameter` con él.
El siguiente ejemplo crea un clon del clúster de denominado `my-clone` desde un clúster denominado `my-source-cluster`.
Para Linux, macOS o Unix:
```
aws docdb restore-db-cluster-to-point-in-time \
--source-db-cluster-identifier my-source-cluster \
--db-cluster-identifier my-clone \
--restore-type copy-on-write \
--use-latest-restorable-time
```
Para Windows:
```
aws docdb restore-db-cluster-to-point-in-time ^
--source-db-cluster-identifier my-source-cluster ^
--db-cluster-identifier my-clone ^
--restore-type copy-on-write ^
--use-latest-restorable-time
```
El comando devuelve el objeto JSON que contiene detalles del clon. Compruebe que su clúster de base de datos clonado está disponible antes de intentar crear la instancia de base de datos para su clon. Para obtener más información, consulte Comprobar el estado y obtener detalles del clon a continuación:
**Comprobación del estado y obtención de detalles del clon**
Puede utilizar el siguiente comando para verificar el estado del clúster de base de datos vacío recién creado.
```
$ aws docdb describe-db-clusters --db-cluster-identifier my-clone --query '*[].[Status]' --output text
```
O bien, puede obtener el estado y los demás valores que necesita para crear la instancia de base de datos para el clon mediante la siguiente AWS CLI consulta:
Para Linux, macOS o Unix:
```
aws docdb describe-db-clusters --db-cluster-identifier my-clone \
--query '*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}'
```
Para Windows:
```
aws docdb describe-db-clusters --db-cluster-identifier my-clone ^
--query "*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}"
```
Esta consulta devuelve un resultado similar al siguiente:
```
[
{
"Status": "available",
"Engine": "docdb",
"EngineVersion": "4.0.0",
}
]
```
**Creación de la instancia de Amazon DocumentDB para su clon**
Utilice el comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI para crear la instancia de base de datos para el clon.
El parámetro `--db-instance-class` se utiliza sólo para clústeres de base de datos aprovisionados de Amazon DocumentDB.
Para Linux, macOS o Unix:
```
aws docdb create-db-instance \
--db-instance-identifier my-new-db \
--db-cluster-identifier my-clone \
--db-instance-class db.r5.4xlarge \
--engine docdb
```
Para Windows:
```
aws docdb create-db-instance ^
--db-instance-identifier my-new-db ^
--db-cluster-identifier my-clone ^
--db-instance-class db.r5.4xlarge ^
--engine docdb
```
**Parámetros para utilizar durante la clonación**
En la siguiente tabla se resumen los diversos parámetros utilizados con `restore-db-cluster-to-point-in-time` para clonar clústeres de base de datos de Amazon DocumentDB.
| Parámetro | Description (Descripción) |
| --- | --- |
| --source-db-cluster-identifier | Utilice el nombre del clúster de base de datos de Amazon DocumentDB de origen que desea clonar. |
| --db-cluster-identifier | Elija un nombre significativo para su clon. Asigne un nombre a su clon con el comando ` restore-db-cluster-to-point-in-time`. A continuación, pase este nombre al comando `create-db-instance`. |
| —restore-type | Especifique `copy-on-write` como el `--restore-type` para crear un clon del clúster de base de datos de origen en lugar de restaurar el clúster de base de datos de Amazon DocumentDB de origen. |
| --use-latest-restorable-time | Este valor apunta a los datos de volumen restaurables más recientes para el clon. |
------
# Información general de la tolerancia a errores de clúster de Amazon DocumentDB
Los clústeres de Amazon DocumentDB ofrecen tolerancia a errores por diseño. El volumen de cada clúster abarca varias zonas de disponibilidad en una sola Región de AWS, y cada zona de disponibilidad contiene una copia de los datos del volumen del clúster. Esta funcionalidad significa que el clúster puede tolerar un error de una zona de disponibilidad sin perder datos y con tan solo una interrupción breve del servicio.
Si se produce un error en la instancia principal de un clúster de base de datos, Amazon DocumentDB realiza automáticamente una conmutación por error a una nueva instancia principal de una de las dos formas siguientes:
+ Promocionando una réplica de Amazon DocumentDB existente a la nueva instancia principal elegida en función de la configuración del nivel de promoción de cada réplica y, a continuación, creando una que sustituya a la anterior principal. Una conmutación por error a la instancia de réplica suele tardar menos de 30 segundos. Las operaciones de lectura y escritura pueden sufrir breves interrupciones durante este período. Para aumentar la disponibilidad de su clúster de base de datos, es recomendable que cree al menos una o varias réplicas de Amazon DocumentDB en dos o más zonas de disponibilidad diferentes.
+ Creando una nueva instancia principal. Esto solo ocurre si no tiene una instancia de réplica en el clúster y puede tardar unos minutos en completarse.
Si el clúster tiene una o varias réplicas de Amazon DocumentDB, se promueve una réplica de Amazon DocumentDB a instancia principal durante un evento de error. Un evento de error provoca una interrupción breve durante la cual las operaciones de lectura y escritura generan errores con una excepción. Sin embargo, el servicio se suele restaurar en menos de 120 segundos y, en muchos casos, en menos de 60 segundos. Para aumentar la disponibilidad de su clúster de base de datos, es recomendable que cree al menos una o varias réplicas de Amazon DocumentDB en dos o más zonas de disponibilidad diferentes.
Puede personalizar el orden en que se promueven las réplicas de Amazon DocumentDB a instancia principal tras un error mediante la asignación de una prioridad a cada réplica. Las prioridades van desde 0 para la prioridad más alta hasta 15 para la más baja. Si la instancia principal experimenta un error, la réplica de Amazon DocumentDB que tenga la máxima prioridad pasará a ser la instancia principal. Puede modificar la prioridad de una réplica de Amazon DocumentDB en cualquier momento. Al modificar la prioridad, no se activa una conmutación por error. Puede usar la operación `modify-db-instance` con el parámetro `--promotion-tier`. Para obtener más información acerca de cómo personalizar la prioridad de conmutación por error de una instancia, consulte [Conmutación por error a Amazon DocumentDB](failover.md).
Puede haber más de una réplica de Amazon DocumentDB con la misma prioridad, lo que genera niveles de promoción. Si dos o más réplicas de Amazon DocumentDB comparten la misma prioridad, pasará a ser la instancia principal la réplica que tiene un tamaño mayor. Si dos o más réplicas de Amazon DocumentDB tienen la misma prioridad y el mismo tamaño, se promueve una réplica arbitraria del mismo nivel de promoción.
Si el clúster no contiene ninguna réplica de Amazon DocumentDB, la instancia principal se vuelve a crear durante un evento de error. Un evento de error provoca una interrupción durante la cual las operaciones de lectura y escritura generan errores con una excepción. El servicio se restaura cuando se crea la nueva instancia principal, un proceso que normalmente dura menos de 10 minutos. Promover una réplica de Amazon DocumentDB a instancia principal es mucho más rápido que crear una nueva instancia principal.