Reversión de una instantánea en un disco de EVS
Función
Esta API se utiliza para revertir una instantánea a un disco de EVS. Se admite la autorización de proyectos empresariales.
Restricciones
-
Una instantánea solo se puede revertir en su disco de origen. No es posible revertir a otro disco.
-
Puede deshacer un disco desde una instantánea solo 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 cuando se crean 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 a las API.
URI
POST /v2/{project_id}/cloudsnapshots/{snapshot_id}/rollback
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
project_id |
Sí |
String |
El ID del proyecto. Para obtener más información sobre cómo obtener el ID de proyecto, consulte Obtención de un ID de 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 |
El token del usuario. Se puede obtener invocando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
rollback |
Sí |
RollbackSnapshotOption object |
La información de reversión de la instantánea. |
Parámetros de respuesta
Código de estado: 202
Parámetro |
Tipo |
Descripción |
---|---|---|
rollback |
RollbackInfo object |
La información de reversión de la instantánea. |
Parámetro |
Tipo |
Descripción |
---|---|---|
volume_id |
String |
El UUID del disco que se va a revertir. |
Código de estado: 400
Parámetro |
Tipo |
Descripción |
---|---|---|
error |
Error object |
El mensaje de error devuelto si se produce un error. Para obtener más detalles, consulte Parámetros en el campo error. |
Parámetro |
Tipo |
Descripción |
---|---|---|
code |
String |
El código de error devuelto si se produce un error. Para conocer los códigos de error y sus significados, véase Códigos de errores. |
message |
String |
El mensaje de error devuelto si se produce un error. |
Ejemplo de solicitudes
Reversión de una instantánea a un disco de EVS (El nombre del disco de destino es test-001 y el UUID es 5aa119a8-d25b-45a7-8d1b-88e127885635)
POST https://{endpoint}/v2/{project_id}/cloudsnapshots/{snapshot_id}/rollback { "rollback" : { "name" : "test-001", "volume_id" : "5aa119a8-d25b-45a7-8d1b-88e127885635" } }
Ejemplo de respuestas
Código de estado: 202
Aceptado
{ "rollback" : { "volume_id" : "5aa119a8-d25b-45a7-8d1b-88e127885635" } }
Código de estado: 400
Error en la solicitud
{ "error" : { "message" : "XXXX", "code" : "XXX" } }
Ejemplo de código del SDK
El ejemplo de código del SDK es el siguiente.
Java
Reversión de una instantánea a un disco de EVS (El nombre del disco de destino es test-001 y el UUID es 5aa119a8-d25b-45a7-8d1b-88e127885635)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 |
package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.evs.v2.region.EvsRegion; import com.huaweicloud.sdk.evs.v2.*; import com.huaweicloud.sdk.evs.v2.model.*; public class RollbackSnapshotSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); ICredential auth = new BasicCredentials() .withAk(ak) .withSk(sk); EvsClient client = EvsClient.newBuilder() .withCredential(auth) .withRegion(EvsRegion.valueOf("<YOUR REGION>")) .build(); RollbackSnapshotRequest request = new RollbackSnapshotRequest(); RollbackSnapshotRequestBody body = new RollbackSnapshotRequestBody(); RollbackSnapshotOption rollbackbody = new RollbackSnapshotOption(); rollbackbody.withName("test-001") .withVolumeId("5aa119a8-d25b-45a7-8d1b-88e127885635"); body.withRollback(rollbackbody); request.withBody(body); try { RollbackSnapshotResponse response = client.rollbackSnapshot(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } |
Python
Reversión de una instantánea a un disco de EVS (El nombre del disco de destino es test-001 y el UUID es 5aa119a8-d25b-45a7-8d1b-88e127885635)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 |
# coding: utf-8 from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkevs.v2.region.evs_region import EvsRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkevs.v2 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = __import__('os').getenv("CLOUD_SDK_AK") sk = __import__('os').getenv("CLOUD_SDK_SK") credentials = BasicCredentials(ak, sk) \ client = EvsClient.new_builder() \ .with_credentials(credentials) \ .with_region(EvsRegion.value_of("<YOUR REGION>")) \ .build() try: request = RollbackSnapshotRequest() rollbackbody = RollbackSnapshotOption( name="test-001", volume_id="5aa119a8-d25b-45a7-8d1b-88e127885635" ) request.body = RollbackSnapshotRequestBody( rollback=rollbackbody ) response = client.rollback_snapshot(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) |
Go
Reversión de una instantánea a un disco de EVS (El nombre del disco de destino es test-001 y el UUID es 5aa119a8-d25b-45a7-8d1b-88e127885635)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 |
package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" evs "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/evs/v2" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/evs/v2/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/evs/v2/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). Build() client := evs.NewEvsClient( evs.EvsClientBuilder(). WithRegion(region.ValueOf("<YOUR REGION>")). WithCredential(auth). Build()) request := &model.RollbackSnapshotRequest{} nameRollback:= "test-001" rollbackbody := &model.RollbackSnapshotOption{ Name: &nameRollback, VolumeId: "5aa119a8-d25b-45a7-8d1b-88e127885635", } request.Body = &model.RollbackSnapshotRequestBody{ Rollback: rollbackbody, } response, err := client.RollbackSnapshot(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } |
Otro más
Para obtener un ejemplo de código del SDK de más lenguajes de programación, consulta la ficha Ejemplo de código en API Explorer. El ejemplo de código del SDK se puede generar automáticamente.
Códigos de estado
Código de estado |
Descripción |
---|---|
202 |
Aceptado |
400 |
Error en la solicitud |
Códigos de error
Consulte Códigos de error.