Partilhar via

Admin - Groups GetGroupUsersAsAdmin

Serviço:
Power BI REST APIs
Versão da API:
v1.0

Retorna uma lista de usuários que têm acesso ao workspace especificado.

Permissions

  • O usuário deve ser um administrador do Fabric ou autenticar usando uma entidade de serviço.
  • Há suporte para permissões delegadas.

Ao executar em autenticação prinicipal de serviço, um aplicativo não deve ter as pré-requismissões necessárias de consentimento do administrador para o Power BI definidas nele no portal do Azure.

Escopo necessário

Tenant.Read.All ou Tenant.ReadWrite.All

Relevante somente ao autenticar por meio de um token de acesso de administrador delegado padrão. Não deve estar presente quando a autenticação por meio de uma entidade de serviço é usada.

Limitações

Máximo de 200 solicitações por hora. 

GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users

Parâmetros de URI

Nome Em Obrigatório Tipo Description
groupId
 path True

string (uuid)

A ID do workspace

Respostas

Nome Tipo Description
200 OK

GroupUsers

OKEY

Exemplos

Example

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
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"
    }
  ]
}

Definições

Nome Description
GroupUser

Um usuário do Power BI com acesso ao workspace
GroupUserAccessRight

O direito de acesso (nível de permissão) que um usuário tem no workspace
GroupUsers

O wrapper de resposta OData para uma lista de usuários do Power BI com acesso a um workspace
PrincipalType

O tipo principal
ServicePrincipalProfile

Um perfil de entidade de serviço do Power BI. Relevante apenas para a solução de multilocação do Power BI Embedded.

GroupUser

Objeto

Um usuário do Power BI com acesso ao workspace

Nome Tipo Description
displayName

string

Nome de exibição da entidade de segurança
emailAddress

string

Endereço de email do usuário
graphId

string

Identificador da entidade de segurança no Microsoft Graph. Disponível somente para APIs de administrador.
groupUserAccessRight

GroupUserAccessRight

O direito de acesso (nível de permissão) que um usuário tem no workspace
identifier

string

Identificador da entidade de segurança
principalType

PrincipalType

O tipo principal
profile

ServicePrincipalProfile

Um perfil de entidade de serviço do Power BI. Relevante apenas para a solução de multilocação do Power BI Embedded.
userType

string

Tipo do usuário.

GroupUserAccessRight

Enumeração

O direito de acesso (nível de permissão) que um usuário tem no workspace

Valor Description
None

Sem acesso ao conteúdo do workspace
Member

Direitos de acesso de leitura, recompartilhamento e exploração (ReadReshareExplore) ao conteúdo do workspace
Admin

Direitos de administrador para o conteúdo do workspace
Contributor

Acesso de leitura e exploração (ReadExplore) ao conteúdo do workspace
Viewer

Acesso somente leitura (leitura) ao conteúdo do workspace

GroupUsers

Objeto

O wrapper de resposta OData para uma lista de usuários do Power BI com acesso a um workspace

Nome Tipo Description
@odata.context

string

value

GroupUser[]

A lista de usuários com acesso a um workspace

PrincipalType

Enumeração

O tipo principal

Valor Description
None

Nenhum tipo de entidade de segurança. Use todo o acesso ao nível da organização.
User

Tipo de entidade de usuário
Group

Tipo de entidade de grupo
App

Tipo de entidade de serviço

ServicePrincipalProfile

Objeto

Um perfil de entidade de serviço do Power BI. Relevante apenas para a solução de multilocação do Power BI Embedded.

Nome Tipo Description
displayName

string

O nome do perfil da entidade de serviço
id

string (uuid)

A ID do perfil da entidade de serviço