Partilhar via


Admin - Users GetUserArtifactAccessAsAdmin

Retorna uma lista de itens do Power BI (como relatórios ou painéis) aos quais o usuário especificado tem acesso.

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.

Escopo necessário

Tenant.Read.All ou Tenant.ReadWrite.All

Limitações

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

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess
GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess?continuationToken={continuationToken}&artifactTypes={artifactTypes}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
userId
path True

string

A ID do grafo ou o UPN (nome upn) do usuário

artifactTypes
query

string

Lista separada por vírgulas de tipos de artefato.

continuationToken
query

string

Token necessário para obter a próxima parte do conjunto de resultados

Respostas

Nome Tipo Description
200 OK

ArtifactAccessResponse

OK

Exemplos

Example
Example with artifactTypes
Example with Guest User
Example with UPN

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/artifactAccess

Sample Response

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with artifactTypes

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser@microsoft.com/artifactAccess?artifactTypes=Dataflow,Dashboard

Sample Response

{
  "artifactAccessEntities": [
    {
      "artifactId": "09ce06d1-e81b-fea0-1c6d-8fe3dd2f8e87",
      "displayName": "Test Dataflow",
      "artifactType": "Dataflow",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser%40microsoft.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with Guest User

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser_microsoft.com%23EXT%23@contoso.com/artifactAccess

Sample Response

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser_microsoft.com%23EXT%23%40contoso.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with UPN

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser@microsoft.com/artifactAccess

Sample Response

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser%40microsoft.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Definições

Nome Description
ArtifactAccessEntry

Uma entrada de acesso do usuário para um item do Power BI

ArtifactAccessResponse

O wrapper de resposta OData para uma lista de itens do Power BI (como relatórios ou painéis) que um usuário pode acessar

ArtifactType

O tipo de artefato

PrincipalType

O tipo de entidade de segurança

ServicePrincipalProfile

Um serviço do Power BI perfil principal. Relevante apenas para Power BI Embedded solução de várias locações.

User

Um usuário do Power BI

ArtifactAccessEntry

Uma entrada de acesso do usuário para um item do Power BI

Nome Tipo Description
accessRight

string

O direito de acesso que o usuário tem para o item do Power BI

artifactId

string

A ID do item do Power BI

artifactType

ArtifactType

O tipo de item do Power BI

displayName

string

O nome de exibição do item do Power BI

shareType

string

O tipo de como o acesso é fornecido ao item do Power BI. Disponível apenas para APIs de artefatos amplamente compartilhados.

sharer

User

O usuário que compartilhou o item do Power BI. Disponível apenas para APIs de artefatos amplamente compartilhados.

ArtifactAccessResponse

O wrapper de resposta OData para uma lista de itens do Power BI (como relatórios ou painéis) que um usuário pode acessar

Nome Tipo Description
artifactAccessEntities

ArtifactAccessEntry[]

A lista de itens do Power BI que um usuário pode acessar

continuationToken

string

O token para a próxima parte no conjunto de resultados

continuationUri

string

O URI da próxima parte no conjunto de resultados

odata.context

string

ArtifactType

O tipo de artefato

Nome Tipo Description
App

string

Aplicativos do Power BI

Capacity

string

Objeto capacity

Dashboard

string

Painel do Power BI

Dataflow

string

Fluxo de dados do Power BI

Dataset

string

Conjunto de Dados do Power BI

Group

string

Objeto de workspace compartilhado V1

PaginatedReport

string

Relatório Paginado do Power BI

PersonalGroup

string

Meu objeto de workspace

Report

string

Relatório do Power BI

Workspace

string

Objeto de workspace compartilhado

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

User

Um usuário do Power BI

Nome Tipo Description
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

PrincipalType

O tipo de entidade de segurança

profile

ServicePrincipalProfile

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.