Method: projects.locations.privateClouds.clusters.list

Listet Cluster-Ressourcen in einer bestimmten privaten Cloud auf.

HTTP-Anfrage

GET https://vmwareengine.googleapis.com/v1/{parent=projects/*/locations/*/privateClouds/*}/clusters

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Ressourcenname der privaten Cloud, für die Cluster abgefragt werden sollen. Ressourcennamen sind schemalose URIs, die den Konventionen unter https://cloud.google.com/apis/design/resource_names entsprechen. Beispiel: projects/my-project/locations/us-central1-a/privateClouds/my-cloud

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource parent:

  • vmwareengine.clusters.list

Suchparameter

Parameter
pageSize

integer

Die maximale Anzahl von Clustern, die auf einer Seite zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Der Höchstwert wird auf 1.000 festgelegt. Der Standardwert dieses Felds ist 500.
pageToken

string

Ein Seitentoken, das von einem vorherigen clusters.list-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für clusters.list bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
filter

string

Wenn Sie nach mehreren Ausdrücken filtern möchten, geben Sie jeden Ausdruck in Klammern an. Beispiel:

(name = "example-cluster")
(nodeCount = "3")

Standardmäßig ist jeder Ausdruck ein AND-Ausdruck. Sie können jedoch explizit AND- und OR-Ausdrücke einfügen. Beispiel:

(name = "example-cluster-1") AND
(createTime > "2021-04-12T08:15:10.40Z") OR
(name = "example-cluster-2")
orderBy

string

Sortiert Listenergebnisse in einer bestimmten Reihenfolge. Standardmäßig werden die zurückgegebenen Ergebnisse nach name in aufsteigender Reihenfolge sortiert. Sie können die Ergebnisse auch mit orderBy="name desc" in absteigender Reihenfolge nach dem name-Wert sortieren. Derzeit wird nur die Sortierung nach name unterstützt.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für VmwareEngine.ListClusters

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

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

object (Cluster)

Eine Liste der Cluster privater Clouds.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.
unreachable[]

string

Standorte, die bei einer aggregierten Abfrage mit Platzhaltern nicht erreicht werden konnten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.