Method: deltasharing.v1.projects.catalogs.shares.list

取得上游 Delta Sharing 來源中可用的 Delta Sharing 分享項目清單。

HTTP 要求

GET https://biglake.googleapis.com/deltasharing/v1/{parent=projects/*/catalogs/*}/shares

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

路徑參數

參數
parent

string

這是必要旗標，目錄的名稱。格式：projects/{project}/catalogs/{catalog}

查詢參數

參數
pageSize

integer

選用。要傳回的分享數上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 100 個共用項目。許可的最大值為 1000；超出的數值將一律指定為 1000。
pageToken

string

選用。屬於接收自前一個 shares.list 呼叫的網頁權杖。

要求主體

要求主體必須為空白。

回應主體

shares.list 方法的回應訊息。

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

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

object (DeltaSharingShare)

指定目錄中的 Delta Sharing 共用項目。
nextPageToken

string

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

授權範圍

需要下列其中一種 OAuth 範圍：

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

詳情請參閱Authentication Overview。

IAM 權限

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

  • biglake.catalogs.get

詳情請參閱 IAM 說明文件。

DeltaSharingShare

代表 Delta Sharing 共用項目。

JSON 表示法 
{
  "name": string,
  "shareId": string,
  "originalName": string
}
欄位
name

string

ID。資源名稱。格式：projects/{project}/catalogs/{catalog}/shares/{delta_sharing_share} 注意：{delta_sharing_share} 是系統產生的易記名稱 (例如適用於 BigQuery)，而非原始的上游 URN。
shareId

string

僅供輸出。共用項目的專屬 ID。
originalName

string

僅供輸出。分享項目的原始分享名稱 (例如原生 URN)。