Skip to main content
GET
Listar imagens
Requer a ação do IAM compute:ListImages. Consulte permissões de computação para obter a lista completa, o que cada uma abrange e um exemplo de política.

Autorizações

Authorization
string
header
obrigatório

Um token bearer OAuth 2.0, enviado como Authorization: Bearer <token>. Esta é a forma recomendada de autenticação.

Obtenha o token trocando o par de chaves de acesso de uma conta de serviço em POST /v1/oauth/token com grant_type=client_credentials. Esse é o fluxo padrão de credenciais de cliente; bibliotecas compatíveis com OAuth podem obter e renovar o token para você.

Os tokens duram uma hora por padrão. O mesmo par de chaves de acesso também serve como credencial AWS SigV4 para o endpoint de objetos compatível com S3, que aceita somente esse método de autenticação.

Parâmetros de consulta

crn
string

CRN exato do recurso, intersetado com todos os outros filtros antes da paginação. Um CRN estrangeiro ou não correspondido retorna uma página vazia; CRNs malformados ou vazios retornam 400. As listas de anexos aninhadas filtram o recurso representado, não a vinculação.

limit
integer
padrão:20

Número máximo de itens a devolver. Um valor acima do máximo é fixado ao invés de rejeitado, então uma página mais curta do que a que você pediu é normal — page until meta.has_more é false, não até que uma página pareça curta.

Intervalo obrigatório: 1 <= x <= 100
marker
string

Cursor de paginação opaco. Echo back o valor meta.marker da página anterior para buscar a próxima; não construa ou analise-o. A forma interna do token varia de acordo com o endpoint (um ID de recurso, um carimbo de data/hora, etc.) e não é garantida a estabilidade entre versões.

os
string
Exemplo:

"ubuntu"

architecture
string
Exemplo:

"amd64"

name
string

Correspondência de nome exata, diferenciando maiúsculas e minúsculas; um valor vazio não corresponde a nenhum recurso nomeado.

Exemplo:

"ubuntu-24.04"

status
enum<string>
Opções disponíveis:
pending,
importing,
active,
error,
deleting,
withdrawn
Exemplo:

"active"

all_versions
boolean
padrão:false

Incluir compilações que uma versão mais recente substituiu. Desligado por padrão, quando cada tag contribui apenas com a compilação que vale a pena iniciar.

Exemplo:

true

Resposta

Uma página de imagens, ordenadas por nome

images
object[]
obrigatório
meta
object