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/ API Cinder/ Gerenciamento de disco/ Exportação de dados de disco EVS como uma imagem
Atualizado em 2024-09-25 GMT+08:00

Exportação de dados de disco EVS como uma imagem

Função

Essa API é usada para exportar dados de um sistema ou disco de dados como uma imagem do IMS. A imagem exportada será exibida na lista de imagens privadas do IMS e poderá ser visualizada e usada.

Restrições

A capacidade do disco deve ser menor ou igual a 1 TiB.

Método de chamada

Para obter detalhes, consulte Chamada de APIs.

URI

POST /v2/{project_id}/volumes/{volume_id}/action

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.

volume_id

Sim

String

O ID do disco.

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

os-volume_upload_image

Sim

CinderExportToImageOption object

O marcador da operação de exportação de imagem.

Tabela 4 CinderExportToImageOption

Parâmetro

Obrigatório

Tipo

Descrição

container_format

Não

String

O tipo de contêiner da imagem exportada.

O valor pode ser ami, ari, aki, ovf ou bare. O valor padrão é bare.

Padrão: bare

Valores de enumeração:

  • ami

  • ari

  • aki

  • ovf

  • bare

disk_format

Não

String

O formato da imagem exportada.

O valor pode ser vhd, zvhd, zvhd2, raw ou qcow2. O valor padrão é vhd.

Padrão: vhd

Valores de enumeração:

  • vhd

  • zvhd

  • zvhd2

  • raw

  • qcow2

force

Não

Boolean

Se a imagem pode ser exportada forçadamente. O valor padrão é false.

Se esse valor do parâmetro for false, as imagens não poderão ser exportadas forçadamente quando o status do disco estiver in-use. Se esse valor de parâmetro for true, as imagens poderão ser exportadas forçadamente mesmo quando o status do disco estiver in-use.

image_name

Sim

String

O nome da imagem exportada.

Pode conter de 1 a 128 caracteres. Pode conter letras, dígitos, hifens (-), pontos (.), sublinhados (_) e espaços.

__os_type

Não

String

O tipo de SO da imagem a ser exportada. Somente windows e linux são suportados. O valor padrão é linux. Esta configuração de parâmetro só tem efeito quando o campo __os_type não está incluído em volume_image_metadata e o status do disco está available. Se este parâmetro não for especificado, o valor padrão linux será usado.

Padrão: linux

Valores de enumeração:

  • windows

  • linux

Parâmetros de resposta

Código de status: 202

Tabela 5 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

os-volume_upload_image

Image object

O marcador da operação de exportação de imagem.

Tabela 6 Image

Parâmetro

Tipo

Descrição

container_format

String

O tipo de contêiner da imagem exportada.

O valor pode ser ami, ari, aki, ovf ou bare. O valor padrão é bare.

disk_format

String

O formato da imagem exportada.

O valor pode ser vhd, zvhd, zvhd2, raw ou qcow2. O valor padrão é vhd.

display_description

String

A descrição do disco.

id

String

O ID do disco.

image_id

String

O ID da imagem exportada.

image_name

String

O nome da imagem exportada.

size

Não

A capacidade do disco.

status

String

O status do disco depois que a imagem é exportada. O valor correto é uploading.

updated_at

String

A hora em que o disco foi atualizado.

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

volume_type

VolumeType object

O tipo de disco.

Tabela 7 VolumeType

Parâmetro

Tipo

Descrição

id

String

O ID do tipo de disco.

name

String

O nome do tipo de disco.

extra_specs

VolumeTypeExtraSpecs object

O flavor do tipo de disco.

description

String

A descrição do tipo de disco.

qos_specs_id

String

O campo reservado.

is_public

Boolean

O campo reservado.

Tabela 8 VolumeTypeExtraSpecs

Parâmetro

Tipo

Descrição

RESKEY:availability_zones

String

A lista de AZs onde o tipo de disco é suportado. Os elementos na lista são separados por vírgulas (,). Se esse parâmetro não for especificado, o tipo de disco é suportado em todas as AZs.

availability-zone

String

O campo reservado.

os-vendor-extended:sold_out_availability_zones

String

A lista de AZs em que o tipo de disco foi esgotado. Os elementos na lista são separados por vírgulas (,).

volume_backend_name

String

O campo reservado.

HW:availability_zone

String

O campo reservado.

Código de status: 400

Tabela 9 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error

Error object

A mensagem de erro retornada se ocorrer um erro.

Tabela 10 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

Exportar um disco EVS como uma imagem (Se o tipo de contêiner da imagem exportada estiver vazio, o formato da imagem exportada for VHD, o tipo de SO da imagem exportada for Linux e o disco EVS estiver no estado em uso, você poderá exportar a imagem à força.)

POST https://{endpoint}/v2/{project_id}/volumes/{volume_id}/action

{
  "os-volume_upload_image" : {
    "image_name" : "sxmatch2",
    "force" : true,
    "container_format" : "bare",
    "disk_format" : "vhd",
    "__os_type" : "linux"
  }
}

Exemplo de respostas

Código de status: 202

Accepted

{
  "os-volume_upload_image" : {
    "status" : "uploading",
    "size" : 40,
    "id" : "16369c5d-384d-4e64-b37a-56d898769362",
    "image_id" : "c5333daa-fbc8-4d1d-bf79-b0567bb45d15",
    "image_name" : "evs-ims-test1027",
    "volume_type" : {
      "description" : "None",
      "deleted" : false,
      "created_at" : "2015-05-24T14:47:22.132268",
      "updated_at" : "2017-07-29T11:29:33.730076",
      "extra_specs" : {
        "volume_backend_name" : "<or> FusionStorage_SATA <or> FusionStorage_SAS <or> fusionstoragesata",
        "XX:availability_zone" : "kvmxen.dc1"
      },
      "is_public" : true,
      "id" : "8247b6ed-37f0-4c48-8ef1-f0027fb332bc",
      "name" : "SATA"
    },
    "container_format" : "bare",
    "disk_format" : "vhd",
    "display_description" : "",
    "updated_at" : "2018-01-11T01:50:25.800931"
  }
}

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.