Detener e iniciar un clúster 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.

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 AWS Management Console 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 AWS Management Console

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 la consola AWS Management Console de Amazon DocumentDB y ábrala en https://console.aws.amazon.com/docdb.

2. 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 de la página.

3. En la lista de clústeres, elija el botón situado a la izquierda del nombre del clúster que quiera detener o iniciar.

4. 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.

        

        Para evitar la activación del mecanismo de activación por error, la operación de detención para primero las instancias de réplica y, a continuación, la instancia principal.

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

        

   • Si desea iniciar el clúster y este se detiene, seleccione Start (Iniciar).

     

5. 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 Determinar el estado de un clúster.

   

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 la AWS CLI, utilice la stop-db-cluster operación. 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.

ejemplo — 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

ejemplo — 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 realizar 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, consulteRestauración a un punto en el tiempo.

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.