View a markdown version of this page

CreateClusterSnapshot - Amazon DocumentDB

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

Obbligatorio: sì

snapshotName

Il nome della nuova istantanea del cluster elastico.

Tipo: String

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

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.

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 Tipi di errore comuni.

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 traunknownOperation, cannotParsefieldValidationFailed, o). other

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: