Method: projects.locations.buckets.list

Listar buckets de um projeto em um local específico.

Solicitação HTTP

GET https://observability.googleapis.com/v1/{parent=projects/*/locations/*}/buckets

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O pai, que é proprietário dessa coleção de buckets. O formato é:

projects/[PROJECT_ID]/locations/[LOCATION]

Parâmetros de consulta

Parâmetros
pageSize

integer

Opcional. O número máximo de buckets a serem retornados. Se não for especificado, no máximo 100 intervalos serão retornados. O valor máximo é 1.000. Valores maiores serão convertidos para 1.000.

pageToken

string

Opcional. Um token de página recebido de uma chamada buckets.list anterior. Forneça isso para recuperar a página subsequente.

showDeleted

boolean

Opcional. Se for "true", a resposta vai incluir buckets excluídos.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta para listar intervalos.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "buckets": [
    {
      object (Bucket)
    }
  ],
  "nextPageToken": string
}
Campos
buckets[]

object (Bucket)

Opcional. A lista de intervalos.

nextPageToken

string

Opcional. Um token que pode ser enviado como pageToken para recuperar a próxima página. Quando esse campo é omitido, não há páginas subsequentes.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • observability.buckets.list

Para mais informações, consulte a documentação do IAM.