Method: projects.locations.list

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

Mit dieser Methode werden Zonen basierend auf dem Ressourcenbereich aufgelistet, der im Feld [ListLocationsRequest.name] angegeben ist:

  • Globale Zonen: Wenn name leer ist, werden mit der Methode die öffentlichen Zonen aufgelistet, die für alle Projekte verfügbar sind.
  • Projektspezifische Zonen: Wenn name das Format projects/{project} hat, werden mit der Methode die Zonen aufgelistet, die für dieses bestimmte Projekt sichtbar sind. Dazu gehören öffentliche, private oder andere projektspezifische Zonen, 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 spezifischen Dienstimplementierung und -version in den Anfragepfad eingebunden.

HTTP-Anfrage

GET https://geminidataanalytics.googleapis.com/v1beta/{name=projects/*}/locations

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Die Ressource, die Eigentümer der aufgeführten Zonen 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:

  • geminidataanalytics.locations.list

Weitere Informationen finden Sie in der IAM-Dokumentation.