Carregamento de uma imagem (API OpenStack nativo)
Função
Essa API é usada para fazer carregamento de uma imagem local para a plataforma de nuvem. A imagem a ser carregada deve ser menor que 2 GB.Para carregar uma imagem maior que 2 GB, consulte Registração de uma imagem.
Para obter mais informações sobre como usar arquivos externos para criar imagens, consulte Criação de uma imagem de disco do sistema Windows a partir de um arquivo de imagem externo e Criação de uma imagem de disco do sistema Linux a partir de um arquivo de imagem externo.
A seguir, descrevemos como usar essa API:
- Prepare a imagem a ser carregada. A imagem pode estar no formato QCOW2, VMDK, VHD, RAW, VHDX, QED, VDI, QCOW, ZVHD2, ou ZVHD.
- Crie metadados para a imagem, realizando as operações em Criação de metadados de imagem (API OpenStack nativo). Depois que a API for invocada com sucesso, salve o ID da imagem.
- Carregue o arquivo de imagem com o ID da imagem obtido em 2.
URI
PUT /v2/images/{image_id}/file
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
id_imagem |
Sim |
Cadeia |
Especifica o ID da imagem.
|
Solicitação
- Parâmetros de solicitação
Parâmetro
Obrigatório
Tipo
Descrição
image_file
Sim
Arquivo
Especifica o arquivo local a ser carregado.
- Exemplo de solicitação
PUT https://{Endpoint}/v2/images/84ac7f2b-bf19-4efb-86a0-b5be8771b476/file
Se você usar o comando curl para chamar a API, a solicitação de exemplo será a seguinte:
curl -i --insecure 'https://IP/v2/images/84ac7f2b-bf19-4efb-86a0-b5be8771b476/file' -X PUT -H "X-Auth-Token: $mytoken" -H "Content-Type:application/octet-stream" -T /mnt/userdisk/images/suse.zvhd
Valores retornados
- Normal
- Anormal
Valor retornado
Descrição
400 Solicitação inválida
Erro na solicitação. Para mais detalhes, 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.
409 Conflict
Pedido de conflito.
500 System Error
Erro de sistema.