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}
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.
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. |
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.
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. |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
href |
Sim |
String |
Especifica o link do recurso correspondente. |
rel |
Sim |
String |
O valor pode ser:
|
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" } }