Administración de instantáneas de los clústeres elásticos - Amazon DocumentDB
Creación de una instantánea manual del clústerVisualización de una instantánea de un clúster elásticoRestauración de un clúster desde una instantáneaCopia de una instantánea de un clúster elásticoEliminar una instantánea de un clúster elásticoAdministración de una copia de seguridad automática de una instantánea de un clúster elástico

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

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 mediante la AWS Management Console o la AWS CLI siguiendo estas instrucciones.

Using the AWS Management Console

Para crear una instantánea manual de un clúster elástico mediante la AWS Management Console:

  1. Inicie sesión en la AWS Management Console de Amazon DocumentDB y ábrala.

  2. En el panel de navegación, elija 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.

  3. En la página Snapshots (Instantáneas), elija Create (Crear).

  4. 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
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 del clúster con la AWS CLI, utilice la operación create-cluster-snapshot 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.

En el siguiente ejemplo, reemplace cada marcador de posición del usuario 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 mediante la AWS Management Console o la AWS CLI siguiendo estas instrucciones.

Using the AWS Management Console

Para ver información acerca de una instantánea específica del clúster elástico con la AWS Management Console:

  1. Inicie sesión en la AWS Management Console de Amazon DocumentDB y ábrala.

  2. En el panel de navegación, elija 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.

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

  4. Consulta la información de la instantánea en Detalles.

    Diagrama: instantánea de Elastic Cluster View
Using the AWS CLI

Para ver información sobre una instantánea de un clúster elástico específica mediante la AWS CLI, utilice la operación get-cluster-snapshot con los siguientes parámetros:

  • --snapshot-arn: obligatorio. El identificador del ARN de la instantánea de la que desea obtener información.

En el siguiente ejemplo, reemplace cada marcador de posición del usuario 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 la AWS CLI, utilice la operación get-cluster-snapshot con los siguientes parámetros:

  • --snapshot-arn: obligatorio. El identificador del ARN de la instantánea de la que desea obtener información.

En el siguiente ejemplo, reemplace cada marcador de posición del usuario 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 la AWS CLI, utilice la operación list-cluster-snapshots 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: devuelve todas las instantáneas del clúster que Amazon DocumentDB haya creado automáticamente para su cuenta de AWS.

    • manual: devuelve todas las instantáneas del clúster que haya creado manualmente para su cuenta de AWS.

    • shared: devuelve todas las instantáneas del clúster de base de datos manual que se han compartido a su cuenta de AWS.

    • 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

En el siguiente ejemplo, reemplace cada marcador de posición del usuario 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 mediante la AWS Management Console o la AWS CLI siguiendo estas instrucciones.

Using the AWS Management Console

Para restaurar un clúster elástico a partir de una instantánea utilizando la AWS Management Console:

  1. Inicie sesión en la AWS Management Console de Amazon DocumentDB y ábrala.

  2. En el panel de navegación, elija 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.

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

  4. En Acciones, elija Restaurar.

    Diagrama: restauración de clústeres elásticos a partir de una instantánea

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

  6. En el campo Nube privada virtual (VPC), elija una VPC de la lista desplegable.

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

  8. 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 desde una instantánea con la AWS CLI, utilice la operación restore-cluster-from-snapshot 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 la clave de KMS es el nombre de recurso de Amazon (ARN) de la clave de cifrado de AWS KMS. 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 en KmsKeyId y si el parámetro StorageEncrypted es verdadero, Amazon DocumentDB utilizará su clave de cifrado predeterminada.

  • --subnet-ids: opcional. ID de subred de red.

En el siguiente ejemplo, reemplace cada marcador de posición del usuario con 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 AWS Management Console o la AWS CLI.

Using the AWS Management Console

Para copiar una instantánea de un clúster elástico mediante la AWS Management Console:

  1. Inicie sesión en la AWS Management Console de Amazon DocumentDB y ábrala.

  2. En el panel de navegación, elija 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.

  3. Seleccione el botón situado a la izquierda de la instantánea que desea copiar en la columna Identificador de la instantánea.

  4. Seleccione Acciones y, a continuación, Copiar.

    Diagrama: copia de instantánea de clúster elástico

  5. En Identificador de la nueva instantánea, escriba un nombre para la instantánea nueva.

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

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

  8. Seleccione Copiar instantánea cuando haya terminado.

Using the AWS CLI

Para copiar una instantánea del clúster elástico con la AWS CLI, utilice la operación copy-cluster-snapshot 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. Si desea copiar la instantánea en otra Región de AWS, este identificador debe estar en el formato de ARN para la Región de AWS de origen. 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 por un guion ni contener dos guiones consecutivos.

En el siguiente ejemplo, reemplace cada marcador de posición del usuario con su propia información.

Para Linux, macOS o Unix:

aws docdb-elastic copy-cluster-snapshot \
     ‐‐source-cluster-snapshot-arn <sample ARN> \
     ‐‐target-cluster-snapshot-name my-target-copied-snapshot

Para Windows:

aws docdb-elastic copy-cluster-snapshot ^
     ‐‐source-cluster-snapshot-arn <sample 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 AWS Management Console o la AWS CLI.

Using the AWS Management Console

Para restaurar un clúster elástico a partir de una instantánea utilizando la AWS Management Console:

  1. Inicie sesión en la AWS Management Console de Amazon DocumentDB y ábrala.

  2. En el panel de navegación, elija 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.

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

  4. Elija Acciones y, a continuación, elija Eliminar.

    Diagrama: el clúster elástico elimina una instantánea

  5. En el cuadro de diálogo Eliminar la instantánea “snapshot-name”, seleccione Eliminar.

Using the AWS CLI

Para eliminar una instantánea manual del clúster elástico con la AWS CLI, utilice la operación delete-cluster-snapshot 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, reemplace cada marcador de posición del usuario con 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 establecer parámetros de copia de seguridad automática en una instantánea de un clúster elástico mediante la AWS Management Console o la AWS CLI.

Using the AWS Management Console

Para configurar una copia de seguridad automática para una nueva instantánea de un clúster elástico mediante la AWS Management Console:

  1. Inicie sesión en la AWS Management Console de Amazon DocumentDB y ábrala.

  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 del panel de navegación.

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

  4. Elija Acciones y, a continuación, Modificar.

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

    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.

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

      2. Seleccione Sin preferencia si desea que Amazon DocumentDB elija la hora y la duración de la creación de las copias de seguridad.

  6. Elija Modificar clúster cuando haya terminado.

Using the AWS CLI

Para establecer una copia de seguridad automática para una nueva instantánea del clúster elástico con la AWS CLI, utilice la operación create-cluster-snapshot 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 una ventana de 30 minutos seleccionada al azar dentro de un bloque de 8 horas para cada 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.

En el siguiente ejemplo, reemplace cada marcador de posición del usuario con su propia información.

En el siguiente ejemplo de create-cluster, se crea el clúster de muestra del clúster elástico de Amazon DocumentDB con un periodo 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