CreateClusterSnapshot - Amazon DocumentDB

CreateClusterSnapshot

Crea una instantánea de un clúster elástico.

Sintaxis de la solicitud

POST /cluster-snapshot HTTP/1.1 Content-type: application/json { "clusterArn": "string", "snapshotName": "string", "tags": { "string" : "string" } }

Parámetros de solicitud del URI

La solicitud no utiliza ningún parámetro de URI.

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

clusterArn

El identificador ARN del clúster elástico del que desea crear una instantánea.

Tipo: cadena

Obligatorio: sí

snapshotName

Nombre de la nueva instantánea del clúster elástico.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.

Obligatorio: sí

tags

Las etiquetas que se van a asignar a la instantánea del nuevo clúster elástico.

Tipo: mapa de cadena a cadena

Limitaciones de longitud de la clave: longitud mínima de 1. Longitud máxima de 128.

Patrón de clave: ^(?!aws:)[a-zA-Z+-=._:/]+$

Limitaciones de longitud de los valores: longitud mínima de 0. La longitud máxima es de 256 caracteres.

Requerido: no

Sintaxis de la respuesta

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" ] } }

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.

snapshot

Devuelve información sobre la nueva instantánea del clúster elástico.

Tipo: objeto ClusterSnapshot

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.

Código de estado HTTP: 403

ConflictException

Se ha producido un conflicto de acceso.

Código de estado HTTP: 409

InternalServerException

Se ha producido un error en el servidor interno.

Código de estado HTTP: 500

ResourceNotFoundException

No se pudo encontrar el recurso especificado.

Código de estado HTTP: 404

ServiceQuotaExceededException

Se ha superado la cuota de servicio para la acción.

Código de estado HTTP: 402

ThrottlingException

Se lanzará ThrottlingException cuando se deniegue la solicitud debido a la limitación de la solicitud.

Código de estado HTTP: 429

ValidationException

Estructura que define una excepción de validación.

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: