Method: projects.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, listet die Methode die öffentlichen Standorte auf, die für alle Projekte verfügbar sind.
  • Projektspezifische Standorte: Wenn name das Format projects/{project} hat, listet die Methode die für dieses Projekt sichtbaren Standorte auf. Dazu gehören öffentliche, private oder andere projektspezifische Standorte, die für das Projekt aktiviert sind.

Bei gRPC- und Clientbibliotheksimplementierungen wird der Ressourcenname als name-Feld übergeben. Bei direkten Dienstaufrufen wird der Ressourcenname basierend auf der spezifischen Dienstimplementierung und -version in den Anfragepfad eingefügt.

HTTP-Anfrage

GET https://configdelivery.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 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 nur, wenn es ausdrücklich anders dokumentiert ist. 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:

  • configdelivery.locations.list

Weitere Informationen finden Sie in der IAM-Dokumentation.