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

Recebe uma lista de compartilhamentos do Delta Sharing disponíveis na origem upstream do Delta Sharing.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome do catálogo. Formato: projects/{project}/catalogs/{catalog}

Parâmetros de consulta

Parâmetros
pageSize

integer

Opcional. O número máximo de compartilhamentos a serem retornados. O serviço pode retornar um valor inferior a este. Se não for especificado, no máximo 100 compartilhamentos serão retornados. O valor máximo é 1.000. Valores maiores serão convertidos para 1.000.
pageToken

string

Opcional. Um token de página recebido de uma chamada shares.list anterior.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para o método shares.list.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "deltaSharingShares": [
    {
      object (DeltaSharingShare)
    }
  ],
  "nextPageToken": string
}
Campos
deltaSharingShares[]

object (DeltaSharingShare)

Os compartilhamentos do Delta Sharing do catálogo especificado.
nextPageToken

string

Um token, que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • biglake.catalogs.get

Para mais informações, consulte a documentação do IAM.

DeltaSharingShare

Representa um compartilhamento do Delta Sharing.

Representação JSON 
{
  "name": string,
  "shareId": string,
  "originalName": string
}
Campos
name

string

Identificador. O nome do recurso. Formato: projects/{project}/catalogs/{catalog}/shares/{delta_sharing_share} Observação: {delta_sharing_share} é um nome amigável gerado pelo sistema (por exemplo, adequado para o BigQuery), não o URN upstream original.
shareId

string

Apenas saída. O identificador exclusivo do compartilhamento.
originalName

string

Apenas saída. O nome original do compartilhamento (por exemplo, URN nativo).