Sdílet prostřednictvím


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í

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
groupId
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

GroupUsers

OK

Příklady

Example

Sample Request

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

Sample Response

{
  "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
GroupUser

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

GroupUserAccessRight

Přístupová práva (úroveň oprávnění), která má uživatel k pracovnímu 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 Graphu. K dispozici pouze pro rozhraní API pro správu.

groupUserAccessRight

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

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

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