Admin - Users GetUserArtifactAccessAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Vrátí seznam položek Power BI (například sestav nebo řídicích panelů), ke kterým má zadaný uživatel přístup.

Oprávnění

• Uživatel musí mít oprávnění správce (například Office 365 globálního správce nebo správce služby Power BI) nebo ověřování pomocí instančního objektu.
• Delegovaná oprávnění jsou podporovaná.

Požadovaný obor

Tenant.Read.All nebo Tenant.ReadWrite.All

Omezení

Maximálně 200 požadavků za hodinu.

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}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
userId	path	True	string	ID grafu nebo hlavní název uživatele (UPN) uživatele
artifactTypes	query		string	Seznam typů artefaktů oddělených čárkami
continuationToken	query		string	Token potřebný k získání dalšího bloku sady výsledků

Odpovědi

Name	Typ	Description
200 OK	ArtifactAccessResponse	OK

Příklady

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

Definice

Name	Description
ArtifactAccessEntry	Položka přístupu uživatele k položce Power BI
ArtifactAccessResponse	Obálka odpovědi OData pro seznam položek Power BI (například sestav nebo řídicích panelů), ke kterým má uživatel přístup
ArtifactType	Typ artefaktu
PrincipalType	Typ objektu zabezpečení
ServicePrincipalProfile	Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
User	Uživatel Power BI

ArtifactAccessEntry

Položka přístupu uživatele k položce Power BI

Name	Typ	Description
accessRight	string	Přístupové právo, které má uživatel k položce Power BI
artifactId	string	ID položky Power BI
artifactType	ArtifactType	Typ položky Power BI
displayName	string	Zobrazovaný název položky Power BI
shareType	string	Typ přístupu k položce Power BI. K dispozici pouze pro rozhraní API široce sdílených artefaktů.
sharer	User	Uživatel, který sdílel položku Power BI. K dispozici pouze pro rozhraní API široce sdílených artefaktů.

ArtifactAccessResponse

Obálka odpovědi OData pro seznam položek Power BI (například sestav nebo řídicích panelů), ke kterým má uživatel přístup

Name	Typ	Description
artifactAccessEntities	ArtifactAccessEntry[]	Seznam položek Power BI, ke kterým má uživatel přístup
continuationToken	string	Token pro další blok dat v sadě výsledků
continuationUri	string	Identifikátor URI dalšího bloku dat v sadě výsledků
odata.context	string

ArtifactType

Typ artefaktu

Name	Typ	Description
App	string	Aplikace Power BI
Capacity	string	Objekt kapacity
Dashboard	string	Řídicí panel Power BI
Dataflow	string	Tok dat Power BI
Dataset	string	Datová sada Power BI
Group	string	Objekt sdíleného pracovního prostoru V1
PaginatedReport	string	Stránkovaná sestava Power BI
PersonalGroup	string	Můj objekt pracovního prostoru
Report	string	Sestava Power BI
Workspace	string	Objekt sdíleného pracovního prostoru

PrincipalType

Typ objektu zabezpečení

Name	Typ	Description
App	string	Typ instančního objektu
Group	string	Typ objektu zabezpečení skupiny
None	string	Žádný typ objektu zabezpečení. Používá se pro přístup na úrovni celé organizace.
User	string	Typ objektu zabezpečení uživatele

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

Name	Typ	Description
displayName	string	Název profilu instančního objektu
id	string	ID profilu instančního objektu

User

Uživatel Power BI

Name	Typ	Description
displayName	string	Zobrazovaný název objektu zabezpečení
emailAddress	string	E-mailová adresa uživatele
graphId	string	Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.
identifier	string	Identifikátor objektu zabezpečení
principalType	PrincipalType	Typ objektu zabezpečení
profile	ServicePrincipalProfile	Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
userType	string	Typ uživatele.