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}
| 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. |
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.
| 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. |
| 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 | 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. |
| 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. |
| 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 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"
}
]
}
