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/ Elastic Cloud Server/ Referência de API/ As API desatualizadas/ Gerenciamento de imagem (as API de Nova de OpenStack)/ Consulta de Imagens (Descartado)

Atualizado em 2025-08-25 GMT+08:00

Ver PDF

Consulta de Imagens (Descartado)

Função

Essa API é usada para consultar todas as imagens.

Esta API foi descartada. Use a API descrita em Consulta de imagens (API OpenStack nativo).

URI

GET /v2.1/{project_id}/images?name={name}&status={status}&changes-since={changes-since}&minRam={minRam}&minDisk={inDisk}

Tabela 1 descreve os parâmetros no URI.

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Descrição
project_id	Sim	Especifica a ID do projeto. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto.

A consulta de paginação é suportada. Para mais detalhes, consulte Consulta de dados em páginas.

Os parâmetros na tabela a seguir podem ser usados como parâmetros URI para filtrar os resultados da consulta. Uso: /v2/{project_id}/images? name ={name}&status={status}

Tabela 2 descreve os parâmetros de solicitação.

**Tabela 2** Parâmetros de consulta
Parâmetro	Obrigatório	Tipo	Descrição
name	Não	String	Especifica o nome de imagem.
status	Não	String	Especifica a tag de imagem. Não é possível consultar imagens quando o valor está definido como deleted. O valor depende do status em Glance. Tabela 3 mostra a relação de mapeamento do status da imagem em Nova e Glance.
changes-since	Não	String	Especifica as imagens modificadas após o ponto de tempo changes-since. O parâmetro está no formato de hora ISO 8601, por exemplo, 2013-06-09T06:42:18Z.
minRam	Não	Integer	Especifica o tamanho mínimo de memória em MB exigido pela imagem.
minDisk	Não	Integer	Especifica o tamanho mínimo do disco em GB exigido pela imagem.

**Tabela 3** Mapeando a relação do status da imagem no Nova e no Glance
Status da imagem em Glance	Status da imagem em Nova
queued	saving
saving	saving
active	active
deleted	deleted

Solicitação

Nenhum

Resposta

Tabela 4 descreve os parâmetros de resposta.

**Tabela 4** Parâmetros de resposta
Parâmetro	Obrigatório	Tipo	Descrição
images	Sim	Array of objects	Especifica as informações da imagem.
images_links	Não	Array of objects	Especifica as informações sobre a próxima página quando você consulta imagens em páginas.

**Tabela 5** informações da **images**
Parâmetro	Obrigatório	Tipo	Descrição
id	Sim	String	Especifica a ID da imagem no formato UUID.
links	Sim	Array of objects	Especifica o link de atalho da imagem.
name	Sim	String	Especifica o nome de imagem.

**Tabela 6** parâmetros **images_links**
Parâmetro	Obrigatório	Tipo	Descrição
href	Sim	String	Especifica o URL da próxima página quando você consulta imagens em páginas.
rel	Sim	String	Especifica a direção da consulta quando você consulta imagens em páginas.

**Tabela 7** descrição do parâmetro **links**
Parâmetro	Obrigatório	Tipo	Descrição
href	Sim	String	Especifica o link do recurso correspondente.
rel	Sim	String	O valor pode ser: self: Um auto link contém um link de versão para o recurso. Use esses links quando o link for seguido imediatamente. bookmark: Um link de favorito fornece um link permanente para um recurso, que é adequado para armazenamento de longo prazo. alternate: Um link alternativo pode conter uma representação alternativa do recurso. Por exemplo, uma imagem de computação OpenStack pode ter uma representação alternativa no serviço de imagem OpenStack.
type	Não	String	O atributo type fornece uma dica sobre o tipo de representação a ser esperado ao seguir o link.

Exemplo de solicitação

GET https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/images

Exemplo de resposta

{
    "images": [
        {
            "id": "ee10f19c-503c-44af-af2f-73d5e42f7a17",
            "links": [
                {
                    "href": "http://xxx/v2/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17",
                    "rel": "self"
                },
                {
                    "href": "http://xxx/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17",
                    "rel": "bookmark"
                },
                {
                    "href": "http://xxx/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17",
                    "rel": "alternate",
                    "type": "application/vnd.openstack.image"
                }
            ],
            "name": "image1"
        }
    ]
}