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://edgecontainer.googleapis.com/v1/{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

Die Antwortnachricht für Locations.ListLocations.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "locations": [
    {
      object (Location)
    }
  ],
  "nextPageToken": string
}
Felder
locations[]

object (Location)

Eine Liste der Standorte, die zum angegebenen Filter in der Anfrage passen.
nextPageToken

string

Das Standardtoken für die nächste Listenseite.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.