Admin - Users GetUserArtifactAccessAsAdmin

Referência

Service:: Power BI REST APIs

API Version:: v1.0

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

With optional parameters:

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

Status code:: 200

{
  "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

Status code:: 200

{
  "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

Status code:: 200

{
  "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

Status code:: 200

{
  "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.

Partilhar via

Admin - Users GetUserArtifactAccessAsAdmin

Permissões

Escopo necessário

Limitações

Parâmetros de URI

Respostas

Exemplos

Example

Sample Request

Sample Response

Example with artifactTypes

Sample Request

Sample Response

Example with Guest User

Sample Request

Sample Response

Example with UPN

Sample Request

Sample Response

Definições

ArtifactAccessEntry

ArtifactAccessResponse

ArtifactType

PrincipalType

ServicePrincipalProfile

User

Recursos adicionais