Partilhar via

Admin - Groups AddUserAsAdmin

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

Concede permissões de usuário ao workspace especificado.

Essa chamada de API só dá suporte à adição de um usuário, grupo de segurança, grupo M365 e entidade de serviço.

Permissões

O usuário deve ser um administrador do Fabric.

Escopo necessário

Tenant.ReadWrite.All

Limitações

  • Máximo de 200 solicitações por hora.
  • Cada workspace é limitado a um máximo de 1.000 usuários ou grupos em funções de workspace (Administrador, Membro, Colaborador, Visualizador). O número de usuários em um grupo não é limitado. A limitação também abrange convidados externos. 

POST 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

Corpo da solicitação

Nome Obrigatório Tipo Description
groupUserAccessRight True

GroupUserAccessRight

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

string

Identificador da entidade de segurança
principalType True

PrincipalType

O tipo principal
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.
profile

ServicePrincipalProfile

Um perfil de entidade de serviço do Power BI. Relevante apenas para solução de vários locatários do Power BI Embedded.
userType

string

Tipo do usuário.

Respostas

Nome Tipo Description
200 OK

OKEY

Exemplos

Add security group to workspace example
Add service principal to workspace example
Add user to group example

Add security group to workspace example

Solicitação de exemplo

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users
Corpo da solicitação
{
  "identifier": "ece007fa-2f19-4df1-bdd5-539881ec5f83",
  "principalType": "Group",
  "groupUserAccessRight": "Member"
}

Resposta de exemplo

Código de status:
200

Add service principal to workspace example

Solicitação de exemplo

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users
Corpo da solicitação
{
  "identifier": "84c468ad-12f1-471e-af6f-0999da422391",
  "principalType": "App",
  "groupUserAccessRight": "Viewer"
}

Resposta de exemplo

Código de status:
200

Add user to group example

Solicitação de exemplo

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users
Corpo da solicitação
{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Resposta de exemplo

Código de status:
200

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
PrincipalType

O tipo principal
ServicePrincipalProfile

Um perfil de entidade de serviço do Power BI. Relevante apenas para solução de vários locatários 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 solução de vários locatários 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

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 solução de vários locatários 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