Method: folders.locations.list

Listet Informationen zu den unterstützten Standorten für diesen Dienst auf.

Mit dieser Methode werden Standorte basierend auf dem im Feld [ListLocationsRequest.name] angegebenen Ressourcenbereich aufgelistet:

  • Globale Standorte: Wenn name leer ist, werden mit der Methode die öffentlichen Standorte aufgelistet, die für alle Projekte verfügbar sind.
  • Projektspezifische Standorte: Wenn name dem Format projects/{project} entspricht, werden mit der Methode Standorte aufgelistet, die für dieses bestimmte Projekt sichtbar sind. Dazu gehören öffentliche, private oder andere projektspezifische Standorte, die für das Projekt aktiviert sind.

Bei gRPC- und Clientbibliotheksimplementierungen wird der Ressourcenname als Feld name übergeben. Bei direkten Dienstaufrufen wird der Ressourcenname basierend auf der jeweiligen Dienstimplementierung und ‑version in den Anfragepfad eingebunden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Die Ressource, die Eigentümer der aufgeführten Standorte ist, falls zutreffend.

Suchparameter

Parameter
filter

string

Ein Filter, mit dem die Ergebnisse auf eine bevorzugte Teilmenge eingegrenzt werden können. Die Filtersprache akzeptiert Strings wie "displayName=tokyo" und wird unter AIP-160 genauer beschrieben.
pageSize

integer

Die maximale Anzahl von zurückzugebenden Ergebnissen. Wenn kein Wert festgelegt ist, wählt der Dienst einen Standardwert aus.
pageToken

string

Ein Seitentoken, das vom Feld nextPageToken in der Antwort empfangen wurde. Senden Sie dieses Seitentoken, um die nächste Seite zu empfangen.
extraLocationTypes[]

string

Optional. Verwenden Sie dieses Feld nicht. Es wird nicht unterstützt und deshalb ignoriert, sofern nicht ausdrücklich anders dokumentiert. Das Feld ist in erster Linie für die interne Verwendung vorgesehen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von ListLocationsResponse.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • observability.locations.list

Weitere Informationen finden Sie in der IAM-Dokumentation.