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 los clústeres elásticos 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. La política de DBFull acceso a documentos de Amazon proporciona todos los permisos necesarios para administrar un clúster elástico de Amazon DocumentDB.
En los temas siguientes se muestra cómo realizar diversas tareas al trabajar con clústeres elásticos de Amazon DocumentDB.
**Topics**
+ [Modificación de configuraciones de clústeres elásticos](#elastic-modify)
+ [Monitoreo de un clúster elástico](#elastic-monitor)
+ [Eliminación de un clúster elástico](#elastic-delete)
+ [Administración de instantáneas de los clústeres elásticos](elastic-manage-snapshots.md)
+ [Detención e inicio de un clúster elástico de Amazon DocumentDB](elastic-cluster-stop-start.md)
+ [Mantenimiento de clústeres elásticos de Amazon DocumentDB](elastic-cluster-maintenance.md)
## Modificación de configuraciones de clústeres elásticos
En esta sección, explicamos cómo modificar el clúster elástico mediante las instrucciones siguientes Consola de administración de AWS o AWS CLI siguiendo estas instrucciones.
Un uso principal de la modificación del clúster es escalar los fragmentos aumentando o disminuyendo la capacidad de and/or cómputo de los fragmentos.
------
#### [ Using the Consola de administración de AWS ]
Para modificar la configuración de un clúster elástico mediante: Consola de administración de AWS
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) de Amazon DocumentDB y ábrala.
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ú en la esquina superior izquierda del panel de navegación.
1. Elija el nombre del clúster que desea modificar en la columna **Identificador de clúster**.
1. Elija **Modificar**.
1. Edite los campos que desee cambiar y, a continuación, seleccione **Modificar clúster**.
![\[Formulario en el que se muestran las opciones de configuración, mantenimiento, autenticación y red que se pueden modificar, con el botón Modificar clúster en la esquina inferior derecha.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/cluster-shard-modify-3.png)
**nota**
Como alternativa, puede acceder al cuadro de diálogo **Modificar clúster** desde la página **Clústeres** si marca la casilla situada junto al clúster, selecciona **Acciones** y, a continuación, **Modificar**.
------
#### [ Using the AWS CLI ]
Para modificar una configuración de clúster elástico mediante el AWS CLI, utilice la `update-cluster` operación con los siguientes parámetros:
+ **--cluster-arn**: obligatorio. El identificador del ARN del clúster que desee modificar.
+ **--shard-capacity**: opcional. El número de v CPUs asignado a cada fragmento. El máximo es 64. Los valores permitidos son 2, 4, 8, 16, 32, 64.
+ **--shard-count**: opcional. La cantidad de particiones asignadas al clúster. El máximo es 32.
+ Recuento de **--shard-instance**: opcional. El número de instancias de réplica que se aplican a todos los fragmentos de este clúster. El máximo es 16.
+ **--auth-type**: opcional. El tipo de autenticación utilizado para determinar dónde buscar la contraseña que se usa para acceder al clúster elástico. Los tipos válidos son `PLAIN_TEXT` o `SECRET_ARN`.
+ **--admin-user-password**: opcional. La contraseña asociada al usuario administrador.
+ **--vpc-security-group-ids**: opcional. Configure una lista de grupos de seguridad de Amazon EC2 y la nube privada virtual (VPC) de Amazon para asociarlos a este clúster.
+ **--preferred-maintenance-window**: opcional. El intervalo de tiempo semanal durante el cual puede llevarse a cabo el mantenimiento del sistema, en tiempo universal coordinado (UTC).
El formato es: `ddd:hh24:mi-ddd:hh24:mi`. Días válidos: lunes, martes, miércoles, jueves, viernes, sábado, domingo
El valor predeterminado es un periodo de 30 minutos seleccionado al azar de un bloque de 8 horas de tiempo para cada región de Amazon Web Services, que tiene lugar un día de la semana de forma aleatoria.
El plazo mínimo es 30 minutos.
+ **--subnet-ids**: opcional. Configure los identificadores de subred de la red.
Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información.
Para Linux, macOS o Unix:
```
aws docdb-elastic update-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
--shard-capacity 8 \
--shard-count 4 \
--shard-instance-count 3 \
--admin-user-password testPassword \
--vpc-security-group-ids ec-65f40350 \
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
Para Windows:
```
aws docdb-elastic update-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
--shard-capacity 8 ^
--shard-count 4 ^
--shard-instance-count 3 ^
--admin-user-password testPassword ^
--vpc-security-group-ids ec-65f40350 ^
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
------
Para supervisar el estado del clúster elástico después de la modificación, consulte Supervisión de un clúster elástico.
## Monitoreo de un clúster elástico
En esta sección, explicamos cómo monitorizar el clúster elástico, utilizando las instrucciones siguientes Consola de administración de AWS o AWS CLI siguiendo estas instrucciones.
------
#### [ Using the Consola de administración de AWS ]
Para monitorear la configuración de un clúster elástico mediante Consola de administración de AWS:
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) de Amazon DocumentDB y ábrala.
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ú en la esquina superior izquierda del panel de navegación.
1. Elija el nombre del clúster que desea monitorear en la columna del **Identificador del clúster**.
1. Elija la pestaña **Monitorización**.
![\[La información resumida del clúster elástico se muestra en la pestaña Supervisión.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/cluster-shard-monitor-2.png)
Se muestran varios gráficos de Amazon CloudWatch para las siguientes categorías de seguimiento:
+ Uso de los recursos
+ Rendimiento
+ Operaciones
+ Sistema
También puede acceder a Amazon CloudWatch a través de Consola de administración de AWS para configurar su propio entorno de monitoreo para sus clústeres elásticos.
------
#### [ Using the AWS CLI ]
Para monitorear una configuración de clúster elástico específica mediante el AWS CLI, utilice la `get-cluster` operación con los siguientes parámetros:
+ **--cluster-arn**: obligatorio. Identificador del ARN del clúster para el que desea obtener información detallada.
Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información.
Para Linux, macOS o Unix:
```
aws docdb-elastic get-cluster \
--cluster-arn arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9
```
Para Windows:
```
aws docdb-elastic get-cluster ^
--cluster-arn arn:aws:docdb:-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9
```
La salida de esta operación será similar a lo que se indica a continuación:
```
"cluster": {
...
"clusterArn": "arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9",
"clusterEndpoint": "stretch-11-477568257630.us-east-1.docdb-elastic.amazonaws.com",
"readerEndpoint": "stretch-11-477568257630-ro.us-east-1.docdb-elastic.amazonaws.com",
"clusterName": "stretch-11",
"shardCapacity": 2,
"shardCount": 3,
"shardInstanceCount: 5,
"status": "ACTIVE",
...
}
```
Para obtener más información, consulte `DescribeClusterSnapshot` en la Referencia de la API para administración de recursos de Amazon DocumentDB.
Para ver los detalles de todos los clústeres elásticos que utilizan el AWS CLI, utilice la `list-clusters` operación con los siguientes parámetros:
+ **--next-token**: opcional. Si el número de elementos de salida (`--max-results`) es inferior al número total de elementos devueltos por las llamadas básicas a la API, la salida incluirá un `NextToken` que podrá pasar a un comando posterior para recuperar el siguiente conjunto de elementos.
+ **--max-results**: opcional. El número total de elementos que se devuelven en la salida del comando. Si el número de registros es superior al valor `max-results` especificado, se incluye en la respuesta un token de paginación (`next-token`) que se conoce como marcador, de modo que se pueda recuperar el resto de resultados.
+ Predeterminado: 100
+ Mínimo = 20, máximo = 100
Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información.
Para Linux, macOS o Unix:
```
aws docdb-elastic list-clusters \
--next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== \
--max-results 2
```
Para Windows:
```
aws docdb-elastic list-clusters ^
--next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== ^
--max-results 2
```
La salida de esta operación será similar a lo que se indica a continuación:
```
{
"Clusters": [
{
"ClusterIdentifier":"mycluster-1",
"ClusterArn":"arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster"
"Status":"available",
"ClusterEndpoint":"sample-cluster.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
}
{
"ClusterIdentifier":"mycluster-2",
"ClusterArn":"arn:aws:docdb:us-west-2:987654321098:sharded-cluster:sample-cluster"
"Status":"available",
"ClusterEndpoint":"sample-cluster2.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
}
]
}
```
------
## Eliminación de un clúster elástico
En esta sección, explicamos cómo eliminar un clúster elástico, utilizando las instrucciones siguientes Consola de administración de AWS o AWS CLI siguiendo estas instrucciones.
------
#### [ Using the Consola de administración de AWS ]
Para eliminar una configuración de clúster elástico mediante la Consola de administración de AWS:
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) de Amazon DocumentDB y ábrala.
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ú en la esquina superior izquierda del panel de navegación.
1. En la tabla de lista de clúster, active la casilla de verificación situada a la izquierda del nombre del clúster que desea eliminar y, a continuación, elija **Acciones**. En el menú desplegable, seleccione **Eliminar**.
1. ¿En el **clúster elástico Eliminar “cluster-name”?** cuadro de diálogo, elija **Eliminar**.
![\[Cuadro de diálogo Eliminar, con el botón Eliminar en la esquina inferior derecha.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/cluster-delete-dialog.png)
La eliminación del clúster puede tardar varios minutos. Para supervisar el estado del clúster, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
------
#### [ Using the AWS CLI ]
Para eliminar un clúster elástico mediante el AWS CLI, utilice la `delete-cluster` operación con los siguientes parámetros:
+ **--cluster-arn**: obligatorio. El identificador del ARN del clúster que desee eliminar.
+ **--no-skip-final-backup**: opcional. Si desea una instantánea final, debe incluir este parámetro con un nombre para la instantánea final. Debe incluir `--final-backup-identifier` o `--skip-final-backup`.
+ **--skip-final-backup**: opcional. Use este parámetro solo si no desea realizar un respaldo final antes de eliminar el clúster. El comportamiento predeterminado es realizar una instantánea final.
Los siguientes ejemplos de AWS CLI código eliminan un clúster con un ARN de arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster con una copia de seguridad final.
En el siguiente ejemplo, sustituya cada uno por su propia información. *user input placeholder*
Para Linux, macOS o Unix:
```
aws docdb-elastic delete-cluster \
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
--no-skip-final-backup \
--final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
Para Windows:
```
aws docdb-elastic delete-cluster ^
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
--no-skip-final-backup ^
--final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
Los siguientes ejemplos de AWS CLI código eliminan un clúster con un ARN de arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster sin realizar una copia de seguridad final.
Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información.
Para Linux, macOS o Unix:
```
aws docdb-elastic delete-cluster \
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
--skip-final-backup \
```
Para Windows:
```
aws docdb-elastic delete-cluster ^
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
--skip-final-backup ^
```
El resultado de la operación `delete-cluster` es el clúster que se va a eliminar.
La eliminación del clúster puede tardar varios minutos. Para supervisar el estado del clúster, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
------
# Administración de instantáneas de los clústeres elásticos
Se pueden realizar instantáneas manuales después de crear un clúster elástico. Las copias de seguridad automatizadas se crean en el momento en que se crea la instantánea del clúster elástico.
**nota**
Su clúster elástico debe estar en estado `Available` para que se tome una instantánea manual.
En esta sección se explica cómo puede crear, ver, restaurar y eliminar instantáneas de clústeres elásticos.
En los temas siguientes se muestra cómo realizar diversas tareas al trabajar con instantáneas de clústeres elásticos de Amazon DocumentDB.
**Topics**
+ [Creación de una instantánea manual del clúster](#elastic-create-snapshot)
+ [Visualización de una instantánea de un clúster elástico](#elastic-view-snapshot)
+ [Restauración de un clúster desde una instantánea](#elastic-restore-snapshot)
+ [Copia de una instantánea de un clúster elástico](#elastic-copy-snapshot)
+ [Eliminar una instantánea de un clúster elástico](#elastic-delete-snapshot)
+ [Administración de una copia de seguridad automática de una instantánea de un clúster elástico](#elastic-auto-snapshot)
## Creación de una instantánea manual del clúster
En esta sección, explicamos cómo crear una instantánea manual de un clúster elástico, utilizando las instrucciones siguientes o siguiendo estas instrucciones. Consola de administración de AWS AWS CLI
------
#### [ Using the Consola de administración de AWS ]
Para crear una instantánea manual de un clúster elástico mediante la Consola de administración de AWS:
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) de Amazon DocumentDB y ábrala.
1. En el panel de navegación, elija **Snapshots (Instantáneas)**.
**sugerencia**
Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú en la esquina superior izquierda del panel de navegación.
1. En la página **Snapshots (Instantáneas)**, elija **Create (Crear)**.
1. En la página **Crear una instantánea de clúster**, en el campo **Identificador del clúster**, elija su clúster elástico en la lista desplegable.
En el campo **Identificador de instantáneas**, introduce un identificador único para tu clúster elástico.
Seleccione **Crear**.
![\[Diagrama: clúster elástico: crea una instantánea\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/elastic-create-snapshot.png)
**nota**
Como alternativa, puede acceder al cuadro de diálogo **Crear una instantánea del clúster** desde la página **Clústeres**, marcando la casilla situada junto al clúster, seleccionando **Acciones** y, a continuación, **Realizar instantánea**.
La instantánea de su clúster elástico se está aprovisionando. Esto puede tardar unos minutos en terminar. Puede verla y restaurarla desde su instantánea cuando el estado se muestre como `Available` en la lista de **instantáneas**.
------
#### [ Using the AWS CLI ]
Para crear una instantánea manual de un clúster elástico mediante el AWS CLI, utilice la `create-cluster-snapshot` operación con los siguientes parámetros:
+ **--snapshot-name**: obligatorio. El nombre de la instantánea para crear un nuevo clúster.
+ **--cluster-arn**: obligatorio. El identificador del ARN del clúster del que desea crear una instantánea.
Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información.
Para Linux, macOS o Unix:
```
aws docdb-elastic create-cluster-snapshot \
--snapshot-name sample-snapshot-1 \
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
Para Windows:
```
aws docdb-elastic create-cluster-snapshot ^
--snapshot-name sample-snapshot-1 ^
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
------
## Visualización de una instantánea de un clúster elástico
En esta sección, explicamos cómo ver la información de las instantáneas del clúster elástico, utilizando las instrucciones siguientes Consola de administración de AWS o AWS CLI siguiendo estas instrucciones.
------
#### [ Using the Consola de administración de AWS ]
Para ver información sobre una instantánea específica de un clúster elástico mediante Consola de administración de AWS:
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) de Amazon DocumentDB y ábrala.
1. En el panel de navegación, elija **Snapshots (Instantáneas)**.
**sugerencia**
Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú en la esquina superior izquierda del panel de navegación.
1. En la página de **instantáneas**, elija su instantánea de la lista haciendo clic en el nombre en la columna de **identificación de instantáneas**.
1. Consulta la información de la instantánea en **Detalles**.
![\[Diagrama: instantánea de Elastic Cluster View\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/elastic-snapshot-view.png)
------
#### [ Using the AWS CLI ]
Para ver información sobre una instantánea de un clúster elástico específica mediante el AWS CLI, utilice la `get-cluster-snapshot` operación con los siguientes parámetros:
+ **--snapshot-arn**: obligatorio. El identificador del ARN de la instantánea de la que desea obtener información.
Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información.
Para Linux, macOS o Unix:
```
aws docdb-elastic get-cluster-snapshot \
--snapshot-arn sampleResourceName
```
Para Windows:
```
aws docdb-elastic get-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
Para ver información sobre una instantánea de un clúster elástico específica mediante el AWS CLI, utilice la `get-cluster-snapshot` operación con los siguientes parámetros:
+ **--snapshot-arn**: obligatorio. El identificador del ARN de la instantánea de la que desea obtener información.
Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información.
Para Linux, macOS o Unix:
```
aws docdb-elastic get-cluster-snapshot \
--snapshot-arn sampleResourceName
```
Para Windows:
```
aws docdb-elastic get-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
Para ver información sobre todas las instantáneas del clúster elástico que utilizan el AWS CLI, utilice la `list-cluster-snapshots` operación con los siguientes parámetros:
+ **--snapshot-type**: opcional. El tipo de instantáneas del clúster que se van a devolver. Puede especificar uno de los siguientes valores:
+ `automated`- Devuelva todas las instantáneas del clúster que Amazon DocumentDB haya creado automáticamente para su AWS cuenta.
+ `manual`- Devuelva todas las instantáneas del clúster que haya creado manualmente para su cuenta. AWS
+ `shared`- Devuelve todas las instantáneas de clústeres manuales que se hayan compartido en tu AWS cuenta.
+ `public`: se devuelven todas las instantáneas del clúster que se han marcado como públicas.
+ **--next-token**: opcional. Un token de paginación opcional proporcionado por una solicitud anterior. Si se especifica este parámetro, la respuesta solo incluye registros más allá del token, hasta el valor especificado por `max-results`.
+ **--max-results**: opcional. El número máximo de registros que se debe incluir en la respuesta. Si el número de registros es superior al valor `max-results` especificado, se incluye en la respuesta un token de paginación (`next-token`) que se conoce como marcador, de modo que se pueda recuperar el resto de resultados.
+ Predeterminado: 100
+ Mínimo = 20, máximo = 100
Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información.
Para Linux, macOS o Unix:
```
aws docdb-elastic list-cluster-snapshots \
--snapshot-type value \
--next-token value \
--max-results 50
```
Para Windows:
```
aws docdb-elastic list-cluster-snapshots ^
--snapshot-type value ^
--next-token value ^
--max-results 50
```
------
## Restauración de un clúster desde una instantánea
En esta sección, explicamos cómo restaurar un clúster elástico a partir de una instantánea, utilizando las instrucciones siguientes Consola de administración de AWS o AWS CLI siguiendo estas instrucciones.
------
#### [ Using the Consola de administración de AWS ]
Para restaurar un clúster elástico a partir de una instantánea utilizando la Consola de administración de AWS:
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) de Amazon DocumentDB y ábrala.
1. En el panel de navegación, elija **Snapshots (Instantáneas)**.
**sugerencia**
Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú en la esquina superior izquierda del panel de navegación.
1. Seleccione el botón situado a la izquierda de la instantánea que desea utilizar para restaurar un clúster, en la columna **Identificador de instantánea**.
1. En **Acciones**, elija **Restaurar**.
![\[Diagrama: restauración de clústeres elásticos a partir de una instantánea\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/elastic-restore-snapshot.png)
1. En la página **Restaurar la instantánea**, introduzca un nombre para el nuevo clúster en el campo **identificador del clúster**.
**nota**
Para cualquier restauración manual de instantáneas, debe crear un clúster nuevo.
1. En el campo **Nube privada virtual (VPC)**, elija una VPC de la lista desplegable.
1. Para **las subredes** y los **grupos de seguridad de VPC**, puede usar los valores predeterminados o seleccionar tres subredes de su elección y hasta tres grupos de seguridad de VPC (uno como mínimo).
1. Si está satisfecho con la configuración del clúster, elija **Restore cluster (Restaurar clúster)** y espere mientras el clúster se restaura.
------
#### [ Using the AWS CLI ]
Para restaurar un clúster elástico a partir de una instantánea mediante la AWS CLI, utilice la `restore-cluster-from-snapshot` operación con los siguientes parámetros:
+ **--cluster-name**: obligatorio. El nombre actual del clúster elástico tal como se ingresó durante la creación o se modificó por última vez.
+ **--snapshot-arn**: obligatorio. El identificador del ARN de la instantánea que se utiliza para restaurar el clúster.
+ **--vpc-security-group-ids**: opcional. Uno o más grupos de seguridad de Amazon EC2 y la nube privada virtual (VPC) de Amazon para asociar al clúster.
+ **--kms-key-id**: opcional. Configure el identificador de la clave de KMS de un clúster cifrado.
El identificador de clave de KMS es el nombre de recurso de Amazon (ARN) de la clave de AWS KMS cifrado. Si está creando un clúster con la misma cuenta de Amazon Web Services a la que pertenece la clave de cifrado de KMS utilizada para cifrar el clúster nuevo, puede utilizar el alias de la clave de KMS en lugar del ARN para la clave de cifrado de KMS.
Si no se especifica una clave de cifrado KmsKeyId y el `StorageEncrypted` parámetro es verdadero, Amazon DocumentDB utiliza la clave de cifrado predeterminada.
+ **--subnet-ids**: opcional. ID de subred de red.
En el siguiente ejemplo, sustituya cada una *user input placeholder* por su propia información.
Para Linux, macOS o Unix:
```
aws docdb-elastic restore-cluster-from-snapshot \
--cluster-name elastic-sample-cluster \
--snapshot-arn sampleResourceName \
--vpc-security-group-ids value ec-65f40350 \
--kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
Para Windows:
```
aws docdb-elastic restore-cluster-from-snapshot ^
--cluster-name elastic-sample-cluster ^
--snapshot-arn sampleResourceName ^
--vpc-security-group-ids value ec-65f40350 ^
--kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
------
## Copia de una instantánea de un clúster elástico
En Amazon DocumentDB, puede copiar instantáneas manuales y automáticas de un clúster elástico en la misma región y dentro de la misma cuenta. En esta sección, explicamos cómo copiar una instantánea de un clúster elástico mediante la tecla Consola de administración de AWS o AWS CLI.
------
#### [ Using the Consola de administración de AWS ]
Para copiar una instantánea de un clúster elástico mediante Consola de administración de AWS:
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) de Amazon DocumentDB y ábrala.
1. En el panel de navegación, elija **Snapshots (Instantáneas)**.
**sugerencia**
Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú en la esquina superior izquierda del panel de navegación.
1. Seleccione el botón situado a la izquierda de la instantánea que desea copiar en la columna **Identificador de la instantánea**.
1. Seleccione **Acciones** y, a continuación, **Copiar**.
![\[Diagrama: copia de instantánea de clúster elástico\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/ec-copy-snapshot.png)
1. En **Identificador de la nueva instantánea**, escriba un nombre para la instantánea nueva.
1. En **Copiar etiquetas**, active la casilla si desea copiar todas las etiquetas de la instantánea del clúster elástico de origen a la instantánea del clúster elástico de destino.
1. Para el **cifrado**, elija una clave de AWS KMS predeterminada o una clave de KMS de su elección. La segunda opción le permite seleccionar una clave de KMS existente que ya haya creado o crear una nueva.
1. Seleccione **Copiar instantánea** cuando haya terminado.
------
#### [ Using the AWS CLI ]
Para copiar una instantánea de un clúster elástico mediante el AWS CLI, utilice la `copy-cluster-snapshot` operación con los siguientes parámetros:
+ **‐‐source-db-cluster-snapshot-identifier**: obligatorio. El identificador de la instantánea del clúster elástico existente que se está copiando. Debe existir la instantánea del clúster elástico y tener el estado Disponible. Este parámetro no distingue entre mayúsculas y minúsculas.
+ **‐‐target-db-cluster-snapshot-identifier**: obligatorio. El identificador de la nueva instantánea del clúster elástico que se va a crear a partir de la instantánea del clúster existente. Este parámetro no distingue entre mayúsculas y minúsculas.
Restricciones relativas a la nomenclatura de instantáneas de destino:
+ No se puede coincidir con el nombre de una instantánea existente.
+ 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.
Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información.
Para Linux, macOS o Unix:
```
aws docdb-elastic copy-cluster-snapshot \
‐‐source-cluster-snapshot-arn \
‐‐target-cluster-snapshot-name my-target-copied-snapshot
```
Para Windows:
```
aws docdb-elastic copy-cluster-snapshot ^
‐‐source-cluster-snapshot-arn ^
‐‐target-cluster-snapshot-name my-target-copied-snapshot
```
------
## Eliminar una instantánea de un clúster elástico
En esta sección, explicamos cómo eliminar una instantánea de un clúster elástico mediante la tecla Consola de administración de AWS o AWS CLI.
------
#### [ Using the Consola de administración de AWS ]
Para restaurar un clúster elástico a partir de una instantánea utilizando la Consola de administración de AWS:
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) de Amazon DocumentDB y ábrala.
1. En el panel de navegación, elija **Snapshots (Instantáneas)**.
**sugerencia**
Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú en la esquina superior izquierda del panel de navegación.
1. Seleccione el botón situado a la izquierda de la instantánea que desea utilizar para restaurar un clúster, en la columna **Identificador de instantánea**.
1. Elija **Acciones** y, a continuación, elija **Eliminar**.
![\[Diagrama: el clúster elástico elimina una instantánea\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/elastic-delete-snapshot.png)
1. **En el cuadro de diálogo **Eliminar la instantánea “snapshot-name”**, seleccione Eliminar.**
------
#### [ Using the AWS CLI ]
Para eliminar una instantánea de un clúster elástico mediante el AWS CLI, utilice la `delete-cluster-snapshot` operación con los siguientes parámetros:
+ **--snapshot-arn**: obligatorio. El identificador del ARN de la instantánea que se utiliza para restaurar el clúster.
En el siguiente ejemplo, sustituya cada *user input placeholder* una por su propia información.
Para Linux, macOS o Unix:
```
aws docdb-elastic delete-cluster-snapshot \
--snapshot-arn sampleResourceName
```
Para Windows:
```
aws docdb-elastic delete-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
------
## Administración de una copia de seguridad automática de una instantánea de un clúster elástico
Amazon DocumentDB toma instantáneas diarias de los clústeres elásticos. Puede especificar la ventana de copia de seguridad preferida y el periodo de retención de la copia de seguridad en una configuración de instantáneas de clúster elástico nueva o existente. En esta sección, explicamos cómo configurar los parámetros de copia de seguridad automática en una instantánea de un clúster elástico, utilizando la tecla Consola de administración de AWS o AWS CLI.
------
#### [ Using the Consola de administración de AWS ]
Para configurar una copia de seguridad automática para una nueva instantánea de un clúster elástico mediante Consola de administración de AWS:
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) de Amazon DocumentDB y ábrala.
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ú en la esquina superior izquierda del panel de navegación.
1. Seleccione el botón situado a la izquierda del clúster para el que desea cambiar la configuración de copia de seguridad en la columna **Identificador del clúster**.
1. Elija **Acciones** y, a continuación, **Modificar**.
1. En la sección **Copia de seguridad**, edite los campos de acuerdo con los requisitos de 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/ec-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. Elija **Seleccionar periodo** si desea configurar la hora y la duración de la creación de las copias de seguridad.
**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.
**Duración**: en la lista, elija el número de horas que se deben asignar para crear las copias de seguridad automáticas.
1. Seleccione **Sin preferencia** si desea que Amazon DocumentDB elija la hora y la duración de la creación de las copias de seguridad.
1. Elija **Modificar clúster** cuando haya terminado.
------
#### [ Using the AWS CLI ]
Para configurar una copia de seguridad automática para una nueva instantánea de un clúster elástico mediante el AWS CLI, utilice la `create-cluster-snapshot` operación con los siguientes parámetros:
+ **--preferred-backup-window**: opcional. El intervalo de tiempo diario preferido durante el que se crean las copias de seguridad automatizadas. El valor predeterminado es un período de 30 minutos seleccionado al azar de un bloque de tiempo de 8 horas para cada uno Región de AWS.
Restricciones:
+ Tiene que tener el formato `hh24:mi-hh24:mi`.
+ Debe indicarse en Tiempo universal coordinado (UTC).
+ No debe entrar en conflicto con la ventana de mantenimiento preferida.
+ Debe durar al menos 30 minutos.
+ **--backup-retention-period**: opcional. El número de días durante los que se retienen las copias de seguridad automatizadas. El valor predeterminado es 1.
Restricciones:
+ Debe especificar un valor mínimo de 1.
+ El intervalo va de 1 a 35.
**nota**
Las copias de seguridad automatizadas solo se hacen cuando el clúster tenga el estado “activo”.
**nota**
También puede modificar los parámetros `preferred-backup-window` y `backup-retention-period` de un clúster elástico existente mediante el comando `aws docdb-elastic update-cluster`.
Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información.
El siguiente `create-cluster` ejemplo crea el clúster elástico de Amazon DocumentDB *sample-cluster* con el período de retención para las copias de seguridad automáticas de *7* días y una ventana de copia de seguridad preferida de. *18:00-18:30 UTC*
Para Linux, macOS o Unix:
```
aws docdb-elastic create-cluster \
--cluster-name sample-cluster \
--shard-capacity 2 \
--shard-count 2 \
--admin-user-name SampleAdmin \
--auth-type PLAIN_TEXT \
--admin-user-password SamplePass123! \
--preferred-backup-window 18:00-18:30 \
--backup-retention-period 7
```
Para Windows:
```
aws docdb-elastic create-cluster ^
--cluster-name sample-cluster ^
--shard-capacity 2 ^
--shard-count 2 ^
--admin-user-name SampleAdmin ^
--auth-type PLAIN_TEXT ^
--admin-user-password SamplePass123! ^
--preferred-backup-window 18:00-18:30 ^
--backup-retention-period 7
```
------
# Detención e inicio de un clúster elástico de Amazon DocumentDB
La detención e inicio de los clústeres elásticos de Amazon DocumentDB puede ayudarlo a administrar los costos de entornos de desarrollo y pruebas. En lugar de crear y eliminar clústeres elásticos cada vez que utilice Amazon DocumentDB, puede detener temporalmente el clúster cuando ya no es necesario. A continuación, puede iniciarlo de nuevo cuando reanude sus pruebas.
**Topics**
+ [Información general de detención e inicio de un clúster elástico](#elastic-cluster-stop-start-overview)
+ [Operaciones que puede llevar a cabo en un clúster elástico detenido](#elastic-cluster-stopped-operations)
## Información general de detención e inicio de un clúster elástico
Durante los periodos en los que no necesite un clúster elástico de Amazon DocumentDB, puede detener el clúster. 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 elásticos usados para desarrollo, pruebas o actividades similares que no requieren disponibilidad continua. Puede detener e iniciar un clúster elástico con Consola de administración de AWS o AWS CLI con una sola acción.
Aunque el clúster elástico 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. Después de siete días, Amazon DocumentDB inicia automáticamente el clúster elástico para que no pierda las actualizaciones de mantenimiento necesarias. Cuando el clúster se inicie después de siete días, se le comenzará a cobrar por el uso del clúster elástico de nuevo. Cuando el clúster se detenga, no podrá consultar el volumen de almacenamiento, ya que la consulta requiere que el clúster esté disponible.
Cuando se detiene un clúster elástico de Amazon DocumentDB, no se pueden modificar en modo alguno. Esto incluye la eliminación del clúster.
------
#### [ Using the Consola de administración de AWS ]
El procedimiento siguiente le muestra cómo detener un clúster elástico en un estado disponible o iniciar un clúster elástico detenido.
**Detención o inicio de un clúster elástico 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.
![\[Un clúster de la lista de clústeres, con la casilla de verificación seleccionada a la izquierda del nombre del clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/cluster-list-ec.png)
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**.
![\[La lista desplegable Acciones con la opción Detener seleccionada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/ec-stop.png)
1. En el cuadro de diálogo de confirmación, seleccione **Detener clúster** parar confirmar que desea detener el clúster elástico o elija **Cancelar** para mantener el clúster en ejecución.
![\[Diálogo de Confirmación para detener un clúster, con los botones Cancelar y Detener el clúster en la parte inferior.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/ec-stop-confirm.png)
+ Si desea iniciar el clúster y este se detiene, seleccione **Start** (Iniciar).
![\[La lista desplegable Acciones con la opción Iniciar seleccionada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/ec-start.png)
1. Supervise el estado del clúster elástico. Si ha iniciado el clúster, podrá volver a utilizarlo cuando esté *Disponible*. Para obtener más información, consulte [Determinación del estado de un clúster](db-cluster-status.md).
![\[La columna Estado de la tabla de clústeres, en la que se muestran los estados disponibles e iniciales.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/ec-starting-status.png)
------
#### [ Using the AWS CLI ]
En los ejemplos de código siguientes se muestra cómo detener un clúster elástico en un estado activo o disponible o iniciar un clúster elástico detenido.
Para detener un clúster elástico mediante el AWS CLI, utilice la operación. `stop-cluster` Para iniciar un clúster detenido, utilice la operación `start-cluster`. En ambas operaciones se utiliza el parámetro `--cluster-arn`.
**Parámetro**
+ **--cluster-arn**: obligatorio. El identificador ARN del clúster elástico que desee detener o iniciar.
**Example — Para detener un clúster elástico mediante el AWS CLI**
Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información.
El siguiente código detiene el clúster elástico con un ARN de `arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2`.
El estado del clúster elástico debe ser activo o disponible.
Para Linux, macOS o Unix:
```
aws docdb-elastic stop-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
Para Windows:
```
aws docdb-elastic stop-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
**Example — Para iniciar un clúster elástico mediante el AWS CLI**
Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información.
El siguiente código inicia el clúster elástico con un ARN de `arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2`.
El clúster elástico debe estar detenido actualmente.
Para Linux, macOS o Unix:
```
aws docdb-elastic start-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
Para Windows:
```
aws docdb-elastic start-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
------
## Operaciones que puede llevar a cabo en un clúster elástico detenido
No se puede modificar la configuración de un clúster elástico de Amazon DocumentDB mientras el clúster esté detenido. Debe iniciar el clúster antes de realizar cualquier tarea administrativa de ese tipo.
Amazon DocumentDB aplica cualquier mantenimiento programado a su clúster elástico detenido solo después de que se vuelva a iniciar. Después de siete días, Amazon DocumentDB inicia automáticamente un clúster elástico detenido para que no se quede demasiado rezagado en su estado de mantenimiento. Cuando el clúster elástico se reinicie, se le comenzará a cobrar por las particiones en el clúster de nuevo.
Cuando un clúster elástico está detenido, Amazon DocumentDB no hace copias de seguridad automatizadas ni amplía el periodo de retención de copia de seguridad.
# Mantenimiento de clústeres elásticos de Amazon DocumentDB
**Topics**
+ [Visualización de las acciones de mantenimiento pendientes del clúster elástico](#view-elastic-cluster-maintenance)
+ [Actualizaciones del motor de clústeres elásticos](#elastic-cluster-engine-updates)
+ [Actualizaciones del sistema operativo para los clústeres elásticos](#elastic-cluster-os-updates)
Amazon DocumentDB realiza tareas de mantenimiento periódicas en los recursos del clúster elástico de Amazon DocumentDB. En la mayoría de los casos, el mantenimiento incluye actualizaciones del motor de base de datos (mantenimiento de clústeres elásticos) o del sistema operativo subyacente del clúster elástico (actualizaciones del sistema operativo). Las actualizaciones del motor de base de datos son parches necesarios e incluyen correcciones de seguridad, correcciones de errores y mejoras en el motor de base de datos. Si bien la mayoría de los parches del sistema operativo son opcionales, si no los aplica durante un tiempo, es posible que el parche sea necesario y se aplique automáticamente para mantener su postura de seguridad. Por lo tanto, le recomendamos que aplique las actualizaciones del sistema operativo a sus clústeres elásticos de Amazon DocumentDB tan pronto como estén disponibles.
Los parches del motor de base de datos requieren que desconecte los clústeres elásticos de Amazon DocumentDB durante un breve plazo de tiempo. Una vez disponibles, estos parches se programan automáticamente para que se apliquen durante un próximo período de mantenimiento programado del clúster elástico de Amazon DocumentDB.
Los clústeres elásticos tienen sus propios períodos de mantenimiento respectivos. Las modificaciones de los clústeres elásticos que haya decidido no aplicar inmediatamente también se aplican durante el período de mantenimiento. De forma predeterminada, cuando crea un clúster elástico, Amazon DocumentDB asigna un período de mantenimiento para el clúster elástico. Puede elegir el período de mantenimiento cuando crea el clúster elástico. También puede modificar los periodos de mantenimiento en cualquier momento para ajustarlos a las prácticas o las programaciones de su empresa. Por lo general, se recomienda elegir periodos de mantenimiento que minimicen la repercusión de las tareas de mantenimiento en la aplicación (por ejemplo, por las noches o durante los fines de semana).
## Visualización de las acciones de mantenimiento pendientes del clúster elástico
Para ver si hay disponible una actualización de mantenimiento para un clúster elástico, use la AWS CLI.
Si hay disponible una actualización, puede realizar una de las acciones siguientes:
+ Aplace una acción de mantenimiento que esté actualmente programada para el próximo periodo de mantenimiento (solo para los parches del sistema operativo).
+ Aplicar inmediatamente las operaciones de mantenimiento.
+ Programar las operaciones de mantenimiento para que se inicien durante el siguiente periodo de mantenimiento.
+ Programe las acciones de mantenimiento para que se inicien durante el período de aplicación seleccionado.
El periodo de mantenimiento determina el momento en que comienzan las operaciones pendientes, pero no limita su tiempo total de ejecución.
Utilice la siguiente AWS CLI operación para determinar qué acciones de mantenimiento están pendientes. Enumere todas las acciones de mantenimiento pendientes:
```
aws docdb-elastic list-pending-maintenance-actions
```
La salida de esta operación será similar a lo que se indica a continuación (formato JSON):
```
{
'ResourcePendingMaintenanceActions': [
{
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'ENGINE_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'string',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
},
],
'NextToken': 'string'
}
```
Obtenga la acción de mantenimiento pendiente (si la hubiera) en un `resourceArn` dado:
```
aws docdb-elastic get-pending-maintenance-action --resource-arn string-arn
```
La salida de esta operación será similar a lo que se indica a continuación (formato JSON).
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'ENGINE_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'string',
'CurrentApplyDate': 'string',
'Description': 'string'
}
]
}
}
```
Parámetros:
+ `ResourceArn`: el Nombre de recurso de Amazon (ARN) de Amazon DocumentDB del recurso al que se aplica la acción de mantenimiento pendiente.
+ `Action`: la acción de mantenimiento pendiente que se aplica a este recurso.
Valores válidos:
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ `AutoAppliedAfterDate`: primer período de mantenimiento después de esta fecha. `NEXT_MAINTENANCE OPT_IN` se ignora en este caso.
+ `ForcedApplyDate`: se aplica independientemente del período de mantenimiento. `IMMEDIATE OPT_IN` se ignora en este caso.
+ `OptInStatus`: un valor que indica el tipo de solicitud de alta o deshace una solicitud de alta. Una solicitud de alta de tipo `IMMEDIATE` no se puede deshacer.
Valores válidos:
+ `IMMEDIATE`: aplicar inmediatamente la acción de mantenimiento.
+ `NEXT_MAINTENANCE`: aplicar la acción de mantenimiento durante la siguiente ventana de mantenimiento del recurso.
+ `APPLY_ON`: aplicar la acción de mantenimiento en la fecha de aplicación especificada, independientemente del siguiente período de mantenimiento del recurso.
+ `UNDO_OPT_IN`: cancelar todas las solicitudes de alta de `NEXT_MAINTENANCE` o `APPLY_ON` existentes.
+ `CurrentApplyDate`—Se muestra si lo opt-in-type está`APPLY_ON`.
+ `Description`: una descripción de la opción para la acción de mantenimiento.
## Actualizaciones del motor de clústeres elásticos
Con Amazon DocumentDB puede elegir el momento en que desea aplicar las operaciones de mantenimiento. Puede indicar cuándo Amazon DocumentDB debe aplicar las actualizaciones mediante la AWS CLI.
Aplique las acciones de mantenimiento pendientes:
```
aws docdb-elastic apply-pending-maintenance-action
--resource-arn string-arn
--apply-action string-enum
--opt-in-type string-enum
[--apply-on string-date-range]
```
Parámetros:
+ **--resource-arn**: el Nombre de recurso de Amazon (ARN) de Amazon DocumentDB del recurso al que se aplica la acción de mantenimiento pendiente.
+ **--apply-action**: la acción de mantenimiento pendiente que se aplica a este recurso.
Valores válidos:
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ **--opt-in-type**: un valor que indica el tipo de solicitud de alta o deshace una solicitud de alta. Una solicitud de alta de tipo `IMMEDIATE` no se puede deshacer.
Valores válidos:
+ `IMMEDIATE`: aplicar inmediatamente la acción de mantenimiento.
+ `NEXT_MAINTENANCE`: aplicar la acción de mantenimiento durante la siguiente ventana de mantenimiento del recurso.
+ `APPLY_ON`: aplicar la acción de mantenimiento en la fecha de aplicación especificada, independientemente del siguiente período de mantenimiento del recurso.
+ `UNDO_OPT_IN`: cancelar todas las solicitudes de alta de `NEXT_MAINTENANCE` o `APPLY_ON` existentes.
+ **[--apply-on]**: obligatorio si opt-in-type es `APPLY_ON`. Formato: `yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm` (Esta opción usa la hora UTC. La hora de inicio puede ser en cualquier momento futuro, entre un mínimo de 30 minutos y un máximo de 14 días, o la force/apply fecha de la acción pendiente, lo que ocurra primero. (El intervalo de tiempo de inicio a fin puede ser de un mínimo de 30 minutos a un máximo de 8 horas).
La salida de esta operación será similar a lo que se indica a continuación (formato JSON):
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'SECURITY_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'IMMEDIATE',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
}
}
```
Parámetros:
+ `ResourceArn`: el Nombre de recurso de Amazon (ARN) de Amazon DocumentDB del recurso al que se aplica la acción de mantenimiento pendiente.
+ `Action`: la acción de mantenimiento pendiente que se aplica a este recurso.
Valores válidos:
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ `AutoAppliedAfterDate`: primer período de mantenimiento después de esta fecha. `NEXT_MAINTENANCE OPT_IN` se ignora en este caso.
+ `ForcedApplyDate`: se aplica independientemente del período de mantenimiento. `IMMEDIATE OPT_IN` se ignora en este caso.
+ `OptInStatus`: un valor que indica el tipo de solicitud de alta o deshace una solicitud de alta. Una solicitud de alta de tipo `IMMEDIATE` no se puede deshacer.
Valores válidos:
+ `IMMEDIATE`: aplicar inmediatamente la acción de mantenimiento.
+ `NEXT_MAINTENANCE`: aplicar la acción de mantenimiento durante la siguiente ventana de mantenimiento del recurso.
+ `APPLY_ON`: aplicar la acción de mantenimiento en la fecha de aplicación especificada, independientemente del siguiente período de mantenimiento del recurso.
+ `UNDO_OPT_IN`: cancelar todas las solicitudes de alta de `NEXT_MAINTENANCE` o `APPLY_ON` existentes.
+ `CurrentApplyDate`—Se muestra si opt-in-type es `APPLY_ON` así.
+ `Description`: una descripción de la opción para la acción de mantenimiento.
### Fechas de aplicación
Cada operación de mantenimiento tiene una fecha de aplicación que encontrará al describir las operaciones de mantenimiento pendientes. Al leer el resultado de las acciones de mantenimiento pendientes del AWS CLI, aparecen tres fechas:
+ `CurrentApplyDate`: fecha en la que se aplicará la acción de mantenimiento inmediatamente o en la siguiente ventana de mantenimiento. Si el mantenimiento es opcional, este valor puede ser nulo.
+ `ForcedApplyDate`: fecha en la que el mantenimiento se aplicará automáticamente, independientemente del período de mantenimiento.
+ `AutoAppliedAfterDate`: fecha a partir de la cual se aplicará el mantenimiento durante el período de mantenimiento del clúster.
### Acciones de mantenimiento creadas por el usuario
Como usuario del DBelastic clúster de Amazon Document, puede iniciar actualizaciones en las configuraciones de los clústeres.
**Actualización de la contraseña principal del clúster**
```
aws docdb-elastic update-cluster
--cluster-arn string-arn
[--admin-user-password string]
[--auth-type string-enum]
[--apply-method string-enum]
[--apply-on string-date-range]
#... other parameters of the API that follow here are not relevant for this configuration
```
Parámetros:
+ **--cluster-arn**: el Nombre de recurso de Amazon (ARN) de Amazon DocumentDB del recurso al que se aplicará la acción de mantenimiento pendiente.
+ **[--admin-user-password]**: la contraseña asociada al usuario administrador.
+ **[--auth-type]**: el tipo de autenticación utilizado para determinar dónde buscar la contraseña que se usa para acceder al clúster elástico. Los tipos válidos son `PLAIN_TEXT` o `SECRET_ARN`.
+ **[--apply-method]**: un valor que especifica el tipo de método que se aplica. Los valores permitidos son `IMMEDIATE` y `APPLY_ON`. El valor predeterminado es `IMMEDIATE`.
+ **[--apply-on]**: obligatorio si `apply-method` es `APPLY_ON`. Formato: `yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm` (Esta opción usa la hora UTC. La hora de inicio puede ser en cualquier momento futuro, entre un mínimo de 30 minutos y un máximo de 14 días. El intervalo de tiempo de inicio a fin puede ser de un mínimo de 30 minutos a un máximo de 8 horas).
La salida de esta operación será similar a lo que se indica a continuación (formato JSON):
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'MASTER_USER_PASSWORD_UPDATE',
'OptInStatus': 'APPLY_ON',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
}
}
```
### Cambio de los periodos de mantenimiento de Amazon DocumentDB
El periodo de mantenimiento debe corresponder al momento de mínimo uso y, por tanto, podría ser preciso modificarlo cada cierto tiempo. El clúster elástico deja de estar disponible durante este período solamente si se están aplicando cambios en el sistema (por ejemplo, se está realizando un cambio en la operación de escalado del almacenamiento) y se requiere una interrupción. Solamente dejará de estar disponible durante el tiempo mínimo requerido para realizar los cambios necesarios.
El valor predeterminado es un periodo de 30 minutos seleccionado al azar de un bloque de 8 horas de tiempo para cada región de Amazon Web Services, que tiene lugar un día de la semana de forma aleatoria.
Para cambiar el período de mantenimiento, consulte [Modificación de configuraciones de clústeres elásticos](elastic-managing.md#elastic-modify).
## Actualizaciones del sistema operativo para los clústeres elásticos
En ocasiones, los clústeres elásticos de Amazon DocumentDB requieren actualizaciones del sistema operativo. Amazon DocumentDB actualiza el sistema operativo a una versión más reciente para mejorar el rendimiento de la base de datos y la posición de seguridad general de los clientes. Las actualizaciones del sistema operativo no cambian la versión del motor del clúster elástico de Amazon DocumentDB.
La mayoría de las actualizaciones del sistema operativo para los clústeres elásticos de Amazon DocumentDB son opcionales y no tienen una fecha de aplicación fija. Sin embargo, si no aplica estas actualizaciones durante un tiempo, es posible que acaben siendo necesarias y se apliquen automáticamente durante el período de mantenimiento de su clúster. Esto ayuda a mantener la posición de seguridad de la base de datos. Para evitar cualquier tiempo de inactividad inesperado, le recomendamos que aplique las actualizaciones del sistema operativo al clúster elástico de Amazon DocumentDB tan pronto como estén disponibles y que establezca el período de mantenimiento del clúster en el momento que le resulte más conveniente según las necesidades de la empresa.