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.
Método de chamada
Para obter detalhes, consulte Chamada de APIs.
URI
POST /v3/{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 |
Integer |
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
POST https://{endpoint}/v3/{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,
"deleted_at" : null,
"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.
