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

Obtiene una lista de los recursos compartidos de Delta Sharing disponibles en la fuente de Delta Sharing upstream.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el nombre del catálogo. Formato: projects/{project}/catalogs/{catalog}

Parámetros de consulta

Parámetros
pageSize

integer

Es opcional. Es la cantidad máxima de recursos compartidos que se devolverán. El servicio puede mostrar menos que este valor. Si no se especifica, se devolverán, como máximo, 100 recursos compartidos. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000.
pageToken

string

Es opcional. Un token de página, recibido desde una llamada shares.list anterior.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es el mensaje de respuesta para el método shares.list.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "deltaSharingShares": [
    {
      object (DeltaSharingShare)
    }
  ],
  "nextPageToken": string
}
Campos
deltaSharingShares[]

object (DeltaSharingShare)

Son los recursos compartidos de Delta Sharing del catálogo especificado.
nextPageToken

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • biglake.catalogs.get

Para obtener más información, consulta la documentación de IAM.

DeltaSharingShare

Representa un elemento Share de Delta Sharing.

Representación JSON 
{
  "name": string,
  "shareId": string,
  "originalName": string
}
Campos
name

string

Es el identificador. Nombre del recurso. Formato: projects/{project}/catalogs/{catalog}/shares/{delta_sharing_share}. Nota: {delta_sharing_share} es un nombre fácil de usar generado por el sistema (p. ej., adecuado para BigQuery), no el URN original de nivel superior.
shareId

string

Solo salida. Es el identificador único del uso compartido.
originalName

string

Solo salida. Es el nombre original del recurso compartido (p.ej., URN nativo).