Admin - Users GetUserArtifactAccessAsAdmin

Référence

Service:: Power BI REST APIs

API Version:: v1.0

Retourne une liste d’éléments Power BI (tels que des rapports ou des tableaux de bord) auxquels l’utilisateur spécifié a accès.

Autorisations

L’utilisateur doit disposer de droits d’administrateur (tels que Office 365 administrateur général ou administrateur de service Power BI) ou s’authentifier à l’aide d’un principal de service.
Les autorisations déléguées sont prises en charge.

Étendue requise

Tenant.Read.All ou Tenant.ReadWrite.All

Limites

Maximum 200 requêtes par heure.

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}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
userId	path	True	string	ID de graphique ou nom d’utilisateur principal (UPN) de l’utilisateur
artifactTypes	query		string	Liste séparée par des virgules des types d’artefacts.
continuationToken	query		string	Jeton requis pour obtenir le segment suivant du jeu de résultats

Réponses

Nom	Type	Description
200 OK	ArtifactAccessResponse	Ok

Exemples

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

Définitions

Nom	Description
ArtifactAccessEntry	Entrée d’accès utilisateur pour un élément Power BI
ArtifactAccessResponse	Wrapper de réponse OData pour une liste d’éléments Power BI (tels que des rapports ou des tableaux de bord) auxquels un utilisateur peut accéder
ArtifactType	Type d’artefact
PrincipalType	Type principal
ServicePrincipalProfile	Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.
User	Un utilisateur Power BI

ArtifactAccessEntry

Entrée d’accès utilisateur pour un élément Power BI

Nom	Type	Description
accessRight	string	Droit d’accès dont dispose l’utilisateur pour l’élément Power BI
artifactId	string	ID d’élément Power BI
artifactType	ArtifactType	Type d’élément Power BI
displayName	string	Nom d’affichage de l’élément Power BI
shareType	string	Type de la façon dont l’accès est accordé à l’élément Power BI. Disponible uniquement pour les API d’artefacts largement partagés.
sharer	User	Utilisateur qui a partagé l’élément Power BI. Disponible uniquement pour les API d’artefacts largement partagés.

ArtifactAccessResponse

Wrapper de réponse OData pour une liste d’éléments Power BI (tels que des rapports ou des tableaux de bord) auxquels un utilisateur peut accéder

Nom	Type	Description
artifactAccessEntities	ArtifactAccessEntry[]	Liste des éléments Power BI auxquels un utilisateur peut accéder
continuationToken	string	Jeton du segment suivant dans le jeu de résultats
continuationUri	string	URI du segment suivant dans le jeu de résultats
odata.context	string

ArtifactType

Type d’artefact

Nom	Type	Description
App	string	Applications Power BI
Capacity	string	Objet De capacité
Dashboard	string	tableau de bord Power BI
Dataflow	string	Flux de données Power BI
Dataset	string	Jeu de données Power BI
Group	string	Objet d’espace de travail partagé V1
PaginatedReport	string	Rapport paginé Power BI
PersonalGroup	string	Objet Mon espace de travail
Report	string	Rapport Power BI
Workspace	string	Objet d’espace de travail partagé

PrincipalType

Type principal

Nom	Type	Description
App	string	Type de principal de service
Group	string	Type de principal de groupe
None	string	Aucun type principal. Utilisez pour un accès de niveau organization entier.
User	string	Type de principal d’utilisateur

ServicePrincipalProfile

Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.

Nom	Type	Description
displayName	string	Nom du profil principal de service
id	string	ID de profil du principal de service

User

Un utilisateur Power BI

Nom	Type	Description
displayName	string	Nom d’affichage du principal
emailAddress	string	Adresse e-mail de l’utilisateur
graphId	string	Identificateur du principal dans Microsoft Graph. Disponible uniquement pour les API d’administration.
identifier	string	Identificateur du principal
principalType	PrincipalType	Type principal
profile	ServicePrincipalProfile	Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.
userType	string	Type de l’utilisateur.

Partager via

Admin - Users GetUserArtifactAccessAsAdmin

Autorisations

Étendue requise

Limites

Paramètres URI

Réponses

Exemples

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

Définitions

ArtifactAccessEntry

ArtifactAccessResponse

ArtifactType

PrincipalType

ServicePrincipalProfile

User

Ressources supplémentaires