Admin - Users GetUserArtifactAccessAsAdmin

Service:

Power BI REST APIs

Version d'API:

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 être un administrateur Fabric 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

Limitations

Maximum 200 requêtes par heure.

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess

Avec des paramètres facultatifs:

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	D’ACCORD

Exemples

Example

Example with artifactTypes

Example with Guest User

Example with UPN

Example

Exemple de requête

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

Exemple de réponse

Code d’état:

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

Exemple de requête

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

Exemple de réponse

Code d’état:

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

Exemple de requête

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

Exemple de réponse

Code d’état:

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

Exemple de requête

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

Exemple de réponse

Code d’état:

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 de principal
ServicePrincipalProfile	Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.
User	Un utilisateur Power BI

ArtifactAccessEntry

Object

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 complet de l’élément Power BI
shareType	string	Type de la façon dont l’accès est donné à 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

Object

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
@odata.context	string
artifactAccessEntities	ArtifactAccessEntry[]	Liste des éléments Power BI auxquels un utilisateur peut accéder
continuationToken	string	Jeton du bloc suivant dans le jeu de résultats
continuationUri	string	URI du bloc suivant dans le jeu de résultats

ArtifactType

Énumération

Type d’artefact

Valeur	Description
Report	Rapport Power BI
PaginatedReport	Rapport paginé Power BI
Dashboard	Tableau de bord Power BI
Dataset	Jeu de données Power BI
Dataflow	Flux de données Power BI
PersonalGroup	Mon objet d’espace de travail
Group	Objet d’espace de travail partagé V1
Workspace	Objet espace de travail partagé
Capacity	Objet Capacity
App	Applications Power BI

PrincipalType

Énumération

Type de principal

Valeur	Description
None	Aucun type de principal. Utiliser pour l’ensemble de l’accès au niveau de l’organisation.
User	Type de principal de l’utilisateur
Group	Type de principal de groupe
App	Type de principal de service

ServicePrincipalProfile

Object

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

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

User

Object

Un utilisateur Power BI

Nom	Type	Description
displayName	string	Nom complet 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 de principal
profile	ServicePrincipalProfile	Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.
userType	string	Type de l’utilisateur.