Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Actualización más reciente 2022-11-08 GMT+08:00

Consulta de detalles de imagen (descartada)

Función

Esta API se utiliza para consultar información detallada sobre una lista de imágenes.

Esta API ha sido descartada. Utilice la API descrita en Consulta de imágenes (API nativa de OpenStack).

URI

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

Tabla 1 describe los parámetros en el URI.
Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Descripción

project_id

Yes

Especifica el ID del proyecto.

Para obtener más información sobre cómo obtener el ID, consulte Obtención de un ID de proyecto.

Se admite la consulta de paginación. Para más detalles, consulte Consulta de datos en páginas.

Los parámetros de la siguiente tabla se pueden utilizar como parámetros URI para filtrar los resultados de la consulta.Usage: /v2/{tenant_id}/images/detail? name ={name}&status={status}

Tabla 2 describe los parámetros de consulta.

Tabla 2 Parámetros de consulta

Parámetro

Obligatorio

Tipo

Descripción

name

No

String

Especifica el nombre de la imagen.

status

No

String

Especifica el estado de la imagen.

No se pueden consultar imágenes cuando el valor está definido como deleted. El valor depende del estado de Glance. Tabla 3 muestra la relación de asignación del estado de la imagen en Nova y Glance.

changes-since

No

String

Especifica las imágenes modificadas después del punto temporal changes-since. El valor está en formato ISO8601, como 2013-06-09T06:42:18Z.

minRam

No

Integer

Especifica el tamaño mínimo de memoria en MB requerido por la imagen.

minDisk

No

Integer

Especifica el tamaño mínimo de disco en GB requerido por la imagen.

Tabla 3 Relación de mapas del estado de la imagen en Nova y Glance

Estado de la imagen en Glance

Estado de la imagen en Nova

queued

saving

saving

saving

active

active

deleted

deleted

Solicitud

No hay

Respuesta

Tabla 4 describe los parámetros de respuesta.

Tabla 4 Parámetros de respuesta

Parámetro

Tipo

Descripción

id

String

Especifica el ID de imagen en formato UUID.

links

Array of objects

Especifica el enlace de acceso directo de la imagen.

name

String

Especifica el nombre de la imagen.

metadata

Object

Especifica el par de claves de los metadatos.

OS-EXT-IMG-SIZE:size

Integer

Especifica el tamaño de la imagen.

El valor debe ser mayor que cero.

minDisk

Integer

Especifica el tamaño mínimo de disco en GB requerido por la imagen.

El valor debe ser mayor que cero.

minRam

Integer

Especifica el tamaño mínimo de memoria en GB requerido por la imagen.

El valor debe ser mayor que cero.

progress

Integer

Especifica el progreso de la carga de la imagen.

El valor debe ser mayor que cero.

status

String

Especifica el estado de la imagen.

created

String

Especifica el tiempo de creación de la imagen.

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

updated

String

Especifica el tiempo de actualización de la imagen.

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

Tabla 5 Descripción del parámetro links

Parámetro

Obligatorio

Tipo

Descripción

href

String

Especifica el enlace del recurso correspondiente.

rel

String

El valor puede ser:

  • self: Un enlace propio contiene un enlace de versión al recurso. Utilice estos enlaces cuando el enlace se siga inmediatamente.
  • bookmark: Un enlace de marcador proporciona un enlace permanente a un recurso, que es adecuado para el almacenamiento a largo plazo.
  • alternate: un enlace alternativo puede contener una representación alternativa del recurso. Por ejemplo, una imagen de OpenStack Compute puede tener una representación alternativa en el servicio de imagen OpenStack.

Tipo

No

String

El atributo de tipo proporciona una sugerencia sobre el tipo de representación que se debe esperar al seguir el enlace.

Ejemplo de la solicitud

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

Ejemplo de la respuesta

{
    "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"
    }
}