Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Copia un'istantanea di un cluster elastico.

## Sintassi della richiesta
<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"
}
```

## Parametri della richiesta URI
<a name="API_elastic_CopyClusterSnapshot_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [snapshotArn](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-uri-snapshotArn"></a>
L'identificatore Amazon Resource Name (ARN) dello snapshot del cluster elastico.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_elastic_CopyClusterSnapshot_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [targetSnapshotName](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-targetSnapshotName"></a>
L'identificatore del nuovo snapshot del cluster elastico da creare a partire dallo snapshot del cluster di origine. Questo parametro non distingue tra maiuscole e minuscole.  
Vincoli:  
+ Deve contenere da 1 a 63 lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
Ad esempio: `elastic-cluster-snapshot-5`   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.  
Obbligatorio: sì

 ** [copyTags](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-copyTags"></a>
Impostare su `true` per copiare tutti i tag dallo snapshot del cluster di origine allo snapshot del cluster elastico di destinazione. Il valore predefinito è `false`.  
Tipo: Booleano  
Obbligatorio: no

 ** [kmsKeyId](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-kmsKeyId"></a>
L'ID della chiave AWS KMS per un'istantanea crittografata del cluster elastico. L'ID della chiave AWS KMS è l'Amazon Resource Name (ARN) AWS , l'identificatore della chiave KMS o AWS l'alias della chiave KMS per la chiave di crittografia KMS. AWS   
Se copi un'istantanea del cluster elastico crittografato dal tuo AWS account, puoi specificare un valore per crittografare la copia con una nuova chiave `KmsKeyId` di crittografia S KMS. AWS Se non specifichi un valore per`KmsKeyId`, la copia dello snapshot del cluster elastico viene crittografata con la stessa chiave `AWS` KMS dello snapshot del cluster elastico di origine.  
Se si copia uno snapshot del cluster elastico non crittografato e si specifica un valore per il `KmsKeyId` parametro, viene restituito un errore.  
▬Tipo: stringa  
Obbligatorio: no

 ** [tags](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-tags"></a>
I tag da assegnare allo snapshot del cluster elastico.  
Tipo: mappatura stringa a stringa  
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.  
Modello di chiave:`(?!aws:)[a-zA-Z+-=._:/]+`   
Vincoli di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Obbligatorio: no

## Sintassi della risposta
<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" ]
   }
}
```

## Elementi di risposta
<a name="API_elastic_CopyClusterSnapshot_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [snapshot](#API_elastic_CopyClusterSnapshot_ResponseSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-response-snapshot"></a>
Restituisce informazioni su uno specifico snapshot del cluster elastico.  
Tipo: oggetto [ClusterSnapshot](API_elastic_ClusterSnapshot.md)

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

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** ConflictException **   
C'è stato un conflitto di accesso.    
 ** resourceId **   
L'ID della risorsa in cui si è verificato un conflitto di accesso.  
 ** resourceType **   
Il tipo di risorsa in cui si è verificato un conflitto di accesso.
Codice di stato HTTP: 409

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stato possibile trovare.
Codice di stato HTTP: 404

 ** ServiceQuotaExceededException **   
La quota di servizio per l'azione è stata superata.  
Codice di stato HTTP: 402

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta viene rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

## Vedi anche
<a name="API_elastic_CopyClusterSnapshot_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/CopyClusterSnapshot)