Admin - Users GetUserArtifactAccessAsAdmin

Služba:: Power BI REST APIs

Verze rozhraní API:: 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.

Povolení

Uživatel musí být správcem infrastruktury nebo se musí ověřit pomocí instančního objektu.
Delegovaná oprávnění jsou podporována.

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

S volitelnými parametry:

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	Čárkami oddělený seznam typů artefaktů
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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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 pro položku 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 instančního objektu Power BI. Platí jenom pro víceklientské řešení Power BI Embedded.
User	Uživatel Power BI

ArtifactAccessEntry

Objekt

Položka přístupu uživatele pro položku Power BI

Name	Typ	Description
accessRight	string	Přístupové právo, které má uživatel pro položku 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 způsobu, jakým má přístup k položce Power BI. K dispozici pouze pro rozhraní API široce sdílených artefaktů.
sharer	User	Uživatel, který položku Power BI sdílel. K dispozici pouze pro rozhraní API široce sdílených artefaktů.

ArtifactAccessResponse

Objekt

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
@odata.context	string
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ů

ArtifactType

Výčet

Typ artefaktu

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

PrincipalType

Výčet

Typ objektu zabezpečení

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

ServicePrincipalProfile

Objekt

Profil instančního objektu Power BI. Platí jenom pro víceklientské řešení Power BI Embedded.

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

User

Objekt

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 instančního objektu Power BI. Platí jenom pro víceklientské řešení Power BI Embedded.
userType	string	Typ uživatele

Sdílet prostřednictvím

Admin - Users GetUserArtifactAccessAsAdmin

Povolení

Požadovaný obor

Omezení

Parametry identifikátoru URI

Odpovědi

Příklady

Example

Ukázkový požadavek

Ukázková odpověď

Example with artifactTypes

Ukázkový požadavek

Ukázková odpověď

Example with Guest User

Ukázkový požadavek

Ukázková odpověď

Example with UPN

Ukázkový požadavek

Ukázková odpověď

Definice

ArtifactAccessEntry

ArtifactAccessResponse

ArtifactType

PrincipalType

ServicePrincipalProfile

User