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.
Atualizado em 2024-09-25 GMT+08:00

Criação de uma transferência de disco EVS

Função

Esta API é usada para criar uma transferência de disco EVS. Após a transferência ter sido criada, um ID de transferência e uma chave de autenticação são retornados. Depois que uma transferência de disco é criada, o status do disco muda de available para awaiting-transfer*. Uma vez que a transferência é aceita, o status do disco muda para available novamente.

Restrições

Uma transferência de disco pode ser criada somente quando o status do disco estiver available. As restrições detalhadas são as seguintes:

Discos anuais/mensais não podem ser transferidos. Discos congelados não podem ser transferidos. Discos criptografados não podem ser transferidos. Discos com backups e snapshots não podem ser transferidos. Discos aplicados com políticas de backup não podem ser transferidos. Discos DSS não podem ser transferidos. Discos DESS não podem ser transferidos.

Método de chamada

Para obter detalhes, consulte Chamada de APIs.

URI

POST /v2/{project_id}/os-volume-transfer

Tabela 1 Parâmetros de caminho

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.

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

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.

Tabela 3 Parâmetros do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

transfer

Sim

CreateVolumeTransferOption object

O marcador de criação de transferência.

Tabela 4 CreateVolumeTransferOption

Parâmetro

Obrigatório

Tipo

Descrição

name

Sim

String

O nome da transferência. Você pode inserir até 64 caracteres.

volume_id

Sim

String

O ID do disco. Para obter o ID do disco, consulte Consulta de detalhes sobre todos os discos.

Parâmetros de resposta

Código de status: 202

Tabela 5 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

transfer

CreateVolumeTransferDetail object

A informação de transferência.

Tabela 6 CreateVolumeTransferDetail

Parâmetro

Tipo

Descrição

auth_key

String

A chave de autenticação da transferência do disco.

created_at

String

A hora em que a transferência foi criada.

Formato da hora: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX

id

String

O ID da transferência.

links

Array of Link objects

Os links de transferência.

name

String

O nome da transferência.

volume_id

String

O ID do disco.

Código de status: 400

Tabela 8 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error

Error object

A mensagem de erro retornada se ocorrer um erro.

Tabela 9 Error

Parâmetro

Tipo

Descrição

code

String

O código de erro retornado se ocorrer um erro.

Para obter detalhes sobre 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

Criar uma transferência de disco (O ID do disco é c86b9af4-151d-4ead-b62c-5fb967af0e37 e o nome da transferência é first volume.)

POST https://{endpoint}/v2/{project_id}/os-volume-transfer

{
  "transfer" : {
    "volume_id" : "c86b9af4-151d-4ead-b62c-5fb967af0e37",
    "name" : "first volume"
  }
}

Exemplo de respostas

Código de status: 202

Accepted

{
  "transfer" : {
    "id" : "1a7059f5-8ed7-45b7-8d05-2811e5d09f24",
    "created_at" : "2015-02-25T03:56:53.081642",
    "name" : "first volume",
    "volume_id" : "c86b9af4-151d-4ead-b62c-5fb967af0e37",
    "auth_key" : "9266c59563c84664",
    "links" : [ {
      "href" : "https://localhost/v2/firstproject/os-volume-transfer/3",
      "rel" : "self"
    }, {
      "href" : "https://localhost/firstproject/os-volume-transfer/3",
      "rel" : "bookmark"
    } ]
  }
}

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.