Method: projects.locations.privateClouds.upgrades.list

Elenca i Upgrades passati, in corso e futuri per il cloud privato specificato.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Esegui una query su un elenco di Upgrades per il nome della risorsa di cloud privato specificato. I nomi delle risorse sono URI senza schema che seguono le convenzioni riportate in https://cloud.google.com/apis/design/resource_names. Ad esempio: projects/my-project/locations/us-west1-a/privateClouds/my-cloud.

L'autorizzazione richiede il seguente permesso IAM per la risorsa parent specificata:

  • vmwareengine.upgrades.list

Parametri di query

Parametri
pageSize

integer

Il numero massimo di Upgrades da restituire in una pagina. Il servizio potrebbe restituire meno risorse di questo valore. Il valore massimo viene forzato a 1000. Il valore predefinito di questo campo è 500.
pageToken

string

Un token di pagina, ricevuto da una precedente chiamata upgrades.list. Forniscilo per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti a upgrades.list devono corrispondere alla chiamata che ha fornito il token di pagina.
filter

string

Un'espressione di filtro che corrisponde alle risorse restituite nella risposta. L'espressione deve specificare il nome del campo, un operatore di confronto e il valore che vuoi utilizzare per il filtro. Il valore deve essere una stringa, un numero o un valore booleano. L'operatore di confronto deve essere =, !=, > o <.

Ad esempio, se stai filtrando un elenco di upgrade, puoi escludere quelli denominati example-upgrade1 specificando name != "example-upgrade1".

Puoi anche filtrare i campi nidificati.

Per filtrare in base a più espressioni, fornisci ogni espressione separata tra parentesi. Ad esempio:

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

Per impostazione predefinita, ogni espressione è un'espressione AND. Tuttavia, puoi includere esplicitamente le espressioni AND e OR. Ad esempio:

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

string

Ordina i risultati dell'elenco in un determinato ordine. Per impostazione predefinita, i risultati restituiti sono ordinati in base a name in ordine crescente. Puoi anche ordinare i risultati in ordine decrescente in base al valore name utilizzando orderBy="name desc". Al momento è supportato solo l'ordinamento per name.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per VmwareEngine.ListUpgrades.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "upgrades": [
    {
      object (Upgrade)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campi
upgrades[]

object (Upgrade)

Un elenco di Upgrades.
nextPageToken

string

Un token, che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.
unreachable[]

string

Elenco delle risorse non raggiungibili.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la Authentication Overview.