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.
