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)> Criação de metadados de imagem (API OpenStack nativo)

Atualizado em 2022-11-16 GMT+08:00

Ver PDF

Criação de metadados de imagem (API OpenStack nativo)

Função

Essa API é usada para criar metadados de imagens.

Depois que a API é invocada com sucesso, os metadados da imagem são criados, mas o arquivo de imagem ainda não existe.

URI

POST /v2/images

Solicitação

Parâmetros de solicitação

Parâmetro	Obrigatório	Tipo	Descrição
__os_versão	Não	Cadeia	Especifica a versão do SO da imagem. Para o intervalo de valores, veja Valores de parâmetros relacionados. Se este parâmetro não for especificado, o valor Other Linux(64 bit) será usado. Nesse caso, a criação do ECS usando essa imagem pode falhar e o ECS criado usando essa imagem pode não ser executado corretamente.
Visibilidade	Não	Cadeia	Especifica se a imagem está disponível para outros locatários. O valor padrão é private. Ao criar metadados de imagem, o valor de visibility pode ser definido apenas como private.
Nome	Não	Cadeia	Especifica o nome de imagem. Se este parâmetro não for especificado, seu valor estará vazio por padrão. Nesse caso, a criação do ECS usando essa imagem falhará. O nome contém de 1 a 255 caracteres. Para uma descrição detalhada, consulte Atributos da imagem. Este parâmetro é deixado em branco por padrão.
Protegida	Não	Booleano	Especifica se a imagem está protegida. A imagem protegida não pode ser excluída. O valor padrão é false.
formato_contêiner	Não	Cadeia	Especifica o formato do contêiner. O valor padrão é bare.
formato_do_disco	Não	Cadeia	Especifica o formato do arquivo de imagem. O valor pode ser vhd, zvhd, raw, zvhd2, ou qcow2. O valor padrão é vhd.
Tags	Não	Matriz de strings	Lista as tags de imagem. A tag contém de 1 a 255 caracteres. O valor é deixado em branco por padrão.
min_ram	Não	número inteiro	Especifica o tamanho mínimo de memória (MB) necessário para executar a imagem. O valor do parâmetro depende das especificações do ECS. O valor padrão é 0.
disco_mínimo	Não	número inteiro	Especifica o espaço mínimo em disco (GB) necessário para executar a imagem. O valor varia de 40 GB a 255 GB. O valor desse parâmetro deve ser maior que a capacidade do disco do sistema de imagem. Caso contrário, a criação do ECS pode falhar.

Os parâmetros no corpo da solicitação são cadeias de caracteres de no máximo 255 caracteres, e seus valores podem ser deixados em branco. Exemplo:

"key": "value"

Exemplo de solicitação

POST https://{Endpoint}/v2/images

{
    "__os_version": "Ubuntu 14.04 server 64bit",
    "container_format": "bare",
    "disk_format": "vhd",
    "min_disk": 1,
    "min_ram": 1024,
    "name": "test",
    "tags": [
        "test",
        "image"
    ],
    "visibility": "private",
    "protected": false
}

Resposta

Parâmetros de resposta

