Method: projects.locations.list

Permite mostrar una lista con información sobre las ubicaciones compatibles con este servicio.

Este método enumera las ubicaciones según el alcance del recurso proporcionado en el campo [ListLocationsRequest.name]:

  • Ubicaciones globales: Si name está vacío, el método enumera las ubicaciones públicas disponibles para todos los proyectos.
  • Ubicaciones específicas del proyecto: Si name sigue el formato projects/{project}, el método enumera las ubicaciones visibles para ese proyecto específico. Esto incluye ubicaciones públicas, privadas o de otro tipo específicas del proyecto que estén habilitadas para el proyecto.

Para las implementaciones de gRPC y biblioteca cliente, el nombre del recurso se pasa como el campo name. En el caso de las llamadas directas al servicio, el nombre del recurso se incorpora en la ruta de acceso de la solicitud según la implementación y la versión específicas del servicio.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
name

string

El recurso propietario de la colección de ubicaciones, si corresponde.

Parámetros de consulta

Parámetros
filter

string

Es un filtro para limitar los resultados a un subconjunto preferido. El lenguaje de filtrado acepta cadenas como "displayName=tokyo" y se documenta con más detalle en AIP-160.
pageSize

integer

La cantidad máxima de resultados que se mostrarán. Si no se configura, el servicio selecciona una configuración predeterminada.
pageToken

string

Es un token de página recibido del campo nextPageToken en la respuesta. Envía ese token de página para recibir la página siguiente.
extraLocationTypes[]

string

Es opcional. No uses este campo. No se admite y se ignora, a menos que se documente explícitamente lo contrario. Se usa principalmente de forma interna.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de ListLocationsResponse.

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 name:

  • observability.locations.list

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