Skip to main content
GET
Listar filas
Exige a ação IAM queue:ListQueues. Veja QUEUE permissões para a lista completa, o escopo de cada ação 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

name
string

Nome exato da fila na conta. Combina com crn quando ambos são informados.

Exemplo:

"orders"

crn
string

CRN exato da fila. CRNs malformados, de outra conta ou com serviço, tipo ou região incorretos retornam uma página vazia. Combina com name.

Exemplo:

"crn:queue:sa-saopaulo-1:acme:queue/orders"

marker
string<uuid>

ID do último item da página anterior.

Exemplo:

"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d"

limit
integer
padrão:50

Número máximo de itens a devolver. Um valor maior é fixado ao máximo em vez de rejeitado, então page until meta.has_more é false.

Intervalo obrigatório: 1 <= x <= 200
Exemplo:

50

Resposta

Lista paginada de filas. Omite contagens para evitar uma varredura por fila. Use DescribeQueue para consultar a profundidade de uma fila.

queues
object[]
obrigatório
meta
object