Admin - Datasets GetDatasetUsersAsAdmin

Služba:

Power BI REST APIs

Verze rozhraní API:

v1.0

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

Dovolení

• 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.
• Oprávnění pro toto volání rozhraní API jsou uvedená v oprávnění datové sady.

Při spuštění v rámci ověřování prinicipal služby nesmí aplikace nesmí mít na webu Azure Portal nastavené žádné žádosti o udělení souhlasu správce 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. Při ověřování pomocí instančního objektu nesmí být k dispozici.

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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

200

{
  "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	Přístup uživatele Power BI ke správné položce pro datovou sadu
DatasetUserAccessRight	Přístupové právo, které má uživatel pro datovou sadu (ú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 instančního objektu Power BI. Relevantní pouze pro víceklientské řešení Power BI Embedded.

DatasetUser

Objekt

Přístup uživatele Power BI ke správné položce pro datovou sadu

Name	Typ	Description
datasetUserAccessRight	DatasetUserAccessRight	Přístupové právo, které má uživatel pro datovou sadu (ú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 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. Relevantní pouze pro víceklientské řešení Power BI Embedded.
userType	string	Typ uživatele

DatasetUserAccessRight

Výčet

Přístupové právo, které má uživatel pro datovou sadu (úroveň oprávnění)

Hodnota	Description
None	Odebere oprávnění k obsahu v datové sadě.
Read	Uděluje přístup pro čtení k obsahu v datové sadě.
ReadWrite	Uděluje přístup pro čtení a zápis k obsahu v datové sadě.
ReadReshare	Uděluje přístup ke čtení a opětovnému sdílení obsahu v datové sadě.
ReadWriteReshare	Uděluje přístup ke čtení, zápisu a opětovnému sdílení obsahu v datové sadě.
ReadExplore	Uděluje přístup ke čtení a prozkoumání obsahu v datové sadě.
ReadReshareExplore	Uděluje přístup ke čtení, opětovnému sdílení a prozkoumání obsahu v datové sadě.
ReadWriteExplore	Uděluje přístup ke čtení, zápisu a prozkoumání obsahu v datové sadě.
ReadWriteReshareExplore	Uděluje přístup ke čtení, zápisu, opětovnému sdílení a prozkoumání přístupu k obsahu v datové sadě.

DatasetUsers

Objekt

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

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. Relevantní pouze 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