

# Copia de una instantánea de clúster de base de datos cifrada con la AWS CLI o la API de Amazon RDS
<a name="USER_CopyDBClusterSnapshot.Encrypted.CrossRegion"></a>

Utilice los procedimientos que se describen en las siguientes secciones para copiar una instantánea de clúster de base de datos cifrada con la Consola de administración de AWS, la AWS CLI o la API de Amazon RDS.

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

## Consola
<a name="USER_CopyDBClusterSnapshot.Encrypted.CrossRegion.Console"></a>

Para copiar una instantánea de clúster de base de datos mediante la Consola de administración de AWS, consulte [Copia de una instantánea de clúster de base de datos con la Consola de administración de AWS](USER_CopyDBClusterSnapshot.CrossRegion.md).

## AWS CLI
<a name="USER_CopyDBClusterSnapshot.Encrypted.CrossRegion.CLI"></a>

Para copiar una instantánea del clúster, utilice el comando [copy-db-clúster-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-snapshot.html) de la AWS CLI. Si desea copiar la instantánea en otra Región de AWS , ejecute el comando en la Región de AWS en la que se va a copiar la instantánea. 

Las siguientes opciones se usan para copiar una instantánea de clúster de base de datos cifrada:
+ `--source-db-cluster-snapshot-identifier`: identificador de la instantánea del clúster de base de datos cifrada que se va a copiar. 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.
+ `--target-db-cluster-snapshot-identifier`: identificador de la nueva copia de la instantánea de clúster de base de datos cifrada.
+ `--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 de base de datos.

  Puede utilizar esta opción si la instantánea del clúster de base de datos está cifrada, si la instantánea se va a copiar en la misma Región de AWS y si desea especificar una nueva clave de KMS para cifrar la copia. De lo contrario, la copia de la instantánea del clúster de base de datos se cifra con la misma clave de KMS que la instantánea del clúster de base de datos de origen. 

  Debe usar esta opción si la instantánea del clúster de base de datos está cifrada y va a copiar la instantánea en otra Región de AWS. En ese caso, debe especificar una clave de KMS para la Región de AWS de destino.

El siguiente ejemplo de código copia la instantánea del clúster de base de datos cifrada de la región EE.UU. Oeste (Oregón) a la región US East (N. Virginia). El comando se llama en la región US East (N. Virginia).

**Example**  
Para Linux, macOS o:Unix  

```
aws rds copy-db-cluster-snapshot \
  --source-db-cluster-snapshot-identifier arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115 \
  --target-db-cluster-snapshot-identifier myclustersnapshotcopy \
  --kms-key-id my-us-east-1-key
```
En:Windows  

```
aws rds copy-db-cluster-snapshot ^
  --source-db-cluster-snapshot-identifier arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115 ^
  --target-db-cluster-snapshot-identifier myclustersnapshotcopy ^
  --kms-key-id my-us-east-1-key
