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

Ruft eine Liste der Delta Sharing-Freigaben ab, die in der Upstream-Delta Sharing-Quelle verfügbar sind.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Name des Katalogs. Format: projects/{project}/catalogs/{catalog}

Suchparameter

Parameter
pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden Freigaben. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 100 Freigaben zurückgegeben. Der Höchstwert liegt bei 1.000. Alle Werte darüber werden implizit in 1.000 umgewandelt.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen shares.list-Aufruf empfangen wurde.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für die Methode „shares.list“.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "deltaSharingShares": [
    {
      object (DeltaSharingShare)
    }
  ],
  "nextPageToken": string
}
Felder
deltaSharingShares[]

object (DeltaSharingShare)

Die Delta Sharing-Freigaben aus dem angegebenen Katalog.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource parent:

  • biglake.catalogs.get

Weitere Informationen finden Sie in der IAM-Dokumentation.

DeltaSharingShare

Stellt eine Delta Sharing-Freigabe dar.

JSON-Darstellung 
{
  "name": string,
  "shareId": string,
  "originalName": string
}
Felder
name

string

ID. Der Ressourcenname. Format: projects/{project}/catalogs/{catalog}/shares/{delta_sharing_share}. Hinweis: {delta_sharing_share} ist ein vom System generierter, benutzerfreundlicher Name (z. B. für BigQuery geeignet), nicht der ursprüngliche Upstream-URN.
shareId

string

Nur Ausgabe. Die eindeutige ID der Freigabe.
originalName

string

Nur Ausgabe. Der ursprüngliche Freigabename (z.B. native URN) der Freigabe.