Method: projects.locations.privateClouds.upgrades.list

Listet vergangene, laufende und anstehende Upgrades für die angegebene private Cloud auf.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Fragen Sie eine Liste von Upgrades für den angegebenen Namen der privaten Cloud-Ressource ab. Ressourcennamen sind schemalose URIs, die den Konventionen unter https://cloud.google.com/apis/design/resource_names entsprechen. Beispiel: projects/my-project/locations/us-west1-a/privateClouds/my-cloud

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

  • vmwareengine.upgrades.list

Suchparameter

Parameter
pageSize

integer

Die maximale Anzahl von Upgrades, die auf einer Seite zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger Ressourcen 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 upgrades.list-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für upgrades.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 von Upgrades filtern, können Sie die Upgrades mit dem Namen example-upgrade1 ausschließen, indem Sie name != "example-upgrade1" angeben.

Sie können auch verschachtelte Felder filtern.

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

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

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

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

object (Upgrade)

Eine Liste mit Upgrades.
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

Liste der nicht erreichbaren Ressourcen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.