Partilhar via

Admin - Dataflows GetDataflowDatasourcesAsAdmin

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

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

As fontes de dados excluídas ainda aparecerão na resposta. Isso pode incluir fontes de gateway de dados locais e de nuvem. Para obter mais informações , consulte as considerações e limitações de fluxos de dados.

Permissions

  • 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 as pré-requismissõ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. 

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows/{dataflowId}/datasources

Parâmetros de URI

Nome Em Obrigatório Tipo Description
dataflowId
 path True

string (uuid)

A ID do fluxo de dados

Respostas

Nome Tipo Description
200 OK

Datasources

OKEY

Exemplos

Example

Solicitação de exemplo

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows/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 em 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 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

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