CopyDBClusterSnapshot - Amazon DocumentDB
Parametri della richiestaElementi di rispostaErroriVedi anche

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.

SourceDBClusterSnapshotIdentifier

L'identificatore della snapshot del cluster da copiare. Questo parametro non distingue tra maiuscole e minuscole.

Vincoli:

  • Deve specificare una snapshot di sistema valida nello stato disponibile.

  • Se lo snapshot di origine è Regione AWS uguale alla copia, specificate un identificatore di snapshot valido.

  • Se lo snapshot di origine si trova in un formato Regione AWS diverso da quello della copia, specificare un ARN di snapshot del cluster valido.

Esempio: my-cluster-snapshot1

Tipo: stringa

Campo 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.

Esempio: my-cluster-snapshot2

Tipo: stringa

Campo obbligatorio: sì

CopyTags

trueImpostare 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

Campo 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 perKmsKeyId, 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: string

Campo 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: string

Campo obbligatorio: no

Tag.Tag.N

I tag da assegnare allo snapshot del cluster.

Tipo: matrice di oggetti Tag

Campo obbligatorio: no

Elementi di risposta

Il servizio restituisce il seguente elemento.

DBClusterSnapshot

Informazioni dettagliate su un'istantanea del cluster.

Tipo: oggetto DBClusterSnapshot

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

DBClusterSnapshotAlreadyExistsFault

Hai già un'istantanea del cluster con l'identificatore specificato.

Codice di stato HTTP: 400

DBClusterSnapshotNotFoundFault

DBClusterSnapshotIdentifiernon 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: