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.

Centro de ayuda> Elastic Cloud Server> Referencia de la API> API fuera de fecha> Gestión de imágenes (API de OpenStack Nova)> Consulta de detalles de imagen (descartada)

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	Sí	String	Especifica el enlace del recurso correspondiente.
rel	Sí	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"
    }
}