Admin - Groups GetGroupUsersAsAdmin

  • Reference
Service:
Power BI REST APIs
API Version:
v1.0

Vrátí seznam uživatelů, kteří mají přístup k zadanému pracovnímu prostoru.

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á.

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/groups/{groupId}/users

Parametry identifikátoru URI

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

string

uuid

ID pracovního prostoru

Odpovědi

Name Typ Description
200 OK

GroupUsers

OK

Příklady

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

Sample Response

Status code:
200 
{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "groupUserAccessRight": "Admin",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    },
    {
      "displayName": "Adam Wood",
      "emailAddress": "Adam@contoso.com",
      "groupUserAccessRight": "Member",
      "identifier": "Adam@contoso.com",
      "graphId": "785e192c-0f1f-41ca-ae7a-a85da28e565a",
      "principalType": "User"
    },
    {
      "displayName": "ContosoTestApp",
      "groupUserAccessRight": "Admin",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "graphId": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

Definice

Name Description
GroupUser

Uživatel Power BI s přístupem k pracovnímu prostoru
GroupUserAccessRight

Přístupové právo (úroveň oprávnění), které má uživatel v pracovním prostoru
GroupUsers

Obálka odpovědi OData pro seznam uživatelů Power BI s přístupem k pracovnímu prostoru
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.

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 Graph. K dispozici pouze pro rozhraní API pro správu.
groupUserAccessRight

GroupUserAccessRight

Přístupové právo (úroveň oprávnění), které má uživatel v pracovním prostoru
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.

GroupUserAccessRight

Přístupové právo (úroveň oprávnění), které má uživatel v pracovním prostoru

Name Typ Description
Admin

string

Práva správce k obsahu pracovního prostoru
Contributor

string

Čtení a zkoumání (ReadExplore) přístup k obsahu pracovního prostoru
Member

string

Číst, znovu sdílet a zkoumat (ReadReshareExplore) přístupová práva k obsahu pracovního prostoru
None

string

Žádný přístup k obsahu pracovního prostoru
Viewer

string

Přístup jen pro čtení (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

GroupUser[]

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ží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