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.

En esta página

Mostrar todo

Centro de ayuda/ Image Management Service/ Referencia de la API/ Las API de Native OpenStack/ Imagen (Native OpenStack APIs)/ Consulta de imágenes (API de OpenStack nativo)

Consulta de imágenes (API de OpenStack nativo)

Actualización más reciente 2025-02-26 GMT+08:00

Ver PDF

Función

Esta API se utiliza para obtener la lista de imágenes.

Esta API no devuelve el resultado completo a la vez, pero usa paginación.

NOTA:

Ya no se pueden consultar imágenes de Windows.

Paginación

Paginación se refiere a la función de devolver un subconjunto de un grupo de imágenes, un enlace para obtener el siguiente conjunto de imágenes, y un enlace del conjunto de imágenes. De forma predeterminada, un conjunto contiene 25 imágenes. También puede utilizar los parámetros limit y marker para paginar a través de imágenes manualmente y especificar el número de imágenes que se pueden devolver.

El parámetro first en la respuesta indica la URL de la primera página de imágenes, y el parámetro next indica la URL de la siguiente página de imágenes. Cuando se consulta la última página de imágenes, no hay ningún parámetro next.

URI

GET /v2/images

NOTA:

Puede escribir un signo de interrogación (?) y un ampersand (&) al final del URI para definir varios criterios de búsqueda. Para obtener más información, consulte la solicitud de ejemplo.
Si necesita la API de la versión OpenStack de Queens, el encabezado de solicitud debe contener X-Api-Version. Si el valor de X-Api-Version es cualquier letra después de M en el alfabeto, se devuelve la API de la versión de Queens. Si el valor es M o una letra anterior a M, se devuelve la API de la versión Mitaka.

Tabla 1 enumera los parámetros del URI.

**Tabla 1** Descripción de parámetros
Parámetro	Obligatorio	Tipo	Descripción
__isregistered	No	String	Especifica si la imagen está disponible. El valor puede ser true. El valor es true para todas las API de extensión de forma predeterminada. Los usuarios comunes solo pueden consultar las imágenes para las que el valor de este parámetro es true.
__imagetype	No	String	Especifica el tipo de imagen. Se admiten los siguientes tipos: Imagen pública: El valor es gold. Imagen privada: El valor es private. Imagen compartida: El valor es shared. Imagen de Marketplace: El valor es market.
protected	No	Boolean	Especifica si la imagen está protegida. El valor es true o false. Establezca el valor de true cuando consulte imágenes públicas. Este parámetro es opcional cuando consulta imágenes privadas.
visibility	No	String	Especifica si la imagen está disponible para otros tenants. Los valores disponibles incluyen: public: imagen pública private: imagen privada shared: imagen compartida
owner	No	String	Especifica el tenant al que pertenece la imagen.
id	No	String	Especifica el ID de imagen.
status	No	String	Especifica el estado de la imagen. El valor puede ser uno de los siguientes: queued: indica que los metadatos de la imagen ya han sido creados, y que está listo para que el archivo de imagen se cargue. saving: indica que el archivo de imagen se está cargando en el almacenamiento de backend. deleted: indica que la imagen ha sido borrada. killed: indica que se produce un error al cargar la imagen. active: indica que la imagen está disponible para su uso.
name	No	String	Especifica el nombre de la imagen. Se utiliza la coincidencia exacta. Para una descripción detallada, consulte Atributos de imagen.
container_format	No	String	Especifica el tipo de contenedor. The default value is bare.
disk_format	No	String	Especifica el formato de imagen. El valor puede ser zvhd2, vhd, zvhd, raw, iso o qcow2. El valor predeterminado es zvhd2 para una imagen no ISO.
min_ram	No	Integer	Especifica el tamaño mínimo de memoria (MB) necesario para ejecutar la imagen. El valor del parámetro depende de las especificaciones del . Generalmente, el valor es 0.
min_disk	No	Integer	Especifica el espacio mínimo en disco (GB) necesario para ejecutar la imagen. El valor oscila entre 40 GB y 255 GB.
__os_bit	No	String	Especifica la arquitectura del sistema operativo, de 32 bits o 64 bits.
__platform	No	String	Especifica el tipo de plataforma de imagen. El valor puede ser Windows, Ubuntu, Red Hat, SUSE, CentOS, Debian, OpenSUSE, Oracle Linux, Fedora, Other, CoreOS o EulerOS.
marker	No	String	Especifica el número inicial desde el que se consultan las imágenes. El valor es el ID de la imagen.
limit	No	Integer	Especifica el número de imágenes que se van a consultar. El valor es un entero. De forma predeterminada, se pueden consultar 25 imágenes.
sort_key	No	String	Especifica el campo para ordenar los resultados de la consulta. El valor puede ser un atributo de la imagen: name, container_format, disk_format, status, id, size, o created_at. El valor predeterminado es create_at.
sort_dir	No	String	Especifica si los resultados de la consulta se ordenan en orden ascendente o descendente. Su valor puede ser desc (predeterminado) o asc. Este parámetro se utiliza junto con el parámetro sort_key. El valor predeterminado es desc.
__os_type	No	String	Especifica el tipo de sistema operativo de imagen. El valor puede ser Linux, Windows, u Other.
tag	No	String	Especifica una etiqueta agregada a una imagen. Las etiquetas se pueden utilizar como filtro para consultar imágenes. NOTA: Se ha actualizado la función de etiquetado. Si las etiquetas añadidas antes de la actualización de la función tienen el formato de "Key.Value", consulte las etiquetas de utilizando "Key=Value". Por ejemplo, una etiqueta existente es a.b. Después de la actualización de la función de etiqueta, consulte la etiqueta usando "tag=a=b".
member_status	No	String	Especifica el estado del miembro. El valor puede ser accepted, rejected, o pending. accepted: indica que la imagen compartida es aceptada. rejected indica que la imagen compartida por otros es rechazada. pending indica que la imagen compartida por otros necesita ser confirmada. Para utilizar este parámetro, establezca visibility en shared durante la consulta.
__support_kvm	No	String	Especifica si la imagen admite KVM. En caso afirmativo, el valor es true. De lo contrario, este parámetro no es necesario.
__support_xen	No	String	Especifica si la imagen admite Xen. En caso afirmativo, el valor es true. De lo contrario, este parámetro no es necesario.
__support_largememory	No	String	Especifica si la imagen admite ECS de memoria grande. Si la imagen admite ECS de memoria grande, el valor es true. De lo contrario, este parámetro no es necesario.
__support_diskintensive	No	String	Especifica si la imagen admite ECS con uso intensivo de disco. Si la imagen admite ECS con uso intensivo de disco, el valor es true. De lo contrario, este parámetro no es necesario.
__support_highperformance	No	String	Especifica si la imagen admite ECS de alto rendimiento. Si la imagen admite ECS de alto rendimiento, el valor es true. De lo contrario, este parámetro no es necesario.
__support_xen_gpu_type	No	String	Especifica si la imagen admite ECS acelerados por GPU en la plataforma Xen. Para obtener más información sobre los sistemas operativos de imágenes compatibles con los ECS acelerados por GPU, consulte Tabla 2. Si la imagen no admite ECS acelerados por GPU en la plataforma Xen, este parámetro no es necesario. Este atributo no puede coexistir con __support_xen y __support_kvm.
__support_kvm_gpu_type	No	String	Especifica si la imagen admite ECS acelerados por GPU en la plataforma KVM. Consulte Tabla 3 por su valor. Si la imagen no admite ECS acelerados por GPU en la plataforma KVM, este parámetro no es necesario. Este atributo no puede coexistir con __support_xen y __support_kvm.
__support_xen_hana	No	String	Especifica si la imagen admite los ECS de HANA en la plataforma Xen. En caso afirmativo, el valor es true. De lo contrario, este parámetro no es necesario. Este atributo no puede coexistir con __support_xen y __support_kvm.
__support_kvm_infiniband	No	String	Especifica si la imagen admite los ECS con las NIC de InfiniBand en la plataforma KVM. En caso afirmativo, el valor es true. De lo contrario, este parámetro no es necesario. Este atributo no puede coexistir con __support_xen.
created_at	No	String	Especifica la hora en que se creó la imagen. Las imágenes se pueden consultar por tiempo. El valor tiene el formato de Operator:UTC time. Se admiten los siguientes operadores: gt: mayor que gte: mayor o igual que lt: menor que lte: menor o igual que eq: igual que neq: no es igual que El formato de hora es yyyy-MM-ddThh:mm:ssZ o yyyy-MM-dd hh:mm:ss. Por ejemplo, para consultar imágenes creadas antes del 28 de octubre de 2018 10:00:00, establezca el valor de create_at en lt:2018-10-28T10:00:00Z.
updated_at	No	String	Especifica la hora a la que se modificó la imagen. Las imágenes se pueden consultar por tiempo. El valor tiene el formato de Operator:UTC time. Se admiten los siguientes operadores: gt: mayor que gte: mayor o igual que lt: menor que lte: menor o igual que eq: igual que neq: no es igual que El formato de hora es yyyy-MM-ddThh:mm:ssZ o yyyy-MM-dd hh:mm:ss. Por ejemplo, para consultar imágenes actualizadas antes del 28 de octubre de 2018 10:00:00, establezca el valor de update_at en lt:2018-10-28T10:00:00Z.

Solicitud

Parámetros de solicitud

Ninguna

Ejemplo de solicitud

Consulta de imágenes

GET https://{Endpoint}/v2/images

Respuesta

Parámetros de respuesta

Parámetro	Tipo	Descripción
first	String	Especifica la dirección URL de la primera página de las imágenes.
next	String	Especifica la dirección URL de la página siguiente de las imágenes. Cuando se consulta la última página de imágenes, no hay ningún parámetro next.
schema	String	Especifica la dirección URL del esquema que describe una lista de imágenes.
images	Array of objects	Especifica el tipo de recurso. Para obtener más información, véase Tabla 2.

**Tabla 2** Descripción de la estructura de datos del campo de imágenes
Parámetro	Tipo	Descripción
__backup_id	String	Especifica el ID de copia de respaldo. Si la imagen se crea a partir de una copia de respaldo, establezca el valor en el ID de copia de respaldo. De lo contrario, este parámetro no es necesario.
__data_origin	String	Especifica el origen de la imagen. Si la imagen es una imagen pública, el valor se deja vacío.
__description	String	Especifica la descripción de la imagen.
__image_location	String	Especifica la ubicación en la que se almacena la imagen.
__image_size	String	Especifica el tamaño (bytes) del archivo de imagen. El valor es mayor que 0.
__image_source_type	String	Especifica el almacenamiento de backend de la imagen. Actualmente solo se admite UDS.
__is_config_init	String	Especifica si se ha completado la configuración inicial. El valor puede ser true o false.
__isregistered	String	Especifica si la imagen está disponible. El valor puede ser true. El valor es true para todas las API de extensión de forma predeterminada. Los usuarios comunes solo pueden consultar las imágenes para las que el valor de este parámetro es true.
__lazyloading	String	Especifica si la imagen admite la carga lenta. El valor puede ser true, false, True o False.
__originalimagename	String	Especifica el ID de la imagen principal. Si la imagen es una imagen pública o creada a partir de un archivo de imagen, el valor se deja vacío.
__imagetype	String	Especifica el tipo de imagen. Se admiten los siguientes tipos: Imagen pública: El valor es gold. Imagen privada: El valor es private. Imagen compartida: El valor es shared. Imagen de Marketplace: El valor es market.
protected	Boolean	Especifica si la imagen está protegida. Establezca el valor de true cuando consulte imágenes públicas. Este parámetro es opcional cuando consulta imágenes privadas.
virtual_env_type	String	Especifica el entorno en el que se utiliza la imagen. El valor puede ser FusionCompute, Ironic, DataImage, o IsoImage. Para una imagen de (imagen de disco del sistema), el valor es FusionCompute. Para una imagen de disco de datos, el valor es DataImage. Para una imagen de , el valor es Ironic. Para una imagen ISO, el valor es IsoImage.
virtual_size	Integer	Este parámetro no está disponible actualmente.
visibility	String	Especifica si la imagen está disponible para otros tenants. El valor puede ser uno de los siguientes: public: imagen pública private: imagen privada shared: imagen compartida
owner	String	Especifica el tenant al que pertenece la imagen.
id	String	Especifica el ID de imagen.
status	String	Especifica el estado de la imagen. El valor puede ser uno de los siguientes: queued: indica que los metadatos de la imagen ya han sido creados, y que está listo para que el archivo de imagen se cargue. saving: indica que el archivo de imagen se está cargando en el almacenamiento de backend. deleted: indica que la imagen ha sido borrada. killed: indica que se produce un error al cargar la imagen. active: indica que la imagen está disponible para su uso.
name	String	Especifica el nombre de la imagen. Para una descripción detallada, consulte Atributos de imagen.
container_format	String	Especifica el tipo de contenedor.
disk_format	String	Especifica el formato de imagen. El valor puede ser zvhd2, vhd, zvhd, raw, iso o qcow2. El valor predeterminado es zvhd2 para una imagen no ISO.
min_ram	Integer	Especifica el tamaño mínimo de memoria (MB) necesario para ejecutar la imagen. El valor del parámetro depende de las especificaciones del . Generalmente, el valor es 0.
max_ram	String	Especifica la memoria máxima (MB) de la imagen.
min_disk	Integer	Especifica el espacio mínimo en disco (GB) necesario para ejecutar la imagen. El valor oscila entre 40 GB y 255 GB.
__os_bit	String	Especifica la arquitectura del sistema operativo, de 32 bits o 64 bits.
__os_feature_list	String	Especifica atributos adicionales de la imagen. El valor es una lista (en formato JSON) de características avanzadas compatibles con la imagen.
__platform	String	Especifica el tipo de plataforma de imagen. El valor puede ser Windows, Ubuntu, Red Hat, SUSE, CentOS, Debian, OpenSUSE, Oracle Linux, Fedora, Other, CoreOS o EulerOS.
schema	String	Especifica el esquema de imagen.
self	String	Especifica la dirección URL de la imagen.
size	Integer	Este parámetro no está disponible actualmente.
__os_type	String	Especifica el tipo de sistema operativo de imagen. El valor puede ser Linux, Windows, u Other.
__os_version	String	Especifica la versión del sistema operativo.
tags	Array of strings	Especifica las etiquetas de la imagen, a través de las cuales puede gestionar imágenes privadas a su manera.
__support_kvm	String	Especifica si la imagen admite KVM. En caso afirmativo, el valor es true. De lo contrario, este parámetro no es necesario.
__support_xen	String	Especifica si la imagen admite Xen. En caso afirmativo, el valor es true. De lo contrario, este parámetro no es necesario.
__support_largememory	String	Especifica si la imagen admite ECS de memoria grande. Si la imagen admite ECS de memoria grande, el valor es true. De lo contrario, este parámetro no es necesario.
__support_diskintensive	String	Especifica si la imagen admite ECS con uso intensivo de disco. Si la imagen admite ECS con uso intensivo de disco, el valor es true. De lo contrario, este parámetro no es necesario.
__support_highperformance	String	Especifica si la imagen admite ECS de alto rendimiento. Si la imagen admite ECS de alto rendimiento, el valor es true. De lo contrario, este parámetro no es necesario.
__support_xen_gpu_type	String	Especifica si la imagen admite ECS acelerados por GPU en la plataforma Xen. Para obtener más información sobre los sistemas operativos de imágenes compatibles con los ECS acelerados por GPU, consulte Tabla 2. Si la imagen no admite ECS acelerados por GPU en la plataforma Xen, este parámetro no es necesario. Este atributo no puede coexistir con __support_xen y __support_kvm.
__support_kvm_gpu_type	String	Especifica si la imagen admite ECS acelerados por GPU en la plataforma KVM. Consulte Tabla 3 por su valor. Si la imagen no admite ECS acelerados por GPU en la plataforma KVM, este parámetro no es necesario. Este atributo no puede coexistir con __support_xen y __support_kvm.
__support_xen_hana	String	Especifica si la imagen admite los ECS de HANA en la plataforma Xen. En caso afirmativo, el valor es true. De lo contrario, este parámetro no es necesario. Este atributo no puede coexistir con __support_xen y __support_kvm.
__support_kvm_infiniband	String	Especifica si la imagen admite los ECS con las NIC de InfiniBand en la plataforma KVM. En caso afirmativo, el valor es true. De lo contrario, este parámetro no es necesario. Este atributo no puede coexistir con __support_xen.
__productcode	String	Especifica el ID de producto de una imagen de Marketplace.
__root_origin	String	Especifica que la imagen se crea a partir de un archivo de imagen externo. Valor: file
__sequence_num	String	Especifica el número de ranuras de disco del sistema de de la imagen. Valor de ejemplo: 0
__support_fc_inject	String	Especifica si la imagen admite la inyección de contraseña/clave privada con Cloud-Init. Si el valor se establece en true, no se admite la inyección de contraseña/clave privada con Cloud-Init. NOTA: Este parámetro solo es válido para imágenes de disco del sistema ECS.
__is_offshelved	String	Especifica si se ha desconectado la imagen del Marketplace. true: La imagen se ha desconectado. false: La imagen no se ha desconectado.
created_at	String	Especifica la hora en que se creó la imagen. El valor está en formato UTC.
updated_at	String	Especifica la hora a la que se actualizó la imagen. El valor está en formato UTC.
active_at	String	Especifica la hora en que el estado de la imagen se cambia a active.
checksum	String	Este parámetro no está disponible actualmente.
hw_firmware_type	String	Especifica el modo de arranque de . Los valores disponibles incluyen: bios indica el modo de inicio del BIOS. uefi indica el modo de arranque UEFI.
file	String	Especifica la dirección URL para cargar y descargar el archivo de imagen.
enterprise_project_id	String	Especifica el proyecto empresarial al que pertenece la imagen. Si el valor es 0 o se deja en blanco, la imagen pertenece al proyecto empresarial predeterminado. Si el valor es un UUID, la imagen pertenece al proyecto empresarial correspondiente al UUID.
_sys_enterprise_project_id	String	Especifica el proyecto empresarial al que pertenece la imagen. Si el valor es 0 o se deja en blanco, la imagen pertenece al proyecto empresarial predeterminado. Si el valor es un UUID, la imagen pertenece al proyecto empresarial correspondiente al UUID.
__support_arm	String	Especifica si la imagen utiliza la arquitectura ARM. El valor puede ser true o false.
__support_agent_list	String	Especifica los agentes configurados para la imagen. hss: El agente de Host Security Service (HSS) está configurado para la imagen. ces: El agente de monitorización del host está configurado para la imagen. Valor de ejemplo: "__support_agent_list": "hss,ces" NOTA: Si la respuesta no contiene este campo, el HSS y los agentes de supervisión del host no están configurados para la imagen.
__account_code	string	Especifica el identificador de carga de la imagen.
__support_amd	String	Specifies whether the image uses AMD's x86 architecture. The value can be true or false.
__system__cmkid	String	Specifies the ID of the key used to encrypt the image.
hw_vif_multiqueue_enabled	String	Especifica si la imagen admite colas múltiples de NIC. El valor puede ser true o false.

Ejemplo de respuesta.

STATUS CODE 200

      
       
         
         {
  "schema": "/v2/schemas/images",
  "next": "/v2/images?__isregistered=true&marker=0328c25e-c840-4496-81ac-c4e01b214b1f&__imagetype=gold&limit=2",
  "images": [
    {
      "schema": "/v2/schemas/image",
      "min_disk": 100,
      "created_at": "2018-09-06T14:03:27Z",
      "__image_source_type": "uds",
      "container_format": "bare",
      "file": "/v2/images/bc6bed6e-ba3a-4447-afcc-449174a3eb52/file",
      "updated_at": "2018-09-06T15:17:33Z",
      "protected": true,
      "checksum": "d41d8cd98f00b204e9800998ecf8427e",
      "id": "bc6bed6e-ba3a-4447-afcc-449174a3eb52",
      "__isregistered": "true",
      "min_ram": 2048,
      "__lazyloading": "true",
      "owner": "1bed856811654c1cb661a6ca845ebc77",
      "__os_type": "Linux",
      "__imagetype": "gold",
      "visibility": "public",
      "virtual_env_type": "FusionCompute",
      "tags": [],
      "__platform": "CentOS",
      "size": 0,
      "__os_bit": "64",
      "__os_version": "CentOS 7.3 64bit",
      "name": "CentOS 7.3 64bit vivado",
      "self": "/v2/images/bc6bed6e-ba3a-4447-afcc-449174a3eb52",
      "disk_format": "zvhd2",
      "virtual_size": null,
      "hw_firmware_type": "bios",
      "status": "active"
    },
    {
      "schema": "/v2/schemas/image",
      "min_disk": 100,
      "created_at": "2018-09-06T14:03:05Z",
      "__image_source_type": "uds",
      "container_format": "bare",
      "file": "/v2/images/0328c25e-c840-4496-81ac-c4e01b214b1f/file",
      "updated_at": "2018-09-25T14:27:40Z",
      "protected": true,
      "checksum": "d41d8cd98f00b204e9800998ecf8427e",
      "id": "0328c25e-c840-4496-81ac-c4e01b214b1f",
      "__isregistered": "true",
      "min_ram": 2048,
      "__lazyloading": "true",
      "owner": "1bed856811654c1cb661a6ca845ebc77",
      "__os_type": "Linux",
      "__imagetype": "gold",
      "visibility": "public",
      "virtual_env_type": "FusionCompute",
      "tags": [],
      "__platform": "CentOS",
      "size": 0,
      "__os_bit": "64",
      "__os_version": "CentOS 7.3 64bit",
      "name": "CentOS 7.3 64bit with sdx",
      "self": "/v2/images/0328c25e-c840-4496-81ac-c4e01b214b1f",
      "disk_format": "zvhd2",
      "virtual_size": null,
      "hw_firmware_type": "bios",
      "status": "active"
    }
  ],
  "first": "/v2/images?__isregistered=true&__imagetype=gold&limit=2"
}

        

      
     

Valores devueltos

Normal
200

Anormal

Valor devuelto	Descripción
400 Bad Request	Error de solicitud. Para obtener más información sobre el código de error devuelto, consulte Códigos de error.
401 Unauthorized	Error de autenticación.
403 Forbidden	Usted no tiene los derechos para realizar la operación.
404 Not Found	No se encontró el recurso solicitado.
500 Internal Server Error	Error interno del servicio.
503 Service Unavailable	El servicio no está disponible.

Tema principal: Imagen (Native OpenStack APIs)

Tema anterior: Imagen (Native OpenStack APIs)

Tema siguiente: Consulta de detalles de imagen (API de OpenStack nativo)

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.

¿Cuáles de los siguientes problemas se presentaron?

Contenido diferente a la de la IU del producto

Descripciones poco claras

Falta de ejemplos o código

Pasos incorrectos

No puedo encontrar lo que necesito

Falta de prácticas recomendadas

Comentarios (opcional)

0/500

Seleccione al menos un tipo de problema e ingrese sus comentarios o sugerencias.

Ingrese 500 caracteres como máximo.

Enviar Cancelar