CopyClusterSnapshot - Amazon DocumentDB
Sintassi della richiestaURIParametri della richiestaCorpo della richiestaSintassi della rispostaElementi 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à.

CopyClusterSnapshot

Copia un'istantanea di un cluster elastico.

Sintassi della richiesta

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

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

URIParametri della richiesta

La richiesta utilizza i seguenti URI parametri.

snapshotArn

L'identificatore Amazon Resource Name (ARN) dello snapshot del cluster elastico.

Campo obbligatorio: sì

Corpo della richiesta

La richiesta accetta i seguenti dati nel JSON formato.

targetSnapshotName

L'identificatore della nuova istantanea 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.

Esempio: elastic-cluster-snapshot-5

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.

Campo obbligatorio: sì

copyTags

Impostato 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

Campo obbligatorio: no

kmsKeyId

L'ID della AWS KMS chiave per un'istantanea crittografata del cluster elastico. L'ID della AWS KMS chiave è l'Amazon Resource Name (ARN), AWS KMS l'identificatore della AWS KMS chiave o l'alias della chiave di AWS KMS crittografia.

Se copi un'istantanea del cluster elastico crittografato dal tuo AWS account, puoi specificare un valore per KmsKeyId crittografare la copia con una nuova AWS chiave di crittografia S. KMS Se non specifichi un valore perKmsKeyId, la copia dello snapshot del cluster elastico viene crittografata con la stessa AWS KMS chiave dello snapshot del cluster elastico di origine.

Se si copia un'istantanea del cluster elastico non crittografato e si specifica un valore per il KmsKeyId parametro, viene restituito un errore.

Tipo: string

Campo obbligatorio: no

tags

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.

Campo obbligatorio: no

Sintassi della risposta

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

Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal servizio.

snapshot

Restituisce informazioni su uno specifico snapshot del cluster elastico.

Tipo: oggetto ClusterSnapshot

Errori

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

AccessDeniedException

Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.

HTTPCodice di stato: 403

ConflictException

C'è stato un conflitto di accesso.

HTTPCodice di stato: 409

InternalServerException

Si è verificato un errore interno del server.

HTTPCodice di stato: 500

ResourceNotFoundException

Impossibile trovare la risorsa specificata.

HTTPCodice di stato: 404

ServiceQuotaExceededException

La quota di servizio per l'azione è stata superata.

HTTPCodice di stato: 402

ThrottlingException

ThrottlingException verrà generata quando la richiesta è stata rifiutata a causa della limitazione della richiesta.

HTTPCodice di stato: 429

ValidationException

Una struttura che definisce un'eccezione di convalida.

HTTPCodice di stato: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue: