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)/ Consulta de detalhes de uma imagem (API OpenStack nativo)

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

Ver PDF

Consulta de detalhes de uma imagem (API OpenStack nativo)

Função

Essa API é usada para consultar detalhes sobre uma imagem pública ou privada.

URI

OBTENHA /v2/images/{image_id}

Tabela 1 lista os parâmetros.

**Tabela 1** Descrição do parâmetro
Parâmetros	Obrigatório	Tipo	Descrição
id_imagem	Sim	Cadeia	Especifica o ID da imagem.

Solicitação

Parâmetros de solicitação
None

Exemplo de solicitação

GET https://{Endpoint}/v2/images/33ad552d-1149-471c-8190-ff6776174a00

Resposta

Parâmetros de resposta

Parâmetro	Tipo	Descrição
Arquivo	Cadeia	Especifica o URL para upload e download do arquivo de imagem.
Proprietário	Cadeia	Especifica o locatário ao qual a imagem pertence.
ID	Cadeia	Especifica o ID da imagem.
Tamanho	Longitude	Este parâmetro não está disponível no momento.
próprio	Cadeia	Especifica o URL da imagem.
Esquema	Cadeia	Especifica o esquema de imagem.
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.
Tags	Matriz de strings	Especifica as tags da imagem, por meio das quais você pode gerenciar imagens privadas de sua própria maneira. Você pode usar a API de tag de imagem para adicionar tags diferentes a cada imagem e filtrar imagens por tag.
Visibilidade	Cadeia	Especifica se a imagem está disponível para outros locatários. Os valores disponíveis incluem: private: imagem privada public: imagem pública shared: imagem compartilhada
Nome	Cadeia	Especifica o nome de imagem. Para uma descrição detalhada, consulte Atributos da imagem.
soma de verificação	Cadeia	Este parâmetro não está disponível no momento.
Protegida	Booleano	Especifica se a imagem está protegida. A imagem protegida não pode ser excluída. O valor pode ser true ou false.
formato_contêiner	Cadeia	Especifica o tipo de contêiner.
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 das especificações do ECS. Geralmente, o valor é 0.
max_ram	Cadeia	Especifica a memória máxima (MB) da imagem. Você pode definir esse parâmetro com base nas especificações do ECS. Geralmente, você não precisa definir esse parâmetro.
atualizado_em	Cadeia	Especifica a hora em que a imagem foi atualizada. O valor está no formato UTC.
__os_bit	Cadeia	Especifica a arquitetura do SO, 32 ou 64 bits.
__os_versão	Cadeia	Especifica a versão do SO.
__descrição	Cadeia	Especifica a descrição da imagem. Para uma descrição detalhada, consulte Atributos da imagem.
formato_do_disco	Cadeia	Especifica o formato da imagem. O valor pode ser vhd, raw, zvhd, ou qcow2. O valor padrão é vhd.
__está cadastrado	Cadeia	Especifica se a imagem foi registrada. O valor pode ser true ou false.
__plataforma	Cadeia	Especifica o tipo de plataforma da imagem. O valor pode ser Windows, Ubuntu, RedHat, SUSE, CentOS, Debian, OpenSUSE, Oracle Linux, Fedora, Other, CoreOS, ou EulerOS.
__os_tipo	Cadeia	Especifica o tipo de OS. O valor pode ser Linux, Windows, ou Other.
__sistema__cmkid	Cadeia	Especifica o ID da chave usada para encriptar a imagem.
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.
tipo_virtual_env	Cadeia	Especifica o ambiente em que a imagem é usada. O valor pode ser FusionCompute, Ironic, DataImage, ou IsoImage. Para uma imagem do ECS (imagem de disco do sistema), o valor é FusionCompute. Para uma imagem de disco de dados, o valor é DataImage. Para uma imagem do BMS, o valor é Ironic. Para uma imagem do ISO, o valor é IsoImage.
__imagem_tipo_fonte	Cadeia	Especifica o armazenamento de back-end da imagem. Somente UDS é suportado atualmente.
__tipo de imagem	Cadeia	Especifica o tipo de imagem. Há suporte para as seguintes funções: Imagem pública: O valor é gold. Imagens privadas O valor é private. Imagem compartilhada: O valor é shared.
criado_em	Cadeia	Especifica a hora em que a imagem foi criada. O valor está no formato UTC.
tamanho_virtual	número inteiro	Este parâmetro não está disponível no momento.
__Nome original de imagem	Cadeia	Especifica o ID da imagem pai. Se a imagem for uma imagem pública ou criada a partir de um arquivo de imagem, esse valor é deixado em branco.
__id_de_backup	Cadeia	Especifica o ID de backup. Para criar uma imagem usando um backup, defina o valor como o ID de backup. Caso contrário, este valor é deixado vazio.
__código do produto	Cadeia	Especifica o ID do produto de uma imagem do Marketplace.
__tamanho_da_imagem	Cadeia	Especifica o tamanho (bytes) do arquivo de imagem. O valor é maior que 0.
__origem_de_dados	Cadeia	Especifica a origem da imagem. Se a imagem é uma imagem pública, este parâmetro é deixado em branco.
__origem_raiz	Cadeia	Especifica que a imagem é criada a partir de um arquivo de imagem externo. Valor: file
__carregamento lento	Cadeia	Especifica se a imagem suporta carregamento lento. O valor pode ser true ou false.
ativo_em	Cadeia	Especifica o horário em que o status da imagem ficou active.
__os_lista_de_características	Cadeia	Especifica atributos adicionais da imagem. O valor é uma lista (em formato JSON) de recursos avançados suportados pela imagem.
__num_sequência	Cadeia	Este parâmetro não está disponível no momento.
__suporte_kvm	Cadeia	Especifica se a imagem suporta KVM. Se sim, o valor é true. Caso contrário, este parâmetro não é necessário.
__suporte_xen	Cadeia	Especifica se a imagem suporta Xen. Se sim, o valor é true. Caso contrário, este parâmetro não é necessário.
__suporte_largememória	Cadeia	Especifica se a imagem suporta os ECS de memória grande. Se a imagem suportar os ECS de memória grande, o valor é true. Caso contrário, este parâmetro não é necessário. Para os SO compatíveis, consulte Os SO suportados por diferentes tipos dos ECS.
__suporte_disco intensivo	Cadeia	Especifica se a imagem oferece suporte aos ECS com uso intenso de disco. Se a imagem suportar os ECS com uso intenso de disco, o valor é true. Caso contrário, este parâmetro não é necessário.
__suporte_alto desempenho	Cadeia	Especifica se a imagem suporta os ECS de alto desempenho. Se a imagem oferecer suporte aos ECS de alto desempenho, o valor é true. Caso contrário, este parâmetro não é necessário.
__suporte_xen_gpu_type	Cadeia	Especifica se a imagem suporta os ECS acelerados por GPU na plataforma Xen. Veja Tabela 2 para cujo valor. Se a imagem não oferecer suporte aos ECS acelerados por GPU na plataforma Xen, esse parâmetro não será necessário. Este parâmetro não pode coexistir com __support_xen ou __support_kvm.
__suporte_kvm_gpu_type	Cadeia	Especifica se a imagem suporta os ECS acelerados por GPU na plataforma KVM. Veja Tabela 3 para cujo valor. Se a imagem não suportar os ECS acelerados por GPU na plataforma KVM, esse parâmetro não é necessário. Este atributo não pode coexistir com __support_xen ou __support_kvm.
__suporte_xen_hana	Cadeia	Especifica se a imagem suporta os ECS HANA na plataforma Xen. Se sim, o valor é true. Caso contrário, este parâmetro não é necessário. Este atributo não pode coexistir com __support_xen ou __support_kvm.
__suporte_kvm_infiniband	Cadeia	Especifica se a imagem suporta os ECS com a NIC InfiniBand na plataforma KVM. Se sim, o valor é true. Caso contrário, este parâmetro não é necessário. Este atributo não pode coexistir com __support_xen.
__suporte_fc_inject	Cadeia	Especifica se a imagem suporta injeção de senha/chave privada usando o Cloud-Init. O valor do parâmetro pode ser true ou false. Se o valor for definido como true, a injeção de senha/chave privada usando o Cloud-Init não é suportada. NOTA: Esse parâmetro é válido somente para imagens de disco do sistema ECS.
id_do_projeto_da_empresa	Cadeia	Especifica o projeto empresarial 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
__é_offshelved	Cadeia	Especifica se a imagem do Marketplace foi desativada. true: A imagem foi desativada. false: A imagem não foi desativada.
hw_firmware_type	Cadeia	Especifica o modo de inicialização do ECS. Os valores disponíveis incluem: bios indica o modo de inicialização do BIOS. uefi indica o modo de inicialização UEFI.
hw_vif_ativado_multifila	Cadeia	Especifica se a imagem suporta multifila NIC. O valor pode ser true ou false.
__código_da_conta	Cadeia	Especifica o identificador de cobrança para a imagem.
__localização_da_imagem	Cadeia	Especifica o local onde a imagem é armazenada.
__is_config_init	Cadeia	Especifica se a configuração inicial está concluída. O valor pode ser true ou false.
__apoio_amd	Cadeia	Especifica se a imagem usa a arquitetura x86 da AMD. O valor pode ser true ou false.

