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à.
# CopyDBClusterSnapshot
Copia un'istantanea di un cluster.
Per copiare uno snapshot del cluster da uno snapshot del cluster manuale condiviso, `SourceDBClusterSnapshotIdentifier` deve essere l'Amazon Resource Name (ARN) dello snapshot del cluster condiviso. Puoi copiare solo uno snapshot condiviso del cluster di database, crittografato o meno, nella stessa Regione AWS.
*Per annullare l'operazione di copia dopo che è in corso, elimina lo snapshot del cluster di destinazione identificato da `TargetDBClusterSnapshotIdentifier` mentre lo snapshot del cluster è in stato di copia.*
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
** SourceDBClusterSnapshotIdentifier **
L'identificatore della snapshot del cluster da copiare. Questo parametro non distingue tra maiuscole e minuscole.
Vincoli:
+ *È necessario specificare un'istantanea del cluster valida nello stato disponibile.*
+ Se l'istantanea del cluster di origine è Regione AWS uguale alla copia, specificare un identificatore di snapshot valido.
+ Se lo snapshot del cluster di origine si trova in un altro account Regione AWS o è di proprietà di un altro AWS account, specificare l'ARN dello snapshot.
Ad esempio: `my-cluster-snapshot1`
Tipo: stringa
Obbligatorio: sì
** TargetDBClusterSnapshotIdentifier **
L'identificatore della nuova snapshot del cluster da creare dalla 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: `my-cluster-snapshot2`
Tipo: stringa
Obbligatorio: sì
** CopyTags **
`true`Impostare su per copiare tutti i tag dallo snapshot del cluster di origine allo snapshot del cluster di destinazione e in altro modo. `false` Il valore predefinito è `false`.
Tipo: Booleano
Obbligatorio: no
** KmsKeyId **
L'ID della AWS KMS chiave per un'istantanea del cluster crittografata. L'ID della AWS KMS chiave è l'Amazon Resource Name (ARN), l'identificatore della AWS KMS chiave o l'alias della AWS KMS chiave di crittografia. AWS KMS
Se copi uno snapshot crittografato del cluster dal tuo Account AWS, puoi specificare un valore per `KmsKeyId` crittografare la copia con una nuova chiave di crittografia. AWS KMS Se non si specifica un valore per`KmsKeyId`, la copia dello snapshot del cluster viene crittografata con la stessa AWS KMS chiave dello snapshot del cluster di origine.
Se si copia un'istantanea del cluster crittografata condivisa da un altro Account AWS, è necessario specificare un valore per. `KmsKeyId`
Per copiare un'istantanea del cluster crittografata su un'altra Regione AWS, imposta `KmsKeyId` l'ID della AWS KMS chiave che desideri utilizzare per crittografare la copia dello snapshot del cluster nella regione di destinazione. AWS KMS le chiavi di crittografia sono specifiche del dispositivo in Regione AWS cui vengono create e non è possibile utilizzare le chiavi di crittografia l'una nell'altra Regione AWS . Regione AWS
Se si copia un'istantanea del cluster non crittografata e si specifica un valore per il `KmsKeyId` parametro, viene restituito un errore.
▬Tipo: stringa
Obbligatorio: no
** PreSignedUrl **
L'URL che contiene una richiesta firmata Signature Version 4 per l'azione `CopyDBClusterSnapshot` API in Regione AWS quella che contiene lo snapshot del cluster di origine da copiare. È necessario utilizzare il `PreSignedUrl` parametro quando si copia uno snapshot del cluster da un altro. Regione AWS
Se utilizzate uno strumento AWS SDK o il AWS CLI, potete specificare `SourceRegion` (o `--source-region` per AWS CLI) invece di specificare manualmente. `PreSignedUrl` La specificazione `SourceRegion` genera automaticamente un URL prefirmato che rappresenta una richiesta valida per l'operazione che può essere eseguita nell'origine. Regione AWS
L'URL predefinito deve essere una richiesta valida per l'azione `CopyDBClusterSnapshot` API che può essere eseguita nell'origine Regione AWS che contiene lo snapshot del cluster da copiare. La richiesta URL prefirmata deve contenere i seguenti valori di parametro:
+ `SourceRegion`- L'ID della regione che contiene l'istantanea da copiare.
+ `SourceDBClusterSnapshotIdentifier`- L'identificatore per l'istantanea del cluster crittografata da copiare. L'identificatore deve essere nel formato Amazon Resource Name (ARN) per la Regione AWS di origine. Ad esempio, se stai copiando un'istantanea del cluster crittografata da us-east-1 Regione AWS, allora avrai un `SourceDBClusterSnapshotIdentifier` aspetto simile al seguente:. `arn:aws:rds:us-east-1:12345678012:sample-cluster:sample-cluster-snapshot`
+ `TargetDBClusterSnapshotIdentifier`- L'identificatore per la nuova istantanea del cluster da creare. Questo parametro non fa distinzione tra maiuscole e minuscole.
▬Tipo: stringa
Obbligatorio: no
**Tag.Tag.N**
I tag da assegnare allo snapshot del cluster.
Tipo: matrice di oggetti [Tag](API_Tag.md)
Obbligatorio: no
## Elementi di risposta
Il seguente elemento viene restituito dal servizio.
** DBClusterSnapshot **
Informazioni dettagliate su un'istantanea del cluster.
Tipo: oggetto [DBClusterSnapshot](API_DBClusterSnapshot.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** DBClusterSnapshotAlreadyExistsFault **
È già disponibile un'istantanea del cluster con l'identificatore specificato.
Codice di stato HTTP: 400
** DBClusterSnapshotNotFoundFault **
`DBClusterSnapshotIdentifier`non fa riferimento a un'istantanea del cluster esistente.
Codice di stato HTTP: 404
** InvalidDBClusterSnapshotStateFault **
Il valore fornito non è uno stato valido di snapshot del cluster.
Codice di stato HTTP: 400
** InvalidDBClusterStateFault **
Il cluster non è in uno stato valido.
Codice di stato HTTP: 400
** KMSKeyNotAccessibleFault **
Si è verificato un errore durante l'accesso a una AWS KMS chiave.
Codice di stato HTTP: 400
** SnapshotQuotaExceeded **
La richiesta comporterebbe il superamento del numero consentito di istantanee.
Codice di stato HTTP: 400
## Vedi anche
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-2014-10-31/CopyDBClusterSnapshot)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CopyDBClusterSnapshot)