Copia de instantáneas de clústeres de Amazon DocumentDB - Amazon DocumentDB
Copia de instantáneas compartidasCopiar instantáneas de un lado a otro Regiones de AWSLimitacionesTratamiento del cifradoConsideraciones relativas al grupo de parámetros Copia de una instantánea de clúster

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.

Copia de instantáneas de clústeres de Amazon DocumentDB

En Amazon DocumentDB, puede copiar instantáneas dentro de la misma Región de AWS o en una diferente. Región de AWS También puede copiar las instantáneas compartidas a su cuenta en la misma cuenta Región de AWS o en una diferente. Región de AWS Para obtener más información sobre cómo compartir instantáneas, consulte Uso compartido de instantáneas de clústeres de Amazon DocumentDB.

nota

Amazon DocumentDB le factura en función de la cantidad de datos de copias de seguridad e instantáneas que conserve y el periodo de tiempo que los conserve. Para obtener más información sobre el almacenamiento asociado con las copias de seguridad y las instantáneas de Amazon DocumentDB, consulte Descripción del uso de almacenamiento de copias de seguridad en . Para obtener información acerca de los precios del almacenamiento de Amazon DocumentDB, consulte Precios de Amazon DocumentDB.

Copia de instantáneas compartidas

Puedes copiar las instantáneas que otras AWS cuentas hayan compartido contigo. Si va a copiar una instantánea cifrada que se ha compartido desde otra AWS cuenta, debe tener acceso a la clave de AWS KMS cifrado que se utilizó para cifrar la instantánea. Para obtener más información, consulte Tratamiento del cifrado.

Copiar instantáneas de un lado a otro Regiones de AWS

Al copiar una instantánea en una Región de AWS que es diferente de la instantánea de origen Región de AWS, cada copia es una instantánea completa. Una copia instantánea completa contiene todos los datos y metadatos necesarios para restaurar el clúster de Amazon DocumentDB.

Limitaciones

A continuación se indican algunas limitaciones al copiar instantáneas:

  • Si elimina una instantánea de origen antes de que la instantánea de destino esté disponible, la copia de la instantánea puede generar un error. Compruebe que la instantánea de destino tiene el estado AVAILABLE antes de eliminar una instantánea de origen.

  • Puede tener hasta cinco solicitudes de copia de instantánea en curso en una única región de destino por cuenta.

  • En función de lo que se Regiones de AWS trate y de la cantidad de datos que se vayan a copiar, una copia instantánea entre regiones puede tardar horas en completarse. En algunos casos, puede haber un gran número de solicitudes de copia de instantáneas entre regiones desde una Región de AWS de origen determinada. En estos casos, Amazon DocumentDB podría poner en cola las nuevas solicitudes de copia entre regiones procedentes de esa fuente hasta que Región de AWS se completen algunas copias en curso. No se muestra ninguna información de progreso sobre las solicitudes de copia mientras están en la cola. La información de progreso se muestra cuando comienza la copia.

Tratamiento del cifrado

Puede copiar una instantánea que haya sido cifrada con una clave de cifrado de AWS KMS . Si copia una instantánea cifrada, la copia de la instantánea se debe cifrar también. Si copia una instantánea cifrada dentro de la misma Región de AWS, puede cifrar la copia con la misma clave de AWS KMS cifrado que la instantánea original o puede especificar una clave de cifrado diferente. AWS KMS Si copia una instantánea cifrada de una región a otra, no podrá utilizar la misma clave de AWS KMS cifrado para la copia que se utilizó para la instantánea de origen, ya que AWS KMS las claves son específicas de cada región. En su lugar, debe especificar una AWS KMS clave válida en el destino Región de AWS n.

La instantánea de origen permanece cifrada durante todo el proceso de copia. Para obtener más información, consulte Protección de datos en Amazon DocumentDB.

nota

Para instantáneas del clúster de Amazon DocumentDB, no es posible cifrar una instantánea del clúster sin cifrar al copiar la instantánea.

Consideraciones relativas al grupo de parámetros

Cuando se copia una instantánea entre regiones, la copia no incluye el grupo de parámetros empleado por el clúster de Amazon DocumentDB. Al restaurar una instantánea para crear un nuevo clúster, ese clúster obtiene el grupo de parámetros predeterminado para el lugar en el Región de AWS que se creó. Para aplicar en el nuevo clúster los mismos parámetros que en el original, debe hacer lo siguiente:

  1. En el destino Región de AWS, cree un grupo de parámetros del clúster de Amazon DocumentDB con la misma configuración que el clúster original. Si ya existe uno en el nuevo Región de AWS, puede usarlo.

  2. Tras restaurar la instantánea en el destino Región de AWS, modifique el nuevo clúster de Amazon DocumentDB y añada el grupo de parámetros nuevo o existente del paso anterior. Para obtener más información, consulte Modificación de un clúster de Amazon DocumentDB.

