CreateClusterSnapshot - Amazon DocumentDB
Sintassi della richiestaParametri della richiesta URI:Corpo 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à.

CreateClusterSnapshot

Crea un'istantanea di un cluster elastico.

Sintassi della richiesta

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

{
   "clusterArn": "string",
   "snapshotName": "string",
   "tags": { 
      "string" : "string" 
   }
}

Parametri della richiesta URI:

La richiesta non utilizza parametri URI.

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

clusterArn

L'identificatore ARN del cluster elastico di cui si desidera creare un'istantanea.

Tipo: stringa

Campo obbligatorio: sì

snapshotName

Il nome della nuova istantanea del cluster elastico.

▬Tipo: stringa

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

Campo obbligatorio: sì

tags

I tag da assegnare alla nuova istantanea 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'operazione riesce, il servizio restituisce una risposta HTTP 200.

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

snapshot

Restituisce informazioni sulla nuova istantanea 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.

Codice di stato HTTP: 403

ConflictException

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.

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.

Codice di stato HTTP: 429

ValidationException

Una struttura che definisce un'eccezione di convalida.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: