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 |
---|---|---|---|---|
dataset
|
path | True |
string uuid |
ID datové sady |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
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 |
---|---|
Dataset |
Položka přístupového práva uživatele Power BI pro datovou sadu |
Dataset |
Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění) |
Dataset |
Obálka odpovědi OData pro seznam uživatelů Power BI s přístupem k datové sadě |
Principal |
Typ objektu zabezpečení |
Service |
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 |
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 |
Typ objektu zabezpečení |
|
profile |
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 |
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 |