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à.
ListClusterSnapshots
Restituisce informazioni sulle istantanee per un cluster elastico specificato.
Sintassi della richiesta
GET /cluster-snapshots?clusterArn=clusterArn&maxResults=maxResults&nextToken=nextToken&snapshotType=snapshotType HTTP/1.1
Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- clusterArn
-
L'identificatore ARN del cluster elastico.
- maxResults
-
Il numero massimo di risultati di snapshot del cluster elastico da ricevere nella risposta.
Intervallo valido: valore minimo di 20. valore massimo pari a 100.
- nextToken
-
Un token di impaginazione fornito da una richiesta precedente. Se viene specificato questo parametro, la risposta include solo i record oltre questo token, fino al valore specificato da
max-results.Se non ci sono più dati nella risposta, non
nextTokenverrà restituita. - snapshotType
-
Il tipo di istantanee del cluster da restituire. È possibile specificare uno dei seguenti valori:
-
automated- Restituisci tutte le istantanee del cluster che Amazon DocumentDB ha creato automaticamente per AWS il tuo account. -
manual- Restituisci tutte le istantanee del cluster che hai creato manualmente per il tuo account. AWS
-
Corpo della richiesta
La richiesta non ha un corpo della richiesta.
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"nextToken": "string",
"snapshots": [
{
"clusterArn": "string",
"snapshotArn": "string",
"snapshotCreationTime": "string",
"snapshotName": "string",
"status": "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.
- nextToken
-
Un token di impaginazione fornito da una richiesta precedente. Se viene specificato questo parametro, la risposta include solo i record oltre questo token, fino al valore specificato da
max-results.Se non ci sono più dati nella risposta, non
nextTokenverrà restituita.Tipo: String
- snapshots
-
Un elenco di istantanee per un cluster elastico specificato.
Tipo: matrice di oggetti ClusterSnapshotInList
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
- InternalServerException
-
Si è verificato un errore interno del server.
Codice di stato HTTP: 500
- 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 tra
unknownOperation,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:
