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

アップストリームの Delta Sharing ソースで使用可能な Delta Sharing 共有のリストを取得します。

HTTP リクエスト

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

この URL では gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。カタログの名前。形式: projects/{project}/catalogs/{catalog}

クエリ パラメータ

パラメータ
pageSize

integer

省略可。返す共有の最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合は、最大で 100 件の共有が返されます。最大値は 1,000 です。1,000 を超える値は 1,000 に強制変換されます。
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} は、元のアップストリーム URN ではなく、システム生成のユーザー フレンドリーな名前（BigQuery に適した名前など）です。
shareId

string

出力専用。共有の一意の識別子。
originalName

string

出力専用。共有の元の共有名（ネイティブ URN など）。