Admin - Datasets GetDatasourcesAsAdmin

  • Referência
Service:
Power BI REST APIs
API Version:
v1.0

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

Cada solicitação leva 0,5 segundos para ser processada, durante o qual outras solicitações são enfileiradas.

Permissões

  • O usuário deve ter direitos de administrador (como Office 365 Administrador Global ou Administrador de Serviços do Power BI) 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 nenhuma pré-solicitação de consentimento de administrador necessária para o Power BI definida 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. 

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

OK

Exemplos

Example

Sample Request

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

Sample Response

Status code:
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 em Grupo.
Datasources

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

Datasource

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 apenas para DirectQuery.
datasourceId

string

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

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 de gateway.
name

string

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

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 em 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

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