Exportação de uma imagem
Função
Essa é uma API de extensão usada para exportar uma imagem privada para um bucket do OBS.
Antes de exportar uma imagem, verifique se você tem a permissão de administrador do locatário para OBS.
Restrições
- As seguintes imagens privadas não podem ser exportadas:
- Imagens de ECS Inteiro
- Imagens de ISO
- Imagens privadas criadas a partir de uma imagem pública do Windows ou do SUSE
- Imagens privadas criadas a partir de uma imagem do Marketplace
- O tamanho da imagem deve ser inferior a 1 TB. Imagens maiores que 128 GB suportam apenas exportação rápida.
URI
POST /v1/cloudimages/{image_id}/file
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
id_imagem |
Sim |
Cadeia |
Especifica o ID da imagem. Para obter detalhes de como conseguir o ID de domínio, clique em Consulta de imagens. |
Solicitação
- Parâmetros de solicitação
Parâmetro
Obrigatório
Tipo
Descrição
bucket_url
Sim
Cadeia
Especifica a URL do arquivo de imagem no formato Nome do bucket:Nome do arquivo.
NOTA:A classe de armazenamento do bucket do OBS deve ser Standard.
file_format
Sim
Cadeia
Especifica o formato do arquivo. O valor pode ser qcow2, vhd, zvhd, ou vmdk.
is_quick_export
Não
Booleano
Se deve ativar a exportação rápida. O valor pode ser true ou false.
NOTA:Se a exportação rápida estiver ativada, o file_format não pode ser especificado.
- Exemplo de solicitação
POST https://{Endpoint}/v1/cloudimages/d164b5df-1bc3-4c3f-893e-3e471fd16e64/file
1 2 3 4 5
{ "bucket_url": "ims-image:centos7_5.qcow2", "file_format": "qcow2", "is_quick_export": false }
Resposta
- Parâmetros de resposta
Parâmetro
Tipo
Descrição
trabalho_id
Cadeia
Especifica o ID do trabalho assíncrono.
Para mais detalhes, consulte Consulta dos trabalhos assíncronos.
- Exemplo de resposta
CÓDIGO DE STATUS 200
1 2 3
{ "job_id": "edc89b490d7d4392898e19b2deb34797" }
Valor retornado
- Normal
- Anormal
Valor retornado
Descrição
400 Solicitação inválida
Erro na solicitação. Para obter detalhes sobre o código de erro retornado, consulte Códigos de erro.
401 Não autorizado
Autenticação falhou.
403 Proibido
Você não tem os direitos para realizar a operação.
404 Não encontrado
O recurso solicitado não foi encontrado.
500 Erro de servidor interno
Erro de serviço interno.
503 Serviço indisponível
Serviço não está disponível.