Sdílet prostřednictvím


Admin - Datasets GetDatasetUsersAsAdmin

Vrátí seznam uživatelů, kteří mají přístup k zadané datové sadě.

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á.
  • Oprávnění pro toto volání rozhraní API jsou uvedená v části Oprávnění datových sad.

Při spuštění v rámci původního ověřování služby nesmí mít aplikace v Azure Portal nastavené žádné předpoklady vyžadované správcem pro Power BI.

Požadovaný obor

Tenant.Read.All nebo Tenant.ReadWrite.All

Relevantní pouze při ověřování prostřednictvím standardního delegovaného přístupového tokenu správce. Nesmí být k dispozici při použití ověřování prostřednictvím instančního objektu.

Omezení

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

GET https://api.powerbi.com/v1.0/myorg/admin/datasets/{datasetId}/users

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
datasetId
path True

string

uuid

ID datové sady

Odpovědi

Name Typ Description
200 OK

DatasetUsers

OK

Příklady

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/datasets/{datasetId}/users

Sample Response

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "datasetUserAccessRight": "ReadWriteReshareExplore",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

Definice

Name Description
DatasetUser

Položka přístupového práva uživatele Power BI pro datovou sadu

DatasetUserAccessRight

Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)

DatasetUsers

Obálka odpovědi OData pro seznam uživatelů Power BI s přístupem k datové sadě

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.

DatasetUser

Položka přístupového práva uživatele Power BI pro datovou sadu

Name Typ Description
datasetUserAccessRight

DatasetUserAccessRight

Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)

displayName

string

Zobrazovaný název objektu zabezpečení

emailAddress

string

E-mailová adresa uživatele

graphId

string

Identifikátor objektu zabezpečení v Microsoft Graph. 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.

DatasetUserAccessRight

Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)

Name Typ Description
None

string

Odebere oprávnění k obsahu v datové sadě.

Read

string

Udělí oprávnění ke čtení obsahu v datové sadě.

ReadExplore

string

Udělí přístup ke čtení a prozkoumání obsahu v datové sadě.

ReadReshare

string

Uděluje přístup ke čtení a sdílení obsahu v datové sadě.

ReadReshareExplore

string

Uděluje přístup ke čtení, sdílení a prozkoumání obsahu v datové sadě.

ReadWrite

string

Uděluje přístup ke čtení a zápisu k obsahu v datové sadě.

ReadWriteExplore

string

Uděluje přístup ke čtení, zápisu a prozkoumání obsahu v datové sadě.

ReadWriteReshare

string

Uděluje přístup ke čtení, zápisu a sdílení obsahu v datové sadě.

ReadWriteReshareExplore

string

Uděluje přístup ke čtení, zápisu, sdílení a prozkoumání obsahu v datové sadě.

DatasetUsers

Obálka odpovědi OData pro seznam uživatelů Power BI s přístupem k datové sadě

Name Typ Description
odata.context

string

value

DatasetUser[]

Seznam uživatelů s přístupem k datové sadě

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