Registração de uma imagem

Função

Essa API é usada para registrar um arquivo de imagem como uma imagem privada não inicializada na plataforma de nuvem.

A seguir, descrevemos como usar essa API:

1. Carregue o arquivo de imagem em um bucket do OBS. Para obter detalhes, consulte Carregamento de um arquivo ou uma pasta.
2. Use a API de criação de metadados de imagem para criar metadados de imagem. Depois que a API for invocada com sucesso, salve o ID da imagem. Para saber como criar metadados de imagem, consulte Criação de metadados de imagem (API OpenStack nativo).
3. Use a API para registrar imagens e o ID da imagem obtido em 2 para registrar o arquivo de imagem como uma imagem privada.
4. Depois que a API é invocada com sucesso como assíncrona, o sistema de serviço em nuvem recebe uma solicitação. Consulte o status da imagem usando o ID da imagem e verifique se o arquivo de imagem foi registrado com sucesso. Quando o status da imagem muda para active, o arquivo de imagem é registrado com êxito como uma imagem privada.

   Para obter detalhes sobre como consultar o status de uma tarefa assíncrona, consulte Consulta dos trabalhos assíncronos.

Antes de registrar um arquivo de imagem, verifique se você tem a permissão de administrador do locatário para OBS.

URI

PUT /v1/cloudimages/{image_id}/upload

Solicitação

• Parâmetros de solicitação

  Parâmetro	Obrigatório	Tipo	Descrição
  image_url	Sim	Cadeia	Especifica a URL do arquivo de imagem no formato Nome do bucket:Nome do arquivo. Os arquivos de imagem no intervalo podem estar no formato ZVHD, QCOW2, VHD, RAW, VHDX, QED, VDI, QCOW, ZVHD2, ISO, ou VMDK. NOTA: A classe de armazenamento do bucket do OBS deve ser Standard.

• Exemplo de solicitação

  PUT https://{Endpoint}/v1/cloudimages/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba86/upload

  1 2 3

  { "image_url": "bucketname:Centos6.5-disk1.vmdk" }

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

  HTTP/1.1 200

  1 2 3

  { "job_id":" b912fb4a4c464b568ecfca1071b21b10" }

Valor retornado

• Normal

  200

• Anormal