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 do IMS/ Imagem/ Importação rápida de um arquivo de imagem
Atualizado em 2022-11-16 GMT+08:00
Ver PDF

Importação rápida de um arquivo de imagem

Função

Essa API é usada para criar rapidamente uma imagem privada a partir de um arquivo de imagem externo superdimensionado que foi carregado no bucket do OBS. Atualmente, apenas arquivos de imagem ZVHD2 e RAW são suportados, e o tamanho de um arquivo de imagem não pode exceder 1 TB.

A função de criação rápida de imagens está disponível apenas para arquivos de imagem no formato RAW ou ZVHD2. Para outros formatos de arquivos de imagem menores que 128 GB, é aconselhável importar esses arquivos com o método comum.

A API é assíncrona. Se for chamado com sucesso, o sistema de serviço em nuvem recebe a solicitação. No entanto, você precisa usar a API de consulta de trabalho assíncrono para consultar o status de criação da imagem. Para mais detalhes, consulte Consulta dos trabalhos assíncronos.

Restrições

Antes de importar arquivos de imagem, verifique se o formato do arquivo é RAW ou ZVHD2 e faça o seguinte:
  • Os arquivos de imagem RAW foram otimizados e os arquivos bitmap foram gerados.
  • Os arquivos de imagem ZVHD2 foram otimizados conforme necessário.

Para obter detalhes sobre como converter o formato de arquivo de imagem e gerar um arquivo bitmap, consulte Importação rápida de um arquivo de imagem.

URI

POST /v2/cloudimages/quickimport/action

Solicitação

  • Parâmetros no corpo da solicitação quando um arquivo de imagem é usado para criar uma imagem de disco do sistema

    Parâmetro

    Obrigatório

    Tipo

    Descrição

    Nome

    Sim

    Cadeia

    Especifica o nome de imagem.

    Para uma descrição detalhada, consulte Atributos da imagem.

    Descrição

    Não

    Cadeia

    Fornece informações suplementares sobre a imagem.

    Para uma descrição detalhada, consulte Atributos da imagem.

    O valor contém um máximo de 1024 caracteres e consiste apenas em letras e dígitos. Não são permitidos retornos de carro e colchetes angulares (< >). Este parâmetro é deixado em branco por padrão.

    os_version

    Sim

    Cadeia

    Especifica a versão do SO.

    Esse parâmetro é válido se um arquivo de imagem externo carregado no bucket do OBS for usado para criar uma imagem. Para cujo valor, veja Valores de parâmetros relacionados.

    image_url

    Sim

    Cadeia

    Especifica a URL do arquivo de imagem externo no intervalo do OBS.

    Esse parâmetro é obrigatório se um arquivo de imagem externo no bucket do OBS for usado para criar uma imagem. O formato é nome de bucket do OBS:nome de arquivo de imagem.

    NOTA:

    A classe de armazenamento do bucket do OBS deve ser Standard.

    disco_mínimo

    Sim

    número inteiro

    Especifica o tamanho mínimo (GB) do disco do sistema.

    • Esse parâmetro é obrigatório se um arquivo de imagem externo no bucket do OBS for usado para criar uma imagem.
    • O valor varia de 1 a 1024 e deve ser maior que o tamanho do arquivo de imagem selecionado.

    Tags

    Não

    Matriz de strings

    Lista as tags de imagem. Este parâmetro é deixado em branco por padrão.

    Defina tags ou image_tags.

    image_tags

    Não

    Matriz de objetos

    Lista as tags de imagem. O valor é deixado em branco por padrão.

    Defina tags ou image_tags.

    Tipo

    Não

    String

    Especifica o tipo de imagem. O valor do parâmetro é ECS/BMS para imagens de disco do sistema. O valor padrão é ECS.

    enterprise_project_id

    No

    String

    Especifica o projeto da empresa ao qual a imagem pertence.

    • Se o valor for 0 ou deixado em branco, a imagem pertence ao projeto empresarial padrão.
    • Se o valor for um UUID, a imagem pertence ao projeto empresarial correspondente ao UUID.

      Para obter mais informações sobre projetos corporativos e como obter os ID de projeto corporativo, consulte Centro Empresarial

    Arquitetura

    No

    Cadeia

    Especifica o tipo de arquitetura de imagem. Os valores disponíveis incluem:

    • x86
    • Arm

    O valor padrão é x86.

    NOTA:

    Se a arquitetura da imagem for ARM, o modo de inicialização é automaticamente alterado para UEFI.
  • Descrição de parâmetros quando um arquivo de imagem carregado no bucket do OBS é usado para criar uma imagem

    Parâmetro

    Obrigatório

    Tipo

    Descrição

    Nome

    SIM

    Cadeia

    Especifica o nome de imagem. Para uma descrição detalhada, consulte Atributos da imagem.

    Descrição

    Não

    Cadeia

    Fornece informações suplementares sobre a imagem. Para uma descrição detalhada, consulte Atributos da imagem. O valor contém um máximo de 1024 caracteres e consiste apenas em letras e dígitos. Não são permitidos retornos de carro e colchetes angulares (< >). Este parâmetro é deixado em branco por padrão.

    os_type

    Não

    Cadeia

    Especifica a versão do SO.

    Quando uma imagem de disco de dados é criada, o valor pode ser Linux ou Windows. O padrão é Linux.

    image_url

    Sim

    Cadeia

    Especifica a URL do arquivo de imagem externo no intervalo do OBS.

    Esse parâmetro é obrigatório se um arquivo de imagem externo no bucket do OBS for usado para criar uma imagem. O formato é nome de bucket do OBS:nome de arquivo de imagem.

    NOTA:

    A classe de armazenamento do bucket do OBS deve ser Standard.

    disco_mínimo

    Sim

    número inteiro

    Especifica o tamanho mínimo do disco do sistema na unidade de GB.

    Esse parâmetro é obrigatório se um arquivo de imagem externo no bucket do OBS for usado para criar uma imagem. O valor varia de 1 a 1024.

    Tags

    Não

    Matriz de strings

    Lista as tags de imagem. Este parâmetro é deixado em branco por padrão.

    Defina tags ou image_tags.

    image_tags

    Não

    Matriz de objetos

    Lista as tags de imagem. O valor é deixado em branco por padrão.

    Defina tags ou image_tags.

    Tipo

    Sim

    Cadeia

    Especifica o tipo de imagem. O valor do parâmetro é DataImage para imagens de disco de dados.

    id_do_projeto_da_empresa

    Não

    Cadeia

    Especifica o projeto da empresa ao qual a imagem pertence.

    • Se o valor for 0 ou deixado em branco, a imagem pertence ao projeto empresarial padrão.
    • Se o valor for um UUID, a imagem pertence ao projeto empresarial correspondente ao UUID.

      Para obter mais informações sobre projetos corporativos e como obter os ID de projeto corporativo, consulte Centro Empresarial
  • Exemplo de solicitações
    • Criando uma imagem de disco do sistema usando um arquivo de imagem externo
      POST https://{Endpoint}/v2/cloudimages/quickimport/action

      Se o parâmetro tags for usado:

       1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
      		 
      {  
    "name": "ims_test_file",  
   "description": "Create an image using a file in the OBS bucket.", 
    "image_url": "ims-image:centos70.zvhd2",  
    "os_version": "CentOS 7.0 64bit",  
    "min_disk": 40,  
    "type": "ECS", 
    "tags":
        [
            "aaa.111",    
            "bbb.333",    
            "ccc.444"    
        ]
}

      Se o parâmetro image_tags for usado:

      1