```

El parámetro `--source-region` es necesario cuando se copia una instantánea de clúster de base de datos cifrada entre las regiones AWSGovCloud (Este de EE. UU.) y AWS GovCloud (EE. UU. Oeste). Para `--source-region`, especifique la Región de AWS de la instancia de base de datos de origen. La Región de AWS especificada en `source-db-cluster-snapshot-identifier` debe coincidir con la Región de AWS especificada para `--source-region`.

Si `--source-region` no se especificó, especifique un valor de `--pre-signed-url`. Una *URL prefirmada* es una URL que contiene una solicitud firmada de Signature Version 4 para el comando `copy-db-cluster-snapshot` que se llama en la Región de AWS de origen. Para obtener más información acerca de la opcion `pre-signed-url`, consulte [copy-db-clúster-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-snapshot.html) en la *Referencia de los comandos de AWS CLI*.

## API de RDS
<a name="USER_CopyDBClusterSnapshot.Encrypted.CrossRegion.API"></a>

Para copiar una instantánea de clúster de base de datos, utilice la operación [CopyDBclústerSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBClusterSnapshot.html) de la API de Amazon RDS. Si desea copiar la instantánea en otra Región de AWS, lleve a cabo la acción en la Región de AWS en la que se va a copiar la instantánea.

Los siguientes parámetros se usan para copiar una instantánea de clúster de base de datos cifrada:
+ `SourceDBClusterSnapshotIdentifier`: identificador de la instantánea del clúster de base de datos cifrada que se va a copiar. 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. 
+ `TargetDBClusterSnapshotIdentifier`: identificador de la nueva copia de la instantánea de clúster de base de datos cifrada.
+ `KmsKeyId`: identificador de la clave de KMS que se va a utilizar para cifrar la copia de la instantánea del clúster de base de datos.

  Puede utilizar este parámetro si la instantánea del clúster de base de datos está cifrada, si la instantánea se va a copiar en la misma Región de AWS y si desea especificar una nueva clave de KMS que se utilizará para cifrar la copia. De lo contrario, la copia de la instantánea del clúster de base de datos se cifra con la misma clave de KMS que la instantánea del clúster de base de datos de origen. 

  Debe usar este parámetro si la instantánea del clúster de base de datos está cifrada y va a copiar la instantánea en otra Región de AWS. En ese caso, debe especificar una clave de KMS para la Región de AWS de destino.
+ `PreSignedUrl`: si desea copiar la instantánea en otra Región de AWS, debe especificar el parámetro de `PreSignedUrl`. El valor de `PreSignedUrl` debe ser una URL que contenga una solicitud firmada de Signature Version 4 para la acción `CopyDBClusterSnapshot` que se debe llamar en la Región de AWS de origen desde la que se va a copiar la instantánea de clúster de base de datos. Para obtener más información acerca del uso de una URL prefirmada, consulte [CopyDBclústerSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBClusterSnapshot.html). 

El siguiente ejemplo de código copia la instantánea del clúster de base de datos cifrada de la región EE.UU. Oeste (Oregón) a la región US East (N. Virginia). La acción se llama en la región US East (N. Virginia).

**Example**  

```
https://rds.us-east-1.amazonaws.com/
    ?Action=CopyDBClusterSnapshot
    &KmsKeyId=my-us-east-1-key
    &PreSignedUrl=https%253A%252F%252Frds.us-west-2.amazonaws.com%252F
         %253FAction%253DCopyDBClusterSnapshot
         %2526DestinationRegion%253Dus-east-1
         %2526KmsKeyId%253Dmy-us-east-1-key
         %2526SourceDBClusterSnapshotIdentifier%253Darn%25253Aaws%25253Ards%25253Aus-west-2%25253A123456789012%25253Acluster-snapshot%25253Aaurora-cluster1-snapshot-20161115
         %2526SignatureMethod%253DHmacSHA256
         %2526SignatureVersion%253D4
         %2526Version%253D2014-10-31
         %2526X-Amz-Algorithm%253DAWS4-HMAC-SHA256
         %2526X-Amz-Credential%253DAKIADQKE4SARGYLE%252F20161117%252Fus-west-2%252Frds%252Faws4_request
         %2526X-Amz-Date%253D20161117T215409Z
         %2526X-Amz-Expires%253D3600
         %2526X-Amz-SignedHeaders%253Dcontent-type%253Bhost%253Buser-agent%253Bx-amz-content-sha256%253Bx-amz-date
         %2526X-Amz-Signature%253D255a0f17b4e717d3b67fad163c3ec26573b882c03a65523522cf890a67fca613
    &SignatureMethod=HmacSHA256
    &SignatureVersion=4
    &SourceDBClusterSnapshotIdentifier=arn%3Aaws%3Ards%3Aus-west-2%3A123456789012%3Acluster-snapshot%3Aaurora-cluster1-snapshot-20161115
    &TargetDBClusterSnapshotIdentifier=myclustersnapshotcopy
    &Version=2014-10-31
    &X-Amz-Algorithm=AWS4-HMAC-SHA256
    &X-Amz-Credential=AKIADQKE4SARGYLE/20161117/us-east-1/rds/aws4_request
    &X-Amz-Date=20161117T221704Z
    &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date
    &X-Amz-Signature=da4f2da66739d2e722c85fcfd225dc27bba7e2b8dbea8d8612434378e52adccf
```

El parámetro `PreSignedUrl` es necesario cuando se copia una instantánea de clúster de base de datos cifrada entre las regiones AWSGovCloud (Este de EE. UU.) y AWS GovCloud (EE. UU. Oeste). El valor de `PreSignedUrl` debe ser una URL que contenga una solicitud firmada de Signature Version 4 para la operación `CopyDBClusterSnapshot` que se debe llamar en la Región de AWS de origen desde la que se va a copiar la instantánea de clúster de base de datos. Para obtener más información acerca del uso de una URL prefirmada, consulte [CopyDBclústerSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBClusterSnapshot.html) en la *Amazon RDS API Reference*. 

Para generar una URL prefirmada de forma automática y no manual, use el comando [copy-db-clúster-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-snapshot.html) de la AWS CLI con la opción `--source-region`.