Copia de una instantánea de clúster

Puede copiar un clúster de Amazon DocumentDB mediante el AWS Management Console o el AWS CLI, de la siguiente manera.

Using the AWS Management Console

Para hacer una copia de una instantánea de un clúster mediante el AWS Management Console, complete los siguientes pasos. Este procedimiento funciona para copiar instantáneas de clústeres cifradas o no cifradas, en la misma región Región de AWS o en varias regiones.

  1. Inicie sesión en y abra la AWS Management Console consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.

  2. En el panel de navegación, elija Instantáneas y, a continuación, el botón situado a la izquierda de la instantánea que desea restaurar.

    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.) en la esquina superior izquierda de la página.

  3. En el menú Actions, elija Copy.

  4. En la página Hacer una copia de una instantánea de clúster, rellene la sección Configuración.

    1. Región de destino: opcional. Para copiar la instantánea del clúster a otra Región de AWS, selecciónela en la región Región de AWS de destino.

    2. Nuevo identificador de instantánea: escriba un nombre para la nueva instantánea.

      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.

      • Debe ser único para todos los clústeres de Amazon RDS, Neptune y Amazon DocumentDB por región. Cuenta de AWS

    3. Copiar etiquetas: para copiar las etiquetas que tenga en su instantánea de origen a la copia de su instantánea, elija Copiar etiquetas.

  5. Complete la sección E. ncryption-at-rest

    1. Cifrado en reposo: si la instantánea no está cifrada, estas opciones no estarán disponibles, porque no puede crear una copia sin cifrar a partir de una instantánea cifrada. Si la instantánea está cifrada, puede cambiar la que AWS KMS key se utiliza durante el cifrado en reposo.

      Para obtener más información acerca del cifrado de las copias de instantáneas, consulte Copia del cifrado de instantáneas de clúster.

      Para obtener más información sobre el cifrado en reposo, consulte Cifrado de datos en reposo de Amazon DocumentDB.

    2. AWS KMS Clave: en la lista desplegable, elija una de las siguientes opciones:

      • (predeterminado) aws/rds: el número de cuenta y el identificador AWS KMS clave aparecen siguiendo esta opción.

      • < some-key-name > — Si ha creado una clave, aparece en la lista y está disponible para que la elija.

      • Introducir un ARN de clave: en el cuadro ARN, escriba el nombre de recurso de Amazon (ARN) de la clave de AWS KMS . El formato del ARN es el siguiente: arn:aws:kms:<region>:<accountID>:key/<key-id> .

  6. Para crear una copia de la instantánea seleccionada, elija Copy snapshot (Copiar instantánea). También puede seleccionar Cancelar si no desea hacer una copia de la instantánea.

Using the AWS CLI

Para realizar una copia de una instantánea de clúster sin cifrar mediante la AWS CLI, utilice la operación copy-db-cluster-snapshot con los siguientes parámetros. Si va a copiar la instantánea a otra Región de AWS, ejecute el comando en el Región de AWS que se copiará la instantánea.

  • --source-db-cluster-snapshot-identifier: obligatorio. El identificador de la instantánea del clúster de la que se va a hacer una copia. Debe existir la instantánea del clúster y tener el estado disponible. Si está copiando la instantánea en otra Región de AWS o si está copiando una instantánea de clúster compartida, este identificador debe estar en el formato ARN de la instantánea de clúster 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 que se va a crear a partir de la instantánea del clúster de origen. 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.

    • Debe ser único para todos los clústeres de Amazon RDS, Neptune y Amazon DocumentDB por región. Cuenta de AWS

  • --source-region— Si va a copiar la instantánea a otra Región de AWS, especifique desde dónde Región de AWS se copiará la instantánea del clúster cifrada.

    Si desea copiar la instantánea en otra Región de AWS y no especifica --source-region, debe especificar en su lugar la opción pre-signed-url. El pre-signed-url valor debe ser una URL que contenga una solicitud firmada en la versión 4 de Signature para que se llame a la CopyDBClusterSnapshot acción en la fuente desde la Región de AWS que se copia la instantánea del clúster. Para obtener más información sobre estopre-signed-url, consulte Copy DBCluster Snapshot.

  • --kms-key-id: identificador de la clave de KMS que se va a utilizar para cifrar la copia de la instantánea del clúster.

    Si va a copiar una instantánea de clúster cifrada en otra Región de AWS, este parámetro es obligatorio. Debe especificar una clave KMS para el destino Región de AWS.

    Si va a copiar una instantánea de clúster cifrada en el mismo Región de AWS, el parámetro AWS KMS clave es opcional. La copia de la instantánea del clúster se cifra con la misma AWS KMS clave que la instantánea del clúster de origen. Si desea especificar una nueva clave de AWS KMS cifrado para cifrar la copia, puede hacerlo mediante este parámetro.

  • --copy-tags— Opcional. Las etiquetas y los valores que se van a copiar.

