Creación de una instantánea

Función

Esta API se utiliza para crear instantáneas para un clúster especificado.

URI

• Formato URI

  POST /v1.0/{project_id}/snapshots

• Descripción del parámetro

  Tabla 1 Parámetros URI

  Parámetro	Obligatorio	Tipo	Descripción
  project_id	Sí	String	ID de proyecto. Para obtener más información sobre cómo obtener el ID, consulte Obtención de un ID de proyecto.

Mensaje de solicitud

• Ejemplo de solicitud

  POST /v1.0/89cd04f168b84af6be287f71730fdb4b/snapshots
  {
      "snapshot": {
         "name": "snapshot-3",
         "cluster_id": "44b277eb-39be-4921-be31-3d61b43651d7",
         "description": "Snapshot-3 description"
       }
  }

• Descripción del parámetro

  Tabla 2 Parámetros de solicitud

  Parámetro	Obligatorio	Tipo	Descripción
  snapshot	Sí	Snapshot object	Objeto de instantánea.

  Tabla 3 Instantánea

  Parámetro	Obligatorio	Tipo	Descripción
  name	Sí	String	Nombre de la instantánea, que debe ser único y empezar con una letra. Consta de 4 a 64 caracteres, que son insensibles a mayúsculas y minúsculas y contienen letras, dígitos, guiones (-) y guiones bajos (_) solamente.
  cluster_id	Sí	String	ID del clúster para el que desea crear una instantánea. Para obtener más información sobre cómo obtener el ID, consulte Obtención del ID de clúster.
  description	No	String	Descripción de instantánea. Si no se especifica ningún valor, la descripción está vacía. Introduzca un máximo de 256 caracteres. No se permiten los siguientes caracteres especiales:!<>'=&"

Mensaje de la respuesta

• Ejemplo de respuesta

  status CODE 200
  {
      "snapshot": {
          "id": "2a4d0f86-67cd-408a-8b66-017454fb7793"
      }
  }

• Descripción del parámetro

  Tabla 4 Descripción del parámetro de respuesta

  Parámetro	Tipo	Descripción
  snapshot	SnapshotResp object	Objeto de instantánea

  Tabla 5 SnapshotResp

  Parámetro	Tipo	Descripción
  id	String	ID de instantánea

Código de estado

• Normal

  200

• Excepción

  Tabla 6 Valores devueltos

  Valor devuelto	Descripción
  400 Bad Request	Error de solicitud.
  401 Unauthorized	Error en la autorización.
  403 Forbidden	No hay permiso de operación.
  404 Not Found	No se encontraron recursos.
  500 Internal Server Error	Error interno del servicio.
  503 Service Unavailable	El servicio no está disponible.