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
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
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 |
---|---|---|---|
os-volume_upload_image |
Sim |
CinderExportToImageOption object |
O marcador da operação de exportação de imagem. |
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:
|
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:
|
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:
|
Parâmetros de resposta
Código de status: 202
Parâmetro |
Tipo |
Descrição |
---|---|---|
os-volume_upload_image |
Image object |
O marcador da operação de exportação de imagem. |
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. |
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. |
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
Parâmetro |
Tipo |
Descrição |
---|---|---|
error |
Error object |
A mensagem de erro retornada se ocorrer um erro. |
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.