Exemplo de resposta

CÓDIGO DE STATUS 200

      
       
         
         
           {
      "schema": "/v2/schemas/image",
      "min_disk": 100,
      "created_at": "2018-09-06T14:03:27Z",
      "__image_source_type": "uds",
      "container_format": "bare",
      "file": "/v2/images/bc6bed6e-ba3a-4447-afcc-449174a3eb52/file",
      "updated_at": "2018-09-06T15:17:33Z",
      "protected": true,
      "checksum": "d41d8cd98f00b204e9800998ecf8427e",
      "__support_kvm_fpga_type": "VU9P",
      "id": "bc6bed6e-ba3a-4447-afcc-449174a3eb52",
      "__isregistered": "true",
      "min_ram": 2048,
      "__lazyloading": "true",
      "owner": "1bed856811654c1cb661a6ca845ebc77",
      "__os_type": "Linux",
      "__imagetype": "gold",
      "visibility": "public",
      "virtual_env_type": "FusionCompute",
      "tags": [],
      "__platform": "CentOS",
      "size": 0,
      "__os_bit": "64",
      "__os_version": "CentOS 7.3 64bit",
      "name": "CentOS 7.3 64bit vivado",
      "self": "/v2/images/bc6bed6e-ba3a-4447-afcc-449174a3eb52",
      "disk_format": "zvhd2",
      "virtual_size": null,
      "status": "active"
}

          

        

      
     

Valores retornados

Normal
200

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.