Admin - Dataflows GetDataflowsAsAdmin
Retorna uma lista de fluxos de dados para a organização.
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/dataflows
GET https://api.powerbi.com/v1.0/myorg/admin/dataflows?$filter={$filter}&$top={$top}&$skip={$skip}
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
$filter
|
query |
string |
Filtra os resultados, com base em uma condição booliana |
|
$skip
|
query |
integer int32 |
Ignora os primeiros n resultados |
|
$top
|
query |
integer int32 |
Retorna apenas os primeiros n resultados |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OK |
Exemplos
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/dataflows
Sample Response
{
"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",
"configuredBy": "john@contoso.com",
"workspaceId": "6369a442-4bc4-425c-916d-460c42be746b"
}
]
}
Definições
Nome | Description |
---|---|
Admin |
Os metadados de um fluxo de dados retornados por APIs Administração. 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. |
Admin |
Wrapper de resposta OData para uma coleção de fluxo de dados do Power BI Administração |
Dataflow |
Uma entrada correta 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 de entidade de segurança |
Service |
Um serviço do Power BI perfil principal. Relevante apenas para Power BI Embedded solução de várias locações. |
AdminDataflow
Os metadados de um fluxo de dados retornados por APIs Administração. 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) |
modifiedBy |
string |
O usuário que modificou o fluxo de dados |
modifiedDateTime |
string |
A data e a hora em que o fluxo de dados foi modificado pela última vez |
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 carga em uma versão futura. Você pode recuperar informações do usuário em um fluxo de dados do Power BI usando a chamada Obter Usuários de Fluxo de Dados como Administração chamada à API ou a chamada à API PostWorkspaceInfo com o |
|
workspaceId |
string |
A ID do workspace do fluxo de dados. |
AdminDataflows
Wrapper de resposta OData para uma coleção de fluxo de dados do Power BI Administração
Nome | Tipo | Description |
---|---|---|
odata.context |
string |
Contexto OData |
value |
A coleção de relatórios |
DataflowUser
Uma entrada correta 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 apenas para APIs de administrador. |
identifier |
string |
Identificador da entidade de segurança |
principalType |
O tipo de entidade de segurança |
|
profile |
Um serviço do Power BI perfil principal. Relevante apenas para Power BI Embedded solução de várias locações. |
|
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 recompartilhamento 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 recompartilhamento 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 de entidade de segurança
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 para acesso em nível de organização inteiro. |
User |
string |
Tipo de entidade de usuário |
ServicePrincipalProfile
Um serviço do Power BI perfil principal. Relevante apenas para Power BI Embedded solução de várias locações.
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 |