Dataflows - Get Dataflows
Retorna uma lista de todos os fluxos de dados do workspace especificado.
Permissões
Essa chamada à API pode ser chamada por um perfil de entidade de serviço. Para obter mais informações, consulte: Perfis de entidade de serviço no Power BI Embedded.
Escopo necessário
Dataflow.ReadWrite.All ou Dataflow.Read.All
GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
group
|
path | True |
string uuid |
A ID do workspace |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OKEY |
Exemplos
Example
Solicitação de exemplo
GET https://api.powerbi.com/v1.0/myorg/groups/a2f89923-421a-464e-bf4c-25eab39bb09f/dataflows
Resposta de exemplo
{
"value": [
{
"objectId": "bd32e5c0-363f-430b-a03b-5535a4804b9b",
"name": "AdventureWorks",
"description": "Our Adventure Works",
"modelUrl": "https://MyDataflowStorageAccount.dfs.core.windows.net/powerbi/contoso/AdventureWorks/model.json"
}
]
}
Definições
Nome | Description |
---|---|
Dataflow |
Os metadados de um fluxo de dados. Veja abaixo uma lista de propriedades que podem ser retornadas para um fluxo de dados. Somente um subconjunto das propriedades será retornado dependendo da API chamada, das permissões de chamador e da disponibilidade dos dados no banco de dados do Power BI. |
Dataflows |
Wrapper de resposta OData para uma lista de metadados de fluxo de dados |
Dataflow |
Uma entrada certa de acesso de usuário do Power BI para um fluxo de dados |
Dataflow |
O direito de acesso que um usuário tem para o fluxo de dados (nível de permissão) |
Principal |
O tipo principal |
Service |
Um perfil de entidade de serviço do Power BI. Relevante apenas para solução de vários locatários do Power BI Embedded. |
Dataflow
Os metadados de um fluxo de dados. Veja abaixo uma lista de propriedades que podem ser retornadas para um fluxo de dados. Somente um subconjunto das propriedades será retornado dependendo da API chamada, das permissões de chamador e da disponibilidade dos dados no banco de dados do Power BI.
Nome | Tipo | Description |
---|---|---|
configuredBy |
string |
O proprietário do fluxo de dados |
description |
string |
A descrição do fluxo de dados |
modelUrl |
string |
Uma URL para o arquivo de definição de fluxo de dados (model.json) |
name |
string |
O nome do fluxo de dados |
objectId |
string |
A ID do fluxo de dados |
users |
(Valor vazio) Os detalhes de acesso do usuário do fluxo de dados. Essa propriedade será removida da resposta de conteúdo em uma versão futura. Você pode recuperar informações do usuário sobre um fluxo de dados do Power BI usando a chamada |
Dataflows
Wrapper de resposta OData para uma lista de metadados de fluxo de dados
Nome | Tipo | Description |
---|---|---|
@odata.context |
string |
|
value |
Dataflow[] |
A lista de metadados do fluxo de dados |
DataflowUser
Uma entrada certa de acesso de usuário do Power BI para um fluxo de dados
Nome | Tipo | Description |
---|---|---|
DataflowUserAccessRight |
O direito de acesso que um usuário tem para o fluxo de dados (nível de permissão) |
|
displayName |
string |
Nome de exibição da entidade de segurança |
emailAddress |
string |
Endereço de email do usuário |
graphId |
string |
Identificador da entidade de segurança no Microsoft Graph. Disponível somente para APIs de administrador. |
identifier |
string |
Identificador da entidade de segurança |
principalType |
O tipo principal |
|
profile |
Um perfil de entidade de serviço do Power BI. Relevante apenas para solução de vários locatários do Power BI Embedded. |
|
userType |
string |
Tipo do usuário. |
DataflowUserAccessRight
O direito de acesso que um usuário tem para o fluxo de dados (nível de permissão)
Nome | Tipo | Description |
---|---|---|
None |
string |
Remove a permissão para o conteúdo no fluxo de dados |
Owner |
string |
Concede acesso de leitura, gravação e compartilhamento ao conteúdo no fluxo de dados |
Read |
string |
Concede acesso de leitura ao conteúdo no fluxo de dados |
ReadReshare |
string |
Concede acesso de leitura e compartilhamento ao conteúdo no fluxo de dados |
ReadWrite |
string |
Concede acesso de leitura e gravação ao conteúdo no fluxo de dados |
PrincipalType
O tipo principal
Nome | Tipo | Description |
---|---|---|
App |
string |
Tipo de entidade de serviço |
Group |
string |
Tipo de entidade de grupo |
None |
string |
Nenhum tipo de entidade de segurança. Use todo o acesso ao nível da organização. |
User |
string |
Tipo de entidade de usuário |
ServicePrincipalProfile
Um perfil de entidade de serviço do Power BI. Relevante apenas para solução de vários locatários do Power BI Embedded.
Nome | Tipo | Description |
---|---|---|
displayName |
string |
O nome do perfil da entidade de serviço |
id |
string |
A ID do perfil da entidade de serviço |