Reversión de una instantánea a un disco EVS

Función

Esta API se utiliza para revertir una instantánea a un disco EVS.

Restricciones

• Cuando se revierte una instantánea en un disco, sólo se puede revertir la instantánea en el disco de origen. No se admite la reversión a un disco especificado.
• Puede deshacer un disco desde una instantánea sólo cuando el disco está en el estado available o error_rollbacking.
• 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 utilice estas instantáneas para revertir los datos del disco.

URI

• Formato URI

  POST /v2/{project_id}/os-vendor-snapshots/{snapshot_id}/rollback

• 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

• Descripción del parámetro

  Parámetro	Tipo	Obligatorio	Descripción
  rollback	Object	Sí	Especifica la información de reversión de instantáneas. Para obtener más información, consulte Parámetros en el campo rollback.

• Parámetros en el campo rollback

  Parámetro	Tipo	Obligatorio	Descripción
  volume_id	String	Sí	Especifica el ID del disco de destino.
  name	String	No	Especifica el nombre del disco de destino. NOTA: El parámetro name no se puede utilizar de forma independiente. Cuando se va a usar name, también se debe especificar volume_id.

• Solicitud de ejemplo

  {
      "rollback": {
          "name": "test-001",
          "volume_id": "5aa119a8-d25b-45a7-8d1b-88e127885635"
      }
  }

Respuesta

• Descripción del parámetro

  Parámetro	Tipo	Descripción
  rollback	Object	Especifica la información de reversión de instantáneas. Para obtener más información, consulte Parámetro en el campo de rollback.
  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ámetro en el campo rollback

  Parámetro	Tipo	Descripción
  volume_id	String	Especifica el ID del disco de destino.

• 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

  {
      "rollback": {
          "volume_id": "5aa119a8-d25b-45a7-8d1b-88e127885635"
      }
  }

  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:

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

Códigos de estado

• Normal

  202

Códigos de error

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