Compartilhar via

Admin - Datasets GetDatasourcesAsAdmin

Serviço:
Power BI REST APIs
Versão da API:
v1.0

Retorna uma lista de fontes de dados para o conjunto de dados especificado.

Permissões

  • O usuário deve ser um administrador do Fabric ou autenticar usando uma entidade de serviço.
  • Há suporte para permissões delegadas.

Ao executar em autenticação prinicipal de serviço, um aplicativo não deve ter quaisquer pré-remissões necessárias de consentimento do administrador para o Power BI definidas nele no portal do Azure.

Escopo necessário

Tenant.Read.All ou Tenant.ReadWrite.All

Relevante somente ao autenticar por meio de um token de acesso de administrador delegado padrão. Não deve estar presente quando a autenticação por meio de uma entidade de serviço é usada.

Limitações

Máximo de 300 solicitações por hora. 

GET https://api.powerbi.com/v1.0/myorg/admin/datasets/{datasetId}/datasources

Parâmetros de URI

Nome Em Obrigatório Tipo Description
datasetId
 path True

string

Respostas

Nome Tipo Description
200 OK

Datasources

OKEY

Exemplos

Example

Solicitação de exemplo

GET https://api.powerbi.com/v1.0/myorg/admin/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/datasources

Resposta de exemplo

Código de status:
200 
{
  "value": [
    {
      "name": "301",
      "connectionString": "data source=MyServer.database.windows.net;initial catalog=MyDatabase;persist security info=True;encrypt=True;trustservercertificate=False",
      "datasourceType": "Sql",
      "datasourceId": "16a54ccd-620d-4af3-9197-0b8c779a9a6d",
      "gatewayId": "7f1c4e55-544b-403f-b132-da0d3a024674",
      "connectionDetails": {
        "server": "MyServer.database.windows.net",
        "database": "MyDatabase"
      }
    }
  ]
}

Definições

Nome Description
Datasource

Uma fonte de dados do Power BI
DatasourceConnectionDetails

Os detalhes da conexão da fonte de dados do Power BI. Veja exemplos em Obter fontes de dados ou obter fontes de dados no grupo.
Datasources

O wrapper de resposta OData para uma coleção de fontes de dados do Power BI

Datasource

Objeto

Uma fonte de dados do Power BI

Nome Tipo Description
connectionDetails

DatasourceConnectionDetails

Os detalhes da conexão da fonte de dados
connectionString

string

(Preterido) A cadeia de conexão da fonte de dados. Disponível somente para DirectQuery.
datasourceId

string (uuid)

A ID da fonte de dados associada, que está vazia quando não está associada a um gateway
datasourceType

string

O tipo de fonte de dados
gatewayId

string (uuid)

A ID do gateway associado, que está vazia quando não está associada a um gateway. Ao usar um cluster de gateway, a ID do gateway refere-se ao gateway primário (primeiro) no cluster e é semelhante à ID do cluster do gateway.
name

string

(Preterido) O nome da fonte de dados. Disponível somente para DirectQuery.

DatasourceConnectionDetails

Objeto

Os detalhes da conexão da fonte de dados do Power BI. Veja exemplos em Obter fontes de dados ou obter fontes de dados no grupo.

Nome Tipo Description
account

string

A conta de conexão
classInfo

string

As informações da classe de conexão
database

string

O banco de dados de conexão
domain

string

O domínio de conexão
emailAddress

string

O endereço de email de conexão
kind

string

O tipo de conexão
loginServer

string

O servidor de logon de conexão
path

string

O caminho da conexão
server

string

O servidor de conexão
url

string

A URL de conexão

Datasources

Objeto

O wrapper de resposta OData para uma coleção de fontes de dados do Power BI

Nome Tipo Description
@odata.context

string

Contexto OData
value

Datasource[]

A coleção de fontes de dados