2
3
4
5
6
7
8
9
      		 
      {  
    "name": "ims_test_file",  
   "description": "Create an image using a file in the OBS bucket.", 
    "image_url": "ims-image:centos70.zvhd2",  
    "os_version": "CentOS 7.0 64bit",  
    "min_disk": 40,  
    "type": "ECS", 
    "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}]  
}
    • Criando uma imagem de disco de dados usando um arquivo de imagem externo
      POST https://{Endpoint}/v2/cloudimages/quickimport/action

      Se o parâmetro tags for usado:

       1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
      		 
      {  
    "name": "ims_test_file",  
   "description": "Create an image using a file in the OBS bucket.", 
    "image_url": "ims-image:centos70.qcow2",  
    "os_type": "Linux",  
    "min_disk": 40,  
    "type": "DataImage",  
    "tags": [    
        "aaa.111",    
        "bbb.333",    
        "ccc.444"    
    ]
}

      Se o parâmetro image_tags for usado:

      1
2
3
4
5
6
7
8
9
      		 
      {  
    "name": "ims_test_file",  
   "description": "Create an image using a file in the OBS bucket.", 
    "image_url": "ims-image:centos70.qcow2",  
    "os_type": "Linux",  
    "min_disk": 40,  
    "type": "DataImage",
    "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}]
}

Resposta

  • Parâmetros de resposta

    Parâmetro

    Tipo

    Descrição

    trabalho_id

    Cadeia

    Especifica a 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": "8a12fc664fb4daa3014fb4e581380005"
}

Valores retornados

  • Normal

    200

  • Anormal

    Valor de retorno

    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 do serviço interno.

    503 Serviço indisponível

    Serviço não está disponível.
Tópico principal: Imagem