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.
Atualizado em 2022-11-08 GMT+08:00

Consulta de detalhes da imagem (Descartado)

Função

Essa API é usada para consultar informações detalhadas sobre uma lista de imagens.

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

URI

GET /v2.1/{project_id}/images/detail?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/{tenant_id}/images/detail? 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 valor está no formato ISO8601, como 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

Tipo

Descrição

id

String

Especifica a ID da imagem no formato UUID.

links

Array of objects

Especifica o link de atalho da imagem.

name

String

Especifica o nome de imagem.

metadata

Object

Especifica o par de chaves dos metadados.

OS-EXT-IMG-SIZE:size

Integer

Especifica o tamanho da imagem.

O valor deve ser maior que zero.

minDisk

Integer

Especifica o tamanho mínimo de disco em GB exigido pela imagem.

O valor deve ser maior que zero.

minRam

Integer

Especifica o tamanho mínimo de memória em GB exigido pela imagem.

O valor deve ser maior que zero.

progress

Integer

Especifica o andamento do upload da imagem.

O valor deve ser maior que zero.

status

String

Especifica a tag de imagem.

created

String

Especifica a hora de criação da imagem.

O valor está no formato ISO8601, como 2013-06-09T06:42:18Z.

updated

String

Especifica a hora de atualização da imagem.

O valor está no formato ISO8601, como 2013-06-09T06:42:18Z.

Tabela 5 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/detail

Exemplo de resposta

{
    "image": {
        "OS-EXT-IMG-SIZE:size": 20578304,
        "created": "2014-02-10T17:05:01Z",
        "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"
            }
        ],
        "metadata": {
            "clean_attempts": "3",
            "image_location": "snapshot",
            "image_state": "available",
            "image_type": "snapshot",
            "instance_type_ephemeral_gb": "0",
            "instance_type_flavorid": "6",
            "instance_type_id": "7",
            "instance_type_memory_mb": "256",
            "instance_type_name": "wj.ssd",
            "instance_type_root_gb": "2",
            "instance_type_rxtx_factor": "1.0",
            "instance_type_swap": "0",
            "instance_type_vcpus": "1",
            "instance_uuid": "b600b5b1-ed8c-4814-aefa-8b903c894c20",
            "os_type": "None",
            "owner_id": "d9ebe43510414ef590a4aa158605329e",
            "user_id": "74fe4ff0674b434b8a274077d8106c5b"
        },
        "minDisk": 2,
        "minRam": 0,
        "name": "image1",
        "progress": 100,
        "server": {
            "id": "b600b5b1-ed8c-4814-aefa-8b903c894c20",
            "links": [
                {
                    "href": "http://xxx/v2/d9ebe43510414ef590a4aa158605329e/servers/b600b5b1-ed8c-4814-aefa-8b903c894c20",
                    "rel": "self"
                },
                {
                    "href": "http://xxx/d9ebe43510414ef590a4aa158605329e/servers/b600b5b1-ed8c-4814-aefa-8b903c894c20",
                    "rel": "bookmark"
                }
            ]
        },
        "status": "ACTIVE",
        "updated": "2014-02-10T17:05:07Z"
    }
}

Valores retornados

Consulte Valores retornados para solicitações gerais.