Method: projects.locations.buckets.list

Crea una lista de buckets de un proyecto en una ubicación determinada.

Solicitud HTTP


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

Las URL usan la sintaxis de transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El elemento superior, que es propietario de esta colección de buckets. El formato es el siguiente:

projects/[PROJECT_ID]/locations/[LOCATION]

Parámetros de consulta

Parámetros
pageSize

integer

Es opcional. Es la cantidad máxima de buckets que se mostrarán. Si no se especifica, se mostrarán como máximo 100 buckets. El valor máximo es 1,000; los valores superiores a 1,000 se fuerzan a 1,000.

pageToken

string

Es opcional. Un token de página, recibido desde una llamada buckets.list anterior. Proporciona esto para recuperar la página siguiente.

showDeleted

boolean

Es opcional. Si es verdadero, la respuesta incluirá los buckets borrados.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta para la lista de buckets.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "buckets": [
    {
      object (Bucket)
    }
  ],
  "nextPageToken": string
}
Campos
buckets[]

object (Bucket)

Es opcional. Es la lista de buckets.

nextPageToken

string

Es opcional. Es un token que se puede enviar como pageToken para recuperar la página siguiente. Cuando se omite este campo, no hay páginas posteriores.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • observability.buckets.list

Para obtener más información, consulta la documentación de IAM.