Udostępnij za pośrednictwem


Admin - Users GetUserArtifactAccessAsAdmin

Zwraca listę elementów usługi Power BI (takich jak raporty lub pulpity nawigacyjne), do których określony użytkownik ma dostęp.

Uprawnienia

  • Użytkownik musi mieć uprawnienia administratora (takie jak administrator globalny Office 365 lub administrator usługi Power BI) lub uwierzytelnić się przy użyciu jednostki usługi.
  • Uprawnienia delegowane są obsługiwane.

Wymagany zakres

Tenant.Read.All lub Tenant.ReadWrite.All

Ograniczenia

Maksymalna liczba żądań na godzinę wynosi 200.

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess
GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess?continuationToken={continuationToken}&artifactTypes={artifactTypes}

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
userId
path True

string

Identyfikator grafu lub główna nazwa użytkownika (UPN) użytkownika

artifactTypes
query

string

Rozdzielona przecinkami lista typów artefaktów.

continuationToken
query

string

Token wymagany do pobrania następnego fragmentu zestawu wyników

Odpowiedzi

Nazwa Typ Opis
200 OK

ArtifactAccessResponse

OK

Przykłady

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

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

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

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

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

Definicje

Nazwa Opis
ArtifactAccessEntry

Wpis dostępu użytkownika dla elementu usługi Power BI

ArtifactAccessResponse

Otoka odpowiedzi OData dla listy elementów usługi Power BI (takich jak raporty lub pulpity nawigacyjne), do których użytkownik może uzyskać dostęp

ArtifactType

Typ artefaktu

PrincipalType

Typ podmiotu zabezpieczeń

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

User

Użytkownik usługi Power BI

ArtifactAccessEntry

Wpis dostępu użytkownika dla elementu usługi Power BI

Nazwa Typ Opis
accessRight

string

Prawo dostępu, które użytkownik ma dla elementu usługi Power BI

artifactId

string

Identyfikator elementu usługi Power BI

artifactType

ArtifactType

Typ elementu usługi Power BI

displayName

string

Nazwa wyświetlana elementu usługi Power BI

shareType

string

Typ sposobu uzyskiwania dostępu do elementu usługi Power BI. Dostępne tylko dla powszechnie udostępnionych interfejsów API artefaktów.

sharer

User

Użytkownik, który udostępnił element usługi Power BI. Dostępne tylko dla powszechnie udostępnionych interfejsów API artefaktów.

ArtifactAccessResponse

Otoka odpowiedzi OData dla listy elementów usługi Power BI (takich jak raporty lub pulpity nawigacyjne), do których użytkownik może uzyskać dostęp

Nazwa Typ Opis
artifactAccessEntities

ArtifactAccessEntry[]

Lista elementów usługi Power BI, do których użytkownik może uzyskać dostęp

continuationToken

string

Token dla następnego fragmentu w zestawie wyników

continuationUri

string

Identyfikator URI następnego fragmentu w zestawie wyników

odata.context

string

ArtifactType

Typ artefaktu

Nazwa Typ Opis
App

string

Aplikacje usługi Power BI

Capacity

string

Obiekt pojemności

Dashboard

string

Pulpit nawigacyjny usługi Power BI

Dataflow

string

Przepływ danych usługi Power BI

Dataset

string

Zestaw danych usługi Power BI

Group

string

Obiekt udostępnionego obszaru roboczego w wersji 1

PaginatedReport

string

Raport podzielony na strony usługi Power BI

PersonalGroup

string

Mój obiekt obszaru roboczego

Report

string

Raport usługi Power BI

Workspace

string

Obiekt udostępnionego obszaru roboczego

PrincipalType

Typ podmiotu zabezpieczeń

Nazwa Typ Opis
App

string

Typ jednostki usługi

Group

string

Typ podmiotu zabezpieczeń grupy

None

string

Brak typu podmiotu zabezpieczeń. Służy do uzyskiwania dostępu na poziomie całej organizacji.

User

string

Typ podmiotu zabezpieczeń użytkownika

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

Nazwa Typ Opis
displayName

string

Nazwa profilu jednostki usługi

id

string

Identyfikator profilu jednostki usługi

User

Użytkownik usługi Power BI

Nazwa Typ Opis
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń

emailAddress

string

Adres e-mail użytkownika

graphId

string

Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratora.

identifier

string

Identyfikator podmiotu zabezpieczeń

principalType

PrincipalType

Typ podmiotu zabezpieczeń

profile

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

userType

string

Typ użytkownika.