Groups - Get Group Users
Vrátí seznam uživatelů, kteří mají přístup k zadanému pracovnímu prostoru.
Oprávnění
Toto volání rozhraní API může volat profil instančního objektu. Další informace najdete v tématu Profily instančních objektů v Power BI Embedded.
Požadovaný obor
Workspace.Read.All nebo Workspace.ReadWrite.All
Omezení
- Aktualizace uživatelských oprávnění pro pracovní prostory chvíli trvá a při volání rozhraní API nemusí být okamžitě dostupná. Pokud chcete aktualizovat uživatelská oprávnění, použijte volání rozhraní API Pro aktualizaci uživatelských oprávnění .
GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users
GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users?$top={$top}&$skip={$skip}
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
group
|
path | True |
string uuid |
ID pracovního prostoru |
$skip
|
query |
integer int32 |
Přeskočí prvních n výsledků. |
|
$top
|
query |
integer int32 |
Vrátí pouze prvních n výsledků. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
Příklady
Example
Ukázkový požadavek
GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
Ukázková odpověď
{
"value": [
{
"displayName": "John Nick",
"emailAddress": "john@contoso.com",
"groupUserAccessRight": "Admin",
"identifier": "john@contoso.com",
"principalType": "User"
},
{
"displayName": "Adam Wood",
"emailAddress": "Adam@contoso.com",
"groupUserAccessRight": "Member",
"identifier": "Adam@contoso.com",
"principalType": "User"
},
{
"displayName": "ContosoTestApp",
"groupUserAccessRight": "Admin",
"identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
"principalType": "App"
}
]
}
Definice
Name | Description |
---|---|
Group |
Uživatel Power BI s přístupem k pracovnímu prostoru |
Group |
Přístupová práva (úroveň oprávnění), která má uživatel k pracovnímu prostoru |
Group |
Obálka odpovědi OData pro seznam uživatelů Power BI s přístupem k pracovnímu prostoru |
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. |
GroupUser
Uživatel Power BI s přístupem k pracovnímu prostoru
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. |
groupUserAccessRight |
Přístupová práva (úroveň oprávnění), která má uživatel k pracovnímu prostoru |
|
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. |
GroupUserAccessRight
Přístupová práva (úroveň oprávnění), která má uživatel k pracovnímu prostoru
Name | Typ | Description |
---|---|---|
Admin |
string |
Práva správce k obsahu pracovního prostoru |
Contributor |
string |
Čtení a zkoumání přístupu (ReadExplore) k obsahu pracovního prostoru |
Member |
string |
Číst, sdílet a zkoumat přístupová práva (ReadReshareExplore) k obsahu pracovního prostoru |
None |
string |
Žádný přístup k obsahu pracovního prostoru |
Viewer |
string |
Přístup jen pro čtení k obsahu pracovního prostoru |
GroupUsers
Obálka odpovědi OData pro seznam uživatelů Power BI s přístupem k pracovnímu prostoru
Name | Typ | Description |
---|---|---|
odata.context |
string |
|
value |
Seznam uživatelů s přístupem k pracovnímu prostoru |
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žijte 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 |