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.
# CopySnapshot
Hace una copia de una instantánea existente.
## Sintaxis de la solicitud
```
{
"KmsKeyId": "string",
"SourceSnapshotName": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"TargetBucket": "string",
"TargetSnapshotName": "string"
}
```
## Parámetros de la solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).
La solicitud acepta los siguientes datos en formato JSON.
** [KmsKeyId](#API_CopySnapshot_RequestSyntax) **
El identificador de la clave de KMS que se utilizará para cifrar las instantáneas de destino.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 2048 caracteres.
Obligatorio: no
** [SourceSnapshotName](#API_CopySnapshot_RequestSyntax) **
El nombre de una instantánea existente de la que se realizará una copia.
Tipo: cadena
Obligatorio: sí
** [Tags](#API_CopySnapshot_RequestSyntax) **
Una lista de etiquetas que se agregarán a este recurso. Una etiqueta es un par clave-valor. La clave de etiqueta debe ir acompañada de un valor de etiqueta, aunque se acepta un valor nulo.
Tipo: matriz de objetos [Tag](API_Tag.md)
Miembros de la matriz: número máximo de 200 elementos.
Obligatorio: no
** [TargetBucket](#API_CopySnapshot_RequestSyntax) **
El bucket de Amazon S3 al que se exportará la instantánea. Este parámetro solo se usa cuando se exporta una instantánea para acceso externo. Cuando utilice este parámetro para exportar una instantánea, asegúrese de que MemoryDB tenga los permisos necesarios para este bucket de S3. Para obtener más información, consulte [Paso 2: Conceder acceso a MemoryDB a su bucket de Amazon S3](https://docs.aws.amazon.com/MemoryDB/latest/devguide/snapshots-exporting.html).
Tipo: cadena
Limitaciones de longitud: longitud máxima de 255 caracteres.
Patrón: `^[A-Za-z0-9._-]+$`
Obligatorio: no
** [TargetSnapshotName](#API_CopySnapshot_RequestSyntax) **
Un nombre de la copia de la instantánea. MemoryDB no permite sobrescribir una instantánea, por lo que este nombre debe ser único dentro de su contexto: MemoryDB o un bucket de Amazon S3 si se exporta. Este valor se almacena como una cadena en minúsculas.
Tipo: cadena
Obligatorio: sí
## Sintaxis de la respuesta
```
{
"Snapshot": {
"ARN": "string",
"ClusterConfiguration": {
"Description": "string",
"Engine": "string",
"EngineVersion": "string",
"MaintenanceWindow": "string",
"MultiRegionClusterName": "string",
"MultiRegionParameterGroupName": "string",
"Name": "string",
"NodeType": "string",
"NumShards": number,
"ParameterGroupName": "string",
"Port": number,
"Shards": [
{
"Configuration": {
"ReplicaCount": number,
"Slots": "string"
},
"Name": "string",
"Size": "string",
"SnapshotCreationTime": number
}
],
"SnapshotRetentionLimit": number,
"SnapshotWindow": "string",
"SubnetGroupName": "string",
"TopicArn": "string",
"VpcId": "string"
},
"DataTiering": "string",
"KmsKeyId": "string",
"Name": "string",
"Source": "string",
"Status": "string"
}
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [Snapshot](#API_CopySnapshot_ResponseSyntax) **
Representa una copia de un clúster completo en el momento en que se tomó la instantánea.
Tipo: objeto [Snapshot](API_Snapshot.md)
## Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).
** InvalidParameterCombinationException **
Código de estado HTTP: 400
** InvalidParameterValueException **
Código de estado HTTP: 400
** InvalidSnapshotStateFault **
Código de estado HTTP: 400
** ServiceLinkedRoleNotFoundFault **
Código de estado HTTP: 400
** SnapshotAlreadyExistsFault **
Código de estado HTTP: 400
** SnapshotNotFoundFault **
Código de estado HTTP: 400
** SnapshotQuotaExceededFault **
Código de estado HTTP: 400
** TagQuotaPerResourceExceeded **
Código de estado HTTP: 400
## Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+ [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/memorydb-2021-01-01/CopySnapshot)