Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda> Image Management Service> Referência de API> As API OpenStack nativo> Imagem (As API OpenStack nativo)> Carregamento de uma imagem (API OpenStack nativo)
Atualizado em 2022-11-16 GMT+08:00
Ver PDF

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:

  1. Prepare a imagem a ser carregada. A imagem pode estar no formato QCOW2, VMDK, VHD, RAW, VHDX, QED, VDI, QCOW, ZVHD2, ou ZVHD.
  2. 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.
  3. Carregue o arquivo de imagem com o ID da imagem obtido em 2.

URI

PUT /v2/images/{image_id}/file

Tabela 1 lista os parâmetros no URI.
Tabela 1 Descrição do parâmetro

Parâmetro

Obrigatório

Tipo

Descrição

id_imagem

Sim

Cadeia

Especifica o ID da imagem.

  • image_id é o ID da imagem que você criou ao invocar a API para criar metadados de imagem. O carregamento de imagens pode falhar se você usar outros os ID de imagem.
  • Depois que essa API for chamada, você poderá verificar o status da imagem com o ID da imagem. Quando o status da imagem muda para active, a imagem é carregada com sucesso.

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

Resposta

  • Parâmetros de resposta

    None

  • Exemplo de resposta
    HTTP/1.1 204

Valores retornados

  • Normal

    204

  • 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.