Method: projects.locations.announcements.list

列出指定區域和專案的 Announcements

HTTP 要求

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

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

路徑參數

參數
parent

string

這是必要旗標，要查詢公告的位置資源名稱，資源名稱是無配置的 URI，遵循 https://cloud.google.com/apis/design/resource_names 中的慣例。例如：projects/my-project/locations/us-west1-a

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

  • vmwareengine.announcements.list

查詢參數

參數
pageSize

integer

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

string

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

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

string

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

舉例來說，如果您要篩選公告執行作業清單，可以指定 name != "example-announcement"，排除名為 example-announcement 的作業。

您也可以篩選巢狀欄位。

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

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

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

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

string

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

要求主體

要求主體必須為空白。

回應主體

VmwareEngine.ListAnnouncements 的回應訊息

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

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

object (Announcement)

公告執行作業清單。
nextPageToken

string

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

string

無法抵達的地點清單

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。