Parâmetro	Tipo	Descrição
Visibilidade	Cadeia	Especifica se a imagem está disponível para outros locatários. O valor é private.
Nome	Cadeia	Especifica o nome de imagem. Se este parâmetro não for especificado, seu valor estará vazio por padrão. Nesse caso, a criação do ECS usando essa imagem falhará. O nome contém 4 a 128 caracteres. Para uma descrição detalhada, consulte Atributos da imagem.
Protegida	Booleano	Especifica se a imagem está protegida. A imagem protegida não pode ser excluída. O valor é false.
formato_contêiner	Cadeiac	Especifica o formato do contêiner. O valor é bare.
formato_do_disco	Cadeia	Especifica o formato do arquivo de imagem. O valor pode ser vhd, zvhd, raw, ou qcow2. O valor padrão é vhd.
Tags	Matriz de strings	Lista as tags de imagem. A tag contém de 1 a 255 caracteres.
min_ram	número inteiro	Especifica o tamanho mínimo de memória (MB) necessário para executar a imagem. O valor do parâmetro depende do limite de especificações do ECS. O valor é geralmente definido como 0.
disco_mínimo	número inteiro	Especifica o espaço mínimo em disco (GB) necessário para executar a imagem. O valor varia de 40 GB a 255 GB. Deve ser maior que a capacidade do disco do sistema na imagem. Caso contrário, a criação do ECS pode falhar.
estado	Cadeia	Especifica a tag de imagem. O valor pode ser um dos seguintes: queued: indica que os metadados da imagem já foram criados e que estão prontos para o upload do arquivo de imagem. saving: indica que o arquivo de imagem está sendo carregado para o armazenamento de backend. deleted: indica que a imagem foi excluída. killed: indica que ocorre um erro no upload da imagem. active: indica que a imagem está disponível para uso.
criado_em	Cadeia	Especifica a hora em que a imagem foi criada. O valor está no formato UTC.
atualizado_em	Cadeia	Especifica a hora em que a imagem foi atualizada. O valor está no formato UTC.
próprio	Cadeia	Especifica o URL da imagem.
ID	Cadeia	Especifica o ID da imagem. Depois que a API de criação de imagem for chamada, o ID da imagem deve ser salvo. O ID da imagem é usado para chamar a API de upload de imagens e fazer o upload da imagem.
Arquivo	Cadeia	Especifica a URL para upload e download do arquivo de imagem.
Esquema	Cadeia	Especifica a URL para acessar o esquema.
__imagem_tipo_fonte	Cadeia	Especifica o tipo de armazenamento de backend da imagem. Somente UDS é suportado atualmente.
__tamanho_da_imagem	Cadeia	Especifica o tamanho da imagem. A unidade é byte.
__está cadastrado	Cadeia	Especifica se a imagem está registrada. Somente imagens cadastradas podem ser consultadas no portal. O valor é true.
__os_versão	Cadeia	Especifica a versão do SO da imagem. Para o intervalo de valores, veja Valores de parâmetros relacionados.
__os_tipo	Cadeia	Especifica o tipo de imagem. O valor deste parâmetro depende do valor de __os_version. O valor pode ser Windows, Linux, ou other.
__plataforma	Cadeia	Especifica a plataforma de SO suportada pela imagem. O valor deste parâmetro depende do valor de __os_version.
__os_bit	Cadeia	Especifica o bit do SO. O valor deste parâmetro depende do valor de __os_version. O valor pode ser 32 ou 64.
__tipo de imagem	Cadeia	Especifica o tipo de imagem. Private indica uma imagem privada.
tipo_virtual_env	Cadeia	Especifica o tipo de plataforma. Especifica o ambiente em que a imagem é usada. O valor pode ser FusionCompute, Ironic, DataImage, ou IsoImage. Para uma imagem do ECS, o valor é FusionCompute. Para uma imagem de disco de dados, o valor é DataImage. Para uma imagem do ECS, o valor é Ironic. Para uma imagem ISO, o valor é IsoImage.
Proprietário	Cadeia	Especifica o ID do projeto ao qual a imagem pertence.
__origem_raiz	Cadeia	Especifica que a imagem é criada a partir de um arquivo de imagem externo. Valor: file
soma de verificação	Cadeia	Especifica o valor MD5 do arquivo de imagem.
Tamanho	Longitude	Este parâmetro não está disponível no momento.
tamanho_virtual	número inteiro	Especifica o tamanho virtual da imagem. A unidade é byte.
Propriedades	Properties object	Especifica uma coleção de atributos de imagem em vez de um atributo especificado.

Exemplo de resposta

STATUS CODE 201

{
    "schema": "/v2/schemas/image",
    "min_disk": 1,
    "created_at": "2016-06-02T07:49:48Z",
    "__image_source_type": "uds",
    "container_format": "bare",
    "__image_size": "0",
    "file": "/v2/images/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba86/file",
    "updated_at": "2016-06-02T07:49:49Z",
    "protected": false,
    "id": "4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba86",
    "__isregistered": "true",
    "min_ram": 1024,
    "owner": "b912fb4a4c464b568ecfca1071b21b10",
    "__os_type": "Linux",
    "__imagetype": "private",
    "visibility": "private",
    "virtual_env_type": "FusionCompute",
    "tags": [
        "test",
        "image"
    ],
    "__platform": "Ubuntu",
    "__os_bit": "64",
    "__os_version": "Ubuntu 14.04 server 64bit",
    "name": "test",
    "self": "/v2/images/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba86",
    "disk_format": "vhd",
    "status": "queued"
}

Valores retornados

Normal
201

Anormal

Valor retornado	Descrição
400 Solicitação inválida	Erro na solicitação.
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.