Criação de uma imagem de disco de dados com uso de um arquivo de imagem externo

Função

Essa API é usada para criar uma imagem de disco de dados a partir de um arquivo de imagem de disco de dados carregado no bucket do OBS. 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.

URI

POST /v1/cloudimages/dataimages/action

Solicitação

• Parâmetros de solicitação

  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	No	String	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	No	Cadeia	Especifica o tipo de OS. Só pode ser Windows ou Linux. O padrão é Linux.
  image_url	Sim	Cadeia	Especifica a URL do arquivo de imagem externo no intervalo do OBS. O formato é Nome do bucket do OBS:Nome do arquivo da 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 de dados. Intervalo de valor: 40 GB a 2048 GB
  cmk_id	Não	Cadeia	Especifica a chave mestra usada para encriptar uma imagem. Para obter seu valor, consulte o Guia de usuário do Key Management Service.
  Tags	Não	Matriz de strings	Especifica marcas de imagem. Este parâmetro é deixado em branco por padrão. Para obter uma descrição detalhada do parâmetro, consulte Formatos de dados da tag de imagem. Use tags ou image_tags.
  image_tags	Não	Array of ImageTag objects	Lista as tags de imagem. Este parâmetro é deixado em branco por padrão. Use tags ou image_tags.
  id_do_projeto_da_empresa	Não	Cadeia	Especifica o projeto empresarial ao qual a imagem pertence. Se o valor for 0 ou deixado em branco, a imagem pertence ao projeto corporativo 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

  Tabela 1 Descrição da estrutura de dados do campo image_tags

  Parâmetro	Obrigatório	Tipo	Descrição
  chave	Não	Cadeia	Especifica a chave de marcação.
  Valor	Não	Cadeia	Especifica o valor da tag.

• Exemplo de solicitações
  • Pedido de criação de uma imagem (tags)

    POST https://{Endpoint}/v1/cloudimages/dataimages/action

    1 2 3 4 5 6 7 8 9 10 11

    { "name": "fedora-data1", "image_url": "image-test:fedora_data1.qcow2", "description":"Data disk 1 of Fedora", "min_disk": 40, "tags": [ "aaa.111", "bbb.222" ], "os_type": "Linux" }

  • Pedido de criação de uma imagem (image_tags)

    POST https://{Endpoint}/v1/cloudimages/dataimages/action

    1 2 3 4 5 6 7 8

    { "name": "fedora-data2", "image_url": "image-test:fedora_data1.qcow2", "description":"Data disk 2 of Fedora", "min_disk": 40, "image_tags": [{"key":"aaa","value":"111"},{"key":"bbb","value":"222"}], "os_type": "Linux" }

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": "4010a32b5f909853015f90aaa24b0015" }

Valor retornado

• Normal

  200

• 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 do serviço interno.
  503 Serviço indisponível	Serviço não está disponível.