Groups - Get Group Users

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

Permissions

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 usłudze Power BI Embedded.

Wymagany zakres

Workspace.Read.All lub Workspace.ReadWrite.All

Ograniczenia

• Czas aktualizacji uprawnień użytkownika dla obszarów roboczych i może nie być natychmiast dostępny podczas korzystania z wywołań interfejsu API. Aby odświeżyć uprawnienia użytkownika, użyj wywołania interfejsu API Odświeżanie uprawnień użytkownika .
  
  

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

Odpowiedzi

Przykłady

Example

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

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

GroupUser

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

GroupUserAccessRight

Prawo dostępu (poziom uprawnień), który 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 jednostki usługi Power BI. Dotyczy tylko rozwiązania z wieloma dzierżawami usługi Power BI Embedded.