Reversión de una instantánea en un disco de EVS (obsoleto)
Función
Esta API se utiliza para revertir una instantánea en un disco de EVS.
Nota:
Esta API ha sido obsoleta. Utilice otra API.
Restricciones
-
Una instantánea solo se puede revertir en su disco de origen. No es posible revertir a otro disco.
-
Solo se puede revertir un disco desde una instantánea cuando el disco se encuentra en estado available o error_rollbacking.
-
Las instantáneas cuyos nombres comienzan con el prefijo autobk_snapshot_ son creadas automáticamente por el sistema cuando se crean las copias de respaldo. Estas instantáneas no se pueden utilizar para revertir datos.
Método de invocación
Para obtener más información, consulte Invocación de las API.
URI
POST /v3/{project_id}/os-vendor-snapshots/{snapshot_id}/rollback
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| project_id | Sí | String | El ID del proyecto. |
| snapshot_id | Sí | String | El ID de la instantánea. |
Parámetros de solicitud
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| X-Auth-Token | Sí | String | Un token obtenido de IAM tiene una validez de 24 horas. Cuando utilice un token para la autenticación, almacénelo en memoria caché para evitar invocar frecuentemente la API. |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| rollback | Sí | RollbackSnapshotOptionV3 object | La información de reversión de la instantánea. Para obtener más información, consulte Parámetros en el campo rollback. |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| name | No | String | El nombre del disco que se va a revertir. Puede ingresar hasta 64 caracteres. Para obtener más información sobre cómo consultar el nombre del disco de destino, consulte el campo "name" en la respuesta en Consulta de detalles sobre un disco. NOTA: No utilice el parámetro Nombre solo. Si se va a utilizar name, también se debe especificar volume_id. |
| volume_id | Sí | String | El ID del disco que se va a revertir. Para obtener más información sobre cómo consultar el ID del disco de destino, consulte el campo "volume_id" en la respuesta de Consulta de detalles sobre una instantánea de EVS. |
Parámetros de respuesta
Código de estado: 202
| Parámetro | Tipo | Descripción |
|---|---|---|
| rollback | RollbackBody object | La información de reversión de la instantánea. Para obtener más información, consulte Parámetros en el campo rollback. |
| Parámetro | Tipo | Descripción |
|---|---|---|
| volume_id | String | El ID del disco de destino para la reversión de la instantánea. |
Código de estado: 400
| Parámetro | Tipo | Descripción |
|---|---|---|
| error | Error object | Definición El código de error devuelto si se produce un error. Para obtener más información sobre el código de error, consulte Códigos de error. Rango N/D |
| Parámetro | Tipo | Descripción |
|---|---|---|
| code | String | Definición El código de error devuelto si se produce un error. Rango Para obtener más información sobre el código de error, consulte Códigos de error. |
| message | String | Definición El mensaje de error devuelto si se produce un error. Rango N/D |
Ejemplos de solicitudes
POST https://{endpoint}/v3/{project_id}/os-vendor-snapshots/{snapshot_id}/rollback
{
"rollback" : {
"name" : "test-001",
"volume_id" : "5aa119a8-d25b-45a7-8d1b-88e127885635"
}
} Ejemplos de respuestas
Código de estado: 202
Accepted
{
"rollback" : {
"volume_id" : "5aa119a8-d25b-45a7-8d1b-88e127885635"
}
} Código de estado: 400
Bad Request
{
"error" : {
"message" : "XXXX",
"code" : "XXX"
}
} Códigos de estado
| Código de estado | Descripción |
|---|---|
| 202 | Accepted |
| 400 | Bad Request |
Códigos de error
Consulte Códigos de error.
