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.

# CopyClusterSnapshot
<a name="API_elastic_CopyClusterSnapshot"></a>

Copia una instantánea de un clúster elástico.

## Sintaxis de la solicitud
<a name="API_elastic_CopyClusterSnapshot_RequestSyntax"></a>

```
POST /cluster-snapshot/snapshotArn/copy HTTP/1.1
Content-type: application/json

{
   "copyTags": boolean,
   "kmsKeyId": "string",
   "tags": { 
      "string" : "string" 
   },
   "targetSnapshotName": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_elastic_CopyClusterSnapshot_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [snapshotArn](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-uri-snapshotArn"></a>
El identificador del Nombre de recurso de Amazon (ARN) de la instantánea del clúster elástico.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_elastic_CopyClusterSnapshot_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [targetSnapshotName](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-targetSnapshotName"></a>
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 de origen. Este parámetro no distingue entre mayúsculas y minúsculas.  
Restricciones:  
+ Deben contener de 1 a 63 caracteres (letras, números o guiones).
+ El primer carácter debe ser una letra.
+ No puede terminar con un guion ni contener dos guiones consecutivos.
Ejemplo: `elastic-cluster-snapshot-5`   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Obligatorio: sí

 ** [copyTags](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-copyTags"></a>
Establézcalo en `true` para copiar todas las etiquetas de la instantánea del clúster de origen a la instantánea del clúster de destino. El valor predeterminado es `false`.  
Tipo: Booleano  
Obligatorio: no

 ** [kmsKeyId](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-kmsKeyId"></a>
El identificador de clave de AWS KMS de una instantánea de clúster elástico cifrada. El ID de clave de AWS KMS es el nombre de recurso de Amazon (ARN), el identificador de clave de AWS KMS o el alias de clave de AWS KMS de la clave de cifrado de AWS KMS.  
Si copia una instantánea de un clúster elástico cifrada de su AWS cuenta, puede especificar un valor `KmsKeyId` para cifrar la copia con una nueva clave de cifrado de AWS S KMS. Si no especifica ningún valor para `KmsKeyId`, la copia de la instantánea del clúster elástico se cifra con la misma clave de `AWS` KMS que la instantánea del clúster elástico de origen.  
Si intenta copiar una instantánea del clúster elástico sin cifrar y especificar un valor para el parámetro `KmsKeyId`, se devuelve un error.  
Tipo: cadena  
Requerido: no

 ** [tags](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-tags"></a>
Las etiquetas que se van a asignar a la instantánea del clúster elástico.  
Tipo: mapa de cadena a cadena  
Limitaciones de longitud de la clave: longitud mínima de 1. Longitud máxima de 128.  
Patrón de clave: `(?!aws:)[a-zA-Z+-=._:/]+`   
Limitaciones de longitud de los valores: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_elastic_CopyClusterSnapshot_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "snapshot": { 
      "adminUserName": "string",
      "clusterArn": "string",
      "clusterCreationTime": "string",
      "kmsKeyId": "string",
      "snapshotArn": "string",
      "snapshotCreationTime": "string",
      "snapshotName": "string",
      "snapshotType": "string",
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## Elementos de respuesta
<a name="API_elastic_CopyClusterSnapshot_ResponseElements"></a>

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_elastic_CopyClusterSnapshot_ResponseSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-response-snapshot"></a>
Devuelve información sobre una instantánea específica del clúster elástico.  
Tipo: objeto [ClusterSnapshot](API_elastic_ClusterSnapshot.md)

## Errores
<a name="API_elastic_CopyClusterSnapshot_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
Una excepción que se produce cuando no hay permisos suficientes para realizar una acción.    
 ** message **   
Un mensaje de error que explica por qué se denegó el acceso.
Código de estado HTTP: 403

 ** ConflictException **   
Se ha producido un conflicto de acceso.    
 ** resourceId **   
El identificador del recurso en el que se produjo un conflicto de acceso.  
 ** resourceType **   
El tipo del recurso en el que se produjo un conflicto de acceso.
Código de estado HTTP: 409

 ** InternalServerException **   
Se ha producido un error en el servidor interno.  
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se pudo encontrar el recurso especificado.    
 ** message **   
Un mensaje de error que describe el error.  
 ** resourceId **   
El identificador del recurso que no se pudo encontrar.  
 ** resourceType **   
El tipo del recurso que no se pudo encontrar.
Código de estado HTTP: 404

 ** ServiceQuotaExceededException **   
Se ha superado la cuota de servicio para la acción.  
Código de estado HTTP: 402

 ** ThrottlingException **   
ThrottlingException se emitirá cuando se rechace la solicitud debido a la limitación de la solicitud.    
 ** retryAfterSeconds **   
La cantidad de segundos que se debe esperar para volver a intentar la operación.
Código de estado HTTP: 429

 ** ValidationException **   
Estructura que define una excepción de validación.    
 ** fieldList **   
Una lista de los campos en los que se produjo la excepción de validación.  
 ** message **   
Un mensaje de error que describe la excepción de validación.  
 ** reason **   
El motivo por el que se produjo la excepción de validación (uno de los siguientes: `unknownOperation`, `cannotParse`, `fieldValidationFailed` o `other`).
Código de estado HTTP: 400

## Véase también
<a name="API_elastic_CopyClusterSnapshot_SeeAlso"></a>

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/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/CopyClusterSnapshot)