ListClusterSnapshots
Devuelve información sobre las instantáneas de un clúster elástico especificado.
Sintaxis de la solicitud
GET /cluster-snapshots?clusterArn=clusterArn&maxResults=maxResults&nextToken=nextToken&snapshotType=snapshotType HTTP/1.1
Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- clusterArn
-
El identificador ARN del clúster elástico.
- maxResults
-
El número máximo de resultados de instantáneas de clúster elástico que se reciben en la respuesta.
Rango válido: valor mínimo de 20. Valor máximo de 100.
- nextToken
-
Un token de paginación proporcionado por una solicitud anterior. Si se especifica este parámetro, la respuesta solo incluye registros más allá del token, hasta el valor especificado por
max-results.Si no hay más datos en la respuesta, no se devolverá el
nextToken. - snapshotType
-
El tipo de instantáneas del clúster que se van a devolver. Puede especificar uno de los siguientes valores:
-
automated: devuelve todas las instantáneas del clúster que Amazon DocumentDB haya creado automáticamente para su cuenta de AWS. -
manual: devuelve todas las instantáneas del clúster que haya creado manualmente para su cuenta de AWS.
-
Cuerpo de la solicitud
La solicitud no tiene un cuerpo de la solicitud.
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"nextToken": "string",
"snapshots": [
{
"clusterArn": "string",
"snapshotArn": "string",
"snapshotCreationTime": "string",
"snapshotName": "string",
"status": "string"
}
]
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- nextToken
-
Un token de paginación proporcionado por una solicitud anterior. Si se especifica este parámetro, la respuesta solo incluye registros más allá del token, hasta el valor especificado por
max-results.Si no hay más datos en la respuesta, no se devolverá el
nextToken.Tipo: cadena
- snapshots
-
Una lista de instantáneas de un clúster elástico específico.
Tipo: matriz de objetos ClusterSnapshotInList
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- AccessDeniedException
-
Una excepción que se produce cuando no hay permisos suficientes para realizar una acción.
- message
-
Un mensaje de error que explica por qué se denegó el acceso.
Código de estado HTTP: 403
- InternalServerException
-
Se ha producido un error en el servidor interno.
Código de estado HTTP: 500
- ThrottlingException
-
Se lanzará ThrottlingException cuando se deniegue la solicitud debido a la limitación de la solicitud.
- retryAfterSeconds
-
La cantidad de segundos que se debe esperar para volver a intentar la operación.
Código de estado HTTP: 429
- ValidationException
-
Estructura que define una excepción de validación.
- fieldList
-
Una lista de los campos en los que se produjo la excepción de validación.
- message
-
Un mensaje de error que describe la excepción de validación.
- reason
-
El motivo por el que se produjo la excepción de validación (uno de los siguientes:
unknownOperation,cannotParse,fieldValidationFailedoother).
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
