Method: projects.locations.list

Elenca le informazioni sulle località supportate per questo servizio.

Questo metodo elenca le località in base all'ambito della risorsa fornito nel campo [ListLocationsRequest.name]:

  • Località globali: se name è vuoto, il metodo elenca le località pubbliche disponibili per tutti i progetti.
  • Località specifiche del progetto: se name segue il formato projects/{project}, il metodo elenca le località visibili a quel progetto specifico. Sono incluse le posizioni pubbliche, private o altre posizioni specifiche del progetto abilitate per il progetto.

Per le implementazioni gRPC e della libreria client, il nome della risorsa viene passato come campo name. Per le chiamate dirette al servizio, il nome della risorsa viene incorporato nel percorso della richiesta in base all'implementazione e alla versione specifiche del servizio.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

La risorsa proprietaria della raccolta di località, se applicabile.

Parametri di query

Parametri
filter

string

Un filtro per restringere i risultati a un sottoinsieme preferito. Il linguaggio di applicazione dei filtri accetta stringhe come "displayName=tokyo" ed è documentato in modo più dettagliato in AIP-160.
pageSize

integer

Il numero massimo di risultati da restituire. Se non viene impostato, il servizio seleziona un valore predefinito.
pageToken

string

Un token di pagina ricevuto dal campo nextPageToken nella risposta. Invia questo token di pagina per ricevere la pagina successiva.
extraLocationTypes[]

string

Facoltativo. Non utilizzare questo campo. Non è supportato e viene ignorato, a meno che non sia esplicitamente documentato diversamente. Questo è principalmente per uso interno.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di ListLocationsResponse.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa name:

  • observability.locations.list

Per saperne di più, consulta la documentazione di IAM.