Method: projects.locations.buckets.list

列出特定位置的專案值區。

HTTP 要求

GET https://observability.googleapis.com/v1/{parent=projects/*/locations/*}/buckets

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

路徑參數

參數
parent

string

這是必要旗標,擁有這個 bucket 集合的父項。格式為:

projects/[PROJECT_ID]/locations/[LOCATION]

查詢參數

參數
pageSize

integer

選用。要傳回的值區數量上限。如未指定,最多會傳回 100 個值區。許可的最大值為 1000;超出的數值將一律指定為 1000。

pageToken

string

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

showDeleted

boolean

選用。如果為 true,則回應會包含已刪除的 bucket。

要求主體

要求主體必須為空白。

回應主體

列出 bucket 的回應。

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

JSON 表示法
{
  "buckets": [
    {
      object (Bucket)
    }
  ],
  "nextPageToken": string
}
欄位
buckets[]

object (Bucket)

選用。bucket 清單。

nextPageToken

string

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

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱Authentication Overview

IAM 權限

需要 parent 資源的下列 IAM 權限:

  • observability.buckets.list

詳情請參閱 IAM 說明文件