Para cancelar una operación de copia una vez que está en curso, elimine la instantánea del clúster de destino identificado por --target-db-cluster-snapshot-identifier o TargetDBClusterSnapshotIdentifier mientras esa instantánea del clúster está en el estado copying.

Ejemplo 1: copia de una instantánea sin cifrar a la misma región

En el siguiente AWS CLI ejemplo, se crea una copia de sample-cluster-snapshot named sample-cluster-snapshot-copy in Región de AWS igual que la instantánea de origen. Cuando se crea la copia, todas las etiquetas de la instantánea original se copian en la copia de la instantánea.

Para Linux, macOS o Unix:

aws docdb copy-db-cluster-snapshot \
    --source-db-cluster-snapshot-identifier sample-cluster-snapshot \
    --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy \
    --copy-tags

Para Windows:

aws docdb copy-db-cluster-snapshot ^
    --source-db-cluster-snapshot-identifier sample-cluster-snapshot ^
    --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy ^
    --copy-tags

La salida de esta operación será similar a lo que se indica a continuación.

{
    "DBClusterSnapshot": {
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1b",
            "us-east-1c"
        ],
        "DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy",
        "DBClusterIdentifier": "sample-cluster",
        "SnapshotCreateTime": "2020-03-27T08:40:24.805Z",
        "Engine": "docdb",
        "Status": "copying",
        "Port": 0,    
        "VpcId": "vpc-abcd0123",
        "ClusterCreateTime": "2020-01-10T22:13:38.261Z",
        "MasterUsername": "master-user",
        "EngineVersion": "4.0.0",
        "SnapshotType": "manual",
        "PercentProgress": 0,
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:111122223333:key/sample-key-id",
        "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:111122223333:cluster-snapshot:sample-cluster-snapshot-copy",
        "SourceDBClusterSnapshotArn": "arn:aws:rds:us-east-1:111122223333:cluster-snapshot:sample-cluster-snapshot"
    }
}

Ejemplo 2: Copiar una instantánea no cifrada de un lado a otro Regiones de AWS

En el AWS CLI ejemplo siguiente se crea una copia desample-cluster-snapshot, que tiene el ARNarn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot. Esta copia recibe el nombre sample-cluster-snapshot-copy name y es Región de AWS en la que se ejecuta el comando.

Para Linux, macOS o Unix:

aws docdb copy-db-cluster-snapshot \
    --source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot \
    --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy

Para Windows:

aws docdb copy-db-cluster-snapshot ^
    --source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot ^
    --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy

La salida de esta operación será similar a lo que se indica a continuación.

{
    "DBClusterSnapshot": {
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1b",
            "us-east-1c"
        ],
        "DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy",
        "DBClusterIdentifier": "sample-cluster",
        "SnapshotCreateTime": "2020-04-29T16:45:51.239Z",
        "Engine": "docdb",
        "AllocatedStorage": 0,
        "Status": "copying",
        "Port": 0,
        "VpcId": "vpc-abc0123",
        "ClusterCreateTime": "2020-04-28T16:43:00.294Z",
        "MasterUsername": "master-user",
        "EngineVersion": "4.0.0",
        "LicenseModel": "docdb",
        "SnapshotType": "manual",
        "PercentProgress": 0,
        "StorageEncrypted": false,
        "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot-copy",
        "SourceDBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot",
    }
}

Ejemplo 3: copiar una instantánea cifrada de un lado a otro Regiones de AWS

En el siguiente AWS CLI ejemplo, se crea una copia de sample-cluster-snapshot de la región us-west-2 a la región us-east-1. Se llama a este comando en la región us-east-1.

Para Linux, macOS o Unix:

aws docdb copy-db-cluster-snapshot \
    --source-db-cluster-snapshot-identifier arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot \
    --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy \
    --source-region us-west-2 \
    --kms-key-id sample-us-east-1-key

