Method: projects.locations.privateClouds.upgrades.list

列出指定私有雲的過去、進行中和即將進行的 Upgrades。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

這是必要旗標，查詢指定私有雲資源名稱的 Upgrades 清單。資源名稱是無配置的 URI，遵循 https://cloud.google.com/apis/design/resource_names 中的慣例。例如：projects/my-project/locations/us-west1-a/privateClouds/my-cloud

授權需要指定資源 parent 的下列 IAM 權限：

  • vmwareengine.upgrades.list

查詢參數

參數
pageSize

integer

一頁中傳回的 Upgrades 數量上限。服務傳回的資源數量可能會少於這個值。系統會強制將最大值設為 1000。這個欄位的預設值為 500。
pageToken

string

屬於接收自前一個 upgrades.list 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 upgrades.list 的所有其他參數須與提供網頁權杖的呼叫相符。
filter

string

篩選運算式，可比對回應中傳回的資源。運算式必須指定欄位名稱、比較運算子，以及要用於篩選的值。值必須是字串、數字或布林值。比較運算子必須是 =、!=、> 或 <。

舉例來說，如果您要篩選升級清單，可以指定 name != "example-upgrade1" 排除名為 example-upgrade1 的升級。

您也可以篩選巢狀欄位。

如要依多個運算式篩選，請在括號中分別提供每個運算式。例如：

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

根據預設，每個運算式都是 AND 運算式。不過，您可以明確加入 AND 和 OR 運算式。例如：

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

string

依特定順序排序清單結果。根據預設，傳回的結果會依 name 遞增排序。您也可以使用 orderBy="name desc"，根據 name 值遞減排序結果。目前僅支援依 name 排序。

要求主體

要求主體必須為空白。

回應主體

VmwareEngine.ListUpgrades 的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "upgrades": [
    {
      object (Upgrade)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
欄位
upgrades[]

object (Upgrade)

Upgrades 清單。
nextPageToken

string

可做為 pageToken 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。
unreachable[]

string

無法連線的資源清單。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。