Groups - Add Group User

Concede al usuario especificado los permisos especificados al área de trabajo especificada.

Permisos

Un perfil de entidad de servicio puede llamar a esta llamada API. Para obtener más información, consulte: perfiles de entidad de servicio de en Power BI Embedded.

Ámbito requerido

Workspace.ReadWrite.All

Limitaciones

• Los permisos de usuario para las áreas de trabajo tardan tiempo en actualizarse y es posible que no estén disponibles inmediatamente al usar llamadas API. Para actualizar los permisos de usuario, use la llamada API de Actualizar permisos de usuario.
• Cada área de trabajo se limita a un máximo de 1000 usuarios o grupos en roles de área de trabajo (Administrador, Miembro, Colaborador, Visor). El número de usuarios dentro de un grupo no está limitado. La limitación también cubre invitados externos.
  
  

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

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Ejemplos

Assign administrator user access rights to a service principal example

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

{
  "identifier": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "groupUserAccessRight": "Admin",
  "principalType": "App"
}

Example

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

{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Definiciones

GroupUser

Un usuario de Power BI con acceso al área de trabajo

GroupUserAccessRight

Derecho de acceso (nivel de permiso) que un usuario tiene en el área de trabajo

PrincipalType

El tipo de entidad de seguridad

ServicePrincipalProfile

Un perfil de entidad de servicio de Power BI. Solo es relevante para solución multiinquilino de Power BI Embedded.