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. 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.
Información de autorización
Cada cuenta tiene todos los permisos necesarios para invocar todas las API, pero los usuarios de IAM deben tener asignados los permisos requeridos.
- Si está utilizando la autorización basada en roles/políticas, consulte Políticas de permisos y acciones admitidas para obtener más información sobre los permisos requeridos.
- Si está utilizando la autorización basada en políticas de identidad, no se requiere ningún permiso basado en políticas de identidad para invocar esta API.
URI
POST /v2/{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 a la API. |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| rollback | Sí | RollbackDiskSnapshotOption object | La información de reversión de la instantánea. |
| 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 el cuerpo de la respuesta haciendo referencia a Consulta de detalles sobre un disco de EVS (obsoleto). No utilice el parámetro Nombre solo. Si se va a utilizar name, también se debe especificar volume_id. |
| volume_id | No | 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 el cuerpo de la respuesta haciendo referencia a Consulta de detalles sobre un disco de EVS (obsoleto). |
Parámetros de respuesta
Código de estado: 202
| Parámetro | Tipo | Descripción |
|---|---|---|
| rollback | DiskRollbackOption object | La información de reversión de la instantánea. |
| 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 |
Ejemplo de solicitudes
{
"rollback" : {
"name" : "test-001",
"volume_id" : "5aa119a8-d25b-45a7-8d1b-88e127885635"
}
} Ejemplo 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.
