Udostępnij za pośrednictwem


Groups - Get Group Users

Zwraca listę użytkowników, którzy mają dostęp do określonego obszaru roboczego.

Uprawnienia

To wywołanie interfejsu API może być wywoływane przez profil jednostki usługi. Aby uzyskać więcej informacji, zobacz: Profile jednostki usługi w Power BI Embedded.

Zakres wymagany

Workspace.Read.All lub Workspace.ReadWrite.All

Ograniczenia

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 identyfikatora URI

Nazwa W Wymagane Typ Opis
groupId
path True

string

uuid

Identyfikator obszaru roboczego

$skip
query

integer

int32

Pomija pierwsze n wyników

$top
query

integer

int32

Zwraca tylko pierwsze n wyników

Odpowiedzi

Nazwa Typ Opis
200 OK

GroupUsers

OK

Przykłady

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"
    }
  ]
}

Definicje

Nazwa Opis
GroupUser

Użytkownik usługi Power BI z dostępem do obszaru roboczego

GroupUserAccessRight

Prawo dostępu (poziom uprawnień), które użytkownik ma w obszarze roboczym

GroupUsers

Otoka odpowiedzi OData dla listy użytkowników usługi Power BI z dostępem do obszaru roboczego

PrincipalType

Typ podmiotu zabezpieczeń

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

GroupUser

Użytkownik usługi Power BI z dostępem do obszaru roboczego

Nazwa Typ Opis
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń

emailAddress

string

Adres e-mail użytkownika

graphId

string

Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratora.

groupUserAccessRight

GroupUserAccessRight

Prawo dostępu (poziom uprawnień), które użytkownik ma w obszarze roboczym

identifier

string

Identyfikator podmiotu zabezpieczeń

principalType

PrincipalType

Typ podmiotu zabezpieczeń

profile

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

userType

string

Typ użytkownika.

GroupUserAccessRight

Prawo dostępu (poziom uprawnień), które użytkownik ma w obszarze roboczym

Nazwa Typ Opis
Admin

string

Prawa administratora do zawartości obszaru roboczego

Contributor

string

Odczyt i eksplorowanie (ReadExplore) — dostęp do zawartości obszaru roboczego

Member

string

Prawa dostępu do zawartości obszaru roboczego można odczytywać, udostępniać dalej i eksplorować (ReadReshareExplore)

None

string

Brak dostępu do zawartości obszaru roboczego

Viewer

string

Dostęp tylko do odczytu (odczyt) do zawartości obszaru roboczego

GroupUsers

Otoka odpowiedzi OData dla listy użytkowników usługi Power BI z dostępem do obszaru roboczego

Nazwa Typ Opis
odata.context

string

value

GroupUser[]

Lista użytkowników z dostępem do obszaru roboczego

PrincipalType

Typ podmiotu zabezpieczeń

Nazwa Typ Opis
App

string

Typ jednostki usługi

Group

string

Typ podmiotu zabezpieczeń grupy

None

string

Brak typu podmiotu zabezpieczeń. Służy do uzyskiwania dostępu na poziomie całej organizacji.

User

string

Typ podmiotu zabezpieczeń użytkownika

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

Nazwa Typ Opis
displayName

string

Nazwa profilu jednostki usługi

id

string

Identyfikator profilu jednostki usługi