Method: projects.locations.privateClouds.list

Listet PrivateCloud in einem bestimmten Projekt und an einem bestimmten Standort auf

HTTP-Anfrage

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

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

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

  • vmwareengine.privateClouds.list

Suchparameter

Parameter
pageSize

integer

Die maximale Anzahl von privaten Clouds, 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 privateClouds.list-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

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

string

Ein Filterausdruck, der mit den in der Antwort zurückgegebenen Ressourcen übereinstimmt. Im Ausdruck müssen der Feldname, ein Vergleichsoperator und der Wert angegeben werden, den Sie zum Filtern verwenden möchten. Der Wert muss ein String, eine Zahl oder ein boolescher Wert sein. Der Vergleichsoperator muss =, !=, > oder < sein.

Wenn Sie beispielsweise eine Liste privater Clouds filtern, können Sie die Clouds mit dem Namen example-pc ausschließen, indem Sie name != "example-pc" angeben.

Sie können auch verschachtelte Felder filtern. Sie können beispielsweise networkConfig.managementCidr = "192.168.0.0/24" angeben, um private Clouds nur dann einzubeziehen, wenn sie eine übereinstimmende Adresse in ihrer Netzwerkkonfiguration haben.

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

(name = "example-pc")
(createTime > "2021-04-12T08:15:10.40Z")

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

(name = "private-cloud-1") AND
(createTime > "2021-04-12T08:15:10.40Z") OR
(name = "private-cloud-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.ListPrivateClouds

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

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

object (PrivateCloud)

Eine Liste der privaten 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.