Consulta de detalles acerca de una instantánea de EVS

Función

Esta API se utiliza para consultar detalles sobre una instantánea de EVS.

URI

• Formato URI

  GET /v2/{project_id}/snapshots/{snapshot_id}

• Descripción del parámetro

  Parámetro	Obligatorio	Descripción
  project_id	Sí	Especifica el ID del proyecto. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
  snapshot_id	Sí	Especifica el ID de la instantánea.

Solicitud

• Solicitud de ejemplo

  GET https://{endpoint}/v2/{project_id}/snapshots/f9faf7df-fdc1-4093-9ef3-5cba06eef995

Respuesta

• Descripción del parámetro

  Parámetro	Tipo	Descripción
  snapshot	Object	Especifica la información de la instantánea. Para obtener más información, consulte Parámetros en el campo de instantánea.
  error	Object	Especifica el mensaje de error devuelto cuando se produce un error. Para obtener más información, consulte Parámetros en el campo de error.

• Parámetros en el campo de snapshot

  Parámetro	Tipo	Descripción
  id	String	Especifica el ID de la instantánea.
  status	String	Especifica el estado de la instantánea. Para más detalles, consulte Estado de instantánea de EVS.
  name	String	Especifica el nombre de la instantánea. Las instantáneas cuyos nombres comienzan con el prefijo autobk_snapshot_ son creadas automáticamente por el sistema durante las creaciones de copias de respaldo. No elimine estas instantáneas ni las use para revertir los datos del disco.
  description	String	Especifica la descripción de la instantánea.
  created_at	String	Especifica la hora a la que se creó la instantánea.
  updated_at	String	Especifica la hora a la que se actualizó la instantánea.
  metadata	Object	Especifica los metadatos de la instantánea. Si metadata contienen el campo __system__enableActive, la instantánea se crea automáticamente durante la copia de respaldo de un servidor.
  volume_id	String	Especifica el ID del disco de origen de la instantánea.
  size	Integer	Especifica el tamaño de la instantánea, en GB.
  os-extended-snapshot-attributes:project_id	String	Especifica el ID del inquilino.
  os-extended-snapshot-attributes:progress	String

• Parámetros en el campo de error

  Parámetro	Tipo	Descripción
  message	String	Especifica el mensaje de error devuelto cuando se produce un error.
  code	String	Especifica el código de error devuelto cuando se produce un error. Para obtener más información sobre el código de error, consulte Códigos de error.

• Ejemplo de respuesta

  {
      "snapshot": {
          "status": "available",
          "os-extended-snapshot-attributes:progress": "100%",
          "description": "daily backup",
          "created_at": "2013-02-25t04:13:17.000000",
          "metadata": {},
          "volume_id": "5aa119a8-d25b-45a7-8d1b-88e127885635",
          "os-extended-snapshot-attributes:project_id": "0c2eba2c5af04d3f9e9d0d410b371fde",
          "size": 1,
          "id": "2bb856e1-b3d8-4432-a858-09e4ce939389",
          "name": "snap-001",
          "updated_at": null
  
      }
  }

  o

  {
      "error": {
          "message": "XXXX", 
          "code": "XXX"
      }
  }

  En el ejemplo anterior, error indica un error general, por ejemplo, badRequest o itemNotFound. Un ejemplo es el siguiente:

  {
      "itemNotFound": {
          "message": "XXXX", 
          "code": "XXX"
      }
  }

Códigos de estado

• Normal

  200

Códigos de error

Para más detalles, consulte Códigos de error.