Method: organizations.locations.list

Liste les informations relatives aux emplacements disponibles pour ce service.

Cette méthode liste les emplacements en fonction du champ d'application de la ressource fourni dans le champ ListLocationsRequest.name :

  • Emplacements mondiaux : si name est vide, la méthode liste les emplacements publics disponibles pour tous les projets.
  • Emplacements spécifiques à un projet : si name suit le format projects/{project}, la méthode liste les emplacements visibles pour ce projet spécifique. Cela inclut les emplacements publics, privés ou autres emplacements spécifiques à un projet activés pour le projet.

Pour les implémentations gRPC et de bibliothèque cliente, le nom de la ressource est transmis en tant que champ name. Pour les appels de service directs, le nom de la ressource est intégré au chemin d'accès de la requête en fonction de l'implémentation et de la version spécifiques du service.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

La ressource qui possède la collection d'emplacements, le cas échéant.

Paramètres de requête

Paramètres
filter

string

Un filtre permettant de limiter les résultats à un sous-ensemble préféré. Le langage de filtrage accepte des chaînes telles que "displayName=tokyo". Il est décrit plus en détail sur la page AIP-160.
pageSize

integer

Nombre maximal de résultats à renvoyer. Si ce champ n'est pas défini, le service sélectionne une valeur par défaut.
pageToken

string

Jeton de page reçu du champ nextPageToken dans la réponse. Envoyez ce jeton de page pour recevoir la page suivante.
extraLocationTypes[]

string

Facultatif. N'utilisez pas ce champ. Il n'est pas compatible et est ignoré, sauf indication contraire explicite. Il est principalement destiné à un usage interne.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de ListLocationsResponse.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource name :

  • observability.locations.list

Pour en savoir plus, consultez la documentation IAM.