Para Windows:

aws docdb copy-db-cluster-snapshot ^
    --source-db-cluster-snapshot-identifier arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot ^
    --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy ^
    --source-region us-west-2 ^
    --kms-key-id sample-us-east-1-key

La salida de esta operación será similar a lo que se indica a continuación.

{
    "DBClusterSnapshot": {  
        "AvailabilityZones": [],
        "DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy",
        "DBClusterIdentifier": "sample-cluster",
        "SnapshotCreateTime": "2020-04-29T16:45:53.159Z",
        "Engine": "docdb",
        "AllocatedStorage": 0,
        "Status": "copying",
        "Port": 0,
        "ClusterCreateTime": "2020-04-28T16:43:07.129Z",
        "MasterUsername": "chimera",
        "EngineVersion": "4.0.0",
        "LicenseModel": "docdb",
        "SnapshotType": "manual",
        "PercentProgress": 0,
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/0846496a-d48e-41c4-9353-86d8301d7e35",
        "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot-copy",
        "SourceDBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot",
    }
}

Ejemplo 4: Copiar una instantánea compartida sin cifrar en Regiones de AWS

El siguiente AWS CLI ejemplo, account -123456789012, crea una copia de una instantánea de clúster no cifrada sample-cluster-snapshot compartida por la cuenta, 999999999999 desde la región us-east-1 a la región us-west-2. Este comando se invoca en la región us-west-2. Para obtener más información sobre cómo compartir instantáneas, consulte Uso compartido de una instantánea.

Para Linux, macOS o Unix:

aws docdb copy-db-cluster-snapshot \
--region us-west-2 \
--source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot \
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy

Para Windows:

aws docdb copy-db-cluster-snapshot ^
--region us-west-2 ^
--source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot ^
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy

La salida de esta operación será similar a lo que se indica a continuación.

{
 "DBClusterSnapshots": [
 {
 "AvailabilityZones": [],
 "DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy",
 "DBClusterIdentifier": "sample-cluster",
 "SnapshotCreateTime": "2025-08-22T11:27:00.497000+00:00",
 "Engine": "docdb",
 "Status": "copying",
 "Port": 0,
 "ClusterCreateTime": "2024-07-02T16:44:50.246000+00:00",
 "MasterUsername": "master-user",
 "EngineVersion": "5.0.0",
 "SnapshotType": "manual",
 "PercentProgress": 0,
 "StorageEncrypted": false,
 "DBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot-copy",
 "SourceDBClusterSnapshotArn": "arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot"
 }
 ]
}

Ejemplo 5: copiar una instantánea compartida cifrada de un lado a otro Regiones de AWS

En el siguiente AWS CLI ejemplo, account: 123456789012 crea una copia de una instantánea de clúster cifrada sample-cluster-snapshot compartida por la cuenta, 999999999999 desde la región us-east-1 hasta la región us-west-2. La instantánea de destino se cifra con una clave KMS administrada por el cliente:. arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28 Este comando se invoca en la región us-west-2. Para obtener más información sobre cómo compartir instantáneas, consulte Uso compartido de una instantánea.

Para Linux, macOS o Unix:

aws docdb copy-db-cluster-snapshot \
--region us-west-2 \
--source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot \
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy \
--kms-key-id arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28

Para Windows:

aws docdb copy-db-cluster-snapshot ^
--region us-west-2 ^
--source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot ^
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy ^
--kms-key-id arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28

La salida de esta operación será similar a lo que se indica a continuación.

{
 "DBClusterSnapshots": [
 {
 "AvailabilityZones": [],
 "DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy",
 "DBClusterIdentifier": "sample-cluster",
 "SnapshotCreateTime": "2025-08-22T11:27:00.497000+00:00",
 "Engine": "docdb",
 "Status": "copying",
 "Port": 0,
 "ClusterCreateTime": "2024-07-02T16:44:50.246000+00:00",
 "MasterUsername": "master-user",
 "EngineVersion": "5.0.0",
 "SnapshotType": "manual",
 "PercentProgress": 0,
 "StorageEncrypted": true,
 "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28",
 "DBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot-copy",
 "SourceDBClusterSnapshotArn": "arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot"
 }
 ]
}
nota

Para obtener más información acerca del cifrado de las copias de instantáneas, consulte Copia del cifrado de instantáneas de clúster.

Para obtener más información sobre el cifrado en reposo, consulte Cifrado de datos en reposo de Amazon DocumentDB.