Reversão de um snapshot para um disco EVS
Função
Esta API é usada para reverter um snapshot para um disco EVS. A autorização do projeto empresarial é suportada.
Restrições
-
Um snapshot pode ser revertido somente para seu disco de origem. A reversão para outro disco não é possível.
-
Você pode reverter um disco de um snapshot somente quando o disco estiver no estado available ou error_rollbacking.
-
Snapshots cujos nomes começam com o prefixo autobk_snapshot_ são criados automaticamente pelo sistema quando os backups são criados. Esses instantâneos não podem ser usados para reverter dados.
Método de chamada
Para obter detalhes, consulte Chamada de APIs.
URI
POST /v2/{project_id}/cloudsnapshots/{snapshot_id}/rollback
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
O ID do projeto. Para obter detalhes sobre como obter o ID de projeto, consulte Obtenção de um ID de projeto. |
snapshot_id |
Sim |
String |
O ID do snapshot. |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
X-Auth-Token |
Sim |
String |
O token do usuário. Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário. |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
rollback |
Sim |
RollbackSnapshotOption object |
As informações de reversão de snapshot. |
Parâmetros de resposta
Código de status: 202
Parâmetro |
Tipo |
Descrição |
---|---|---|
rollback |
RollbackInfo object |
As informações de reversão de snapshot. |
Código de status: 400
Parâmetro |
Tipo |
Descrição |
---|---|---|
error |
Error object |
A mensagem de erro retornada se ocorrer um erro. Para obter detalhes, consulte Parâmetros no campo error. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
code |
String |
O código de erro retornado se ocorrer um erro. Para os códigos de erro e seus significados, consulte Códigos de erro. |
message |
String |
A mensagem de erro retornada se ocorrer um erro. |
Exemplo de solicitações
Reverter um snapshot para um disco EVS (O nome do disco de destino é test-001 e UUID é 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" } }
Exemplo de respostas
Código de status: 202
Accepted
{ "rollback" : { "volume_id" : "5aa119a8-d25b-45a7-8d1b-88e127885635" } }
Código de status: 400
Bad Request
{ "error" : { "message" : "XXXX", "code" : "XXX" } }
Código de amostra do SDK
O código de amostra do SDK é o seguinte.
Java
Reverter um snapshot para um disco EVS (O nome do disco de destino é test-001 e UUID é 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
Reverter um snapshot para um disco EVS (O nome do disco de destino é test-001 e UUID é 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
Reverter um snapshot para um disco EVS (O nome do disco de destino é test-001 e UUID é 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) } } |
Mais
Para obter o código de amostra do SDK de mais linguagens de programação, consulte a guia Código de amostra no API Explorer. O código de amostra do SDK pode ser gerado automaticamente.
Códigos de status
Código de status |
Descrição |
---|---|
202 |
Accepted |
400 |
Bad Request |
Códigos de erro
Consulte Códigos de erro.