Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Elastic Volume Service/ Referência de API/ APIs desatualizadas/ API/ Gerenciamento de snapshots/ Reversão de um snapshot para um disco EVS (preterido)
Atualizado em 2024-09-25 GMT+08:00
Ver PDF
Compartilhar

Reversão de um snapshot para um disco EVS (preterido)

Função

Esta API é usada para reverter um snapshot para um disco EVS.

Observação: esta API foi preterida. Use outra API.

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 snapshots não podem ser usados para reverter dados.

Método de chamada

Para obter detalhes, consulte Chamada de APIs.

URI

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

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

O ID do projeto.

snapshot_id

Sim

String

O ID do snapshot.

Parâmetros de solicitação

Tabela 2 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Um token obtido do IAM é válido por apenas 24 horas. Ao usar um token para autenticação, armazene-o em cache para evitar chamar a API com frequência.
Tabela 3 Parâmetros do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

rollback

Sim

RollbackSnapshotOptionV3 object

As informações de reversão de snapshot. Para obter detalhes, consulte Parâmetros no campo rollback.
Tabela 4 RollbackSnapshotOptionV3

Parâmetro

Obrigatório

Tipo

Descrição

name

Não

String

O nome do disco a ser revertido. Você pode inserir até 64 caracteres. Para obter detalhes sobre como consultar o nome do disco de destino, consulte o campo "name" na resposta em Consulta de detalhes sobre um disco.

NOTA:

Não use o parâmetro name sozinho. Se name for usado, volume_id também deve ser especificado.

volume_id

Sim

String

O ID do disco a ser revertido. Para obter detalhes sobre como consultar o ID do disco de destino, consulte o campo "volume_id" na resposta de Consulta de detalhes sobre um snapshot do EVS.

Parâmetros de resposta

Código de status: 202

Tabela 5 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

rollback

RollbackBody object

As informações de reversão de snapshot.

Para obter detalhes, consulte Parâmetros no campo rollback.
Tabela 6 RollbackBody

Parâmetro

Tipo

Descrição

volume_id

String

O ID do disco de destino para a reversão de snapshot.

Código de status: 400

Tabela 7 Parâmetros do corpo de resposta

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.
Tabela 8 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

POST https://{endpoint}/v3/{project_id}/os-vendor-snapshots/{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ódigos de status

Código de status

Descrição

202

Accepted

400

Bad Request

Códigos de erro

Consulte Códigos de erro.

Tópico principal: Gerenciamento de snapshots