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 DocumentDBFullAccess política 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 utilizando 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**.
**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 vCPU asignado a cada partición. 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 mediante 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**.
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**.
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 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).
------