Method: projects.locations.zones.list

Listet Zonen in einem bestimmten Projekt und an einem bestimmten Standort auf.

HTTP-Anfrage

GET https://gdchardwaremanagement.googleapis.com/v1alpha/{parent=projects/*/locations/*}/zones

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das Projekt und der Standort, in dem Zonen aufgelistet werden sollen. Format: projects/{project}/locations/{location}

Wenn Sie Zonen für alle Standorte auflisten möchten, ersetzen Sie den Standort durch - (das Bindestrichzeichen) und prüfen Sie das Feld „unreachable“ in der Antwortnachricht.

Suchparameter

Parameter
pageSize

integer

Optional. Angeforderte Seitengröße. Der Server gibt möglicherweise weniger Elemente als angefordert zurück. Wenn kein Wert angegeben wurde, wählt der Server einen geeigneten Standardwert aus.

pageToken

string

Optional. Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll

filter

string

Optional. Filterbedingung. Siehe AIP-160.

orderBy

string

Optional. Hinweis zur Sortierung der Ergebnisse.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Eine Liste von Zonen.

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

JSON-Darstellung
{
  "zones": [
    {
      object (Zone)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Felder
zones[]

object (Zone)

Die Liste der Zonen.

nextPageToken

string

Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll.

unreachable[]

string

Standorte, die nicht erreicht werden konnten. Wird nur für Anfragen an den Platzhalterort - verwendet. Wenn der Wert nicht leer ist, bedeutet das, dass die Ergebnisse unvollständig sind.

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 parent:

  • gdchardwaremanagement.zones.list

Weitere Informationen finden Sie in der IAM-Dokumentation.