Skip to main content
GET
Listar imágenes
Requiere la acción de IAM compute:ListImages. Consulte permisos de computación para obtener la lista completa, lo que cubre cada una y un ejemplo de directiva.

Autorizaciones

Authorization
string
header
requerido

Un token bearer de OAuth 2.0, enviado como Authorization: Bearer <token>. Esta es la forma recomendada de autenticación.

Obtén el token intercambiando el par de claves de acceso de una cuenta de servicio en POST /v1/oauth/token con grant_type=client_credentials. Es el flujo estándar de credenciales de cliente; las bibliotecas compatibles con OAuth pueden obtener y renovar el token por ti.

Los tokens duran una hora por defecto. El mismo par de claves de acceso también sirve como credencial AWS SigV4 para el endpoint de objetos compatible con S3, que solo acepta ese método de autenticación.

Parámetros de consulta

crn
string

CRN exacto del recurso, intersecado con todos los demás filtros antes de la paginación. Un CRN extranjero o no coincidente devuelve una página vacía; los CRN mal formados o vacíos devuelven 400. Las listas de archivos adjuntos anidados filtran el recurso representado, no el enlace.

limit
integer
predeterminado:20

Número máximo de artículos a devolver. Un valor por encima del máximo se le aplica en lugar de rechazarlo, por lo que una página más corta que la que solicitaste es normal — page until meta.has_more es falso, no hasta que una página se vea corta.

Rango requerido: 1 <= x <= 100
marker
string

Cursor de paginación opaco. Hacer eco del valor meta.marker de la página anterior para buscar la siguiente; no construirlo ni analizarlo. La forma interna del token varía según el punto final (un ID de recurso, una marca de tiempo, etc.) y no se garantiza su estabilidad entre versiones.

os
string
Ejemplo:

"ubuntu"

architecture
string
Ejemplo:

"amd64"

name
string

Coincidencia de nombre exacta, que distingue entre mayúsculas y minúsculas; un valor vacío no coincide con ningún recurso con nombre.

Ejemplo:

"ubuntu-24.04"

status
enum<string>
Opciones disponibles:
pending,
importing,
active,
error,
deleting,
withdrawn
Ejemplo:

"active"

all_versions
boolean
predeterminado:false

Incluir compilaciones que una versión más reciente ha reemplazado. Desactivado por defecto, cuando cada etiqueta contribuye solo la compilación que vale la pena lanzar.

Ejemplo:

true

Respuesta

Una página de imágenes, ordenadas por nombre

images
object[]
requerido
meta
object