Admin - Groups GetGroupUsersAsAdmin
Devuelve una lista de usuarios que tienen acceso al área de trabajo especificada.
Permisos
- El usuario debe ser un administrador de Fabric o autenticarse mediante una entidad de servicio.
- Se admiten permisos delegados.
Cuando se ejecuta en la autenticación prinicipal del servicio, una aplicación no debe tener las premisiones necesarias de consentimiento del administrador para Power BI establecidas en él en Azure Portal.
Ámbito requerido
Tenant.Read.All o Tenant.ReadWrite.All
Solo es relevante al autenticarse a través de un token de acceso de administrador delegado estándar. No debe estar presente cuando se usa la autenticación a través de una entidad de servicio.
Limitaciones
Máximo de 200 solicitudes por hora.
GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
group
|
path | True |
string (uuid) |
Identificador del área de trabajo |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
De acuerdo |
Ejemplos
Example
Solicitud de ejemplo
GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
Respuesta de muestra
{
"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"
}
]
}
Definiciones
| Nombre | Description |
|---|---|
|
Group |
Un usuario de Power BI con acceso al área de trabajo |
|
Group |
Derecho de acceso (nivel de permiso) que un usuario tiene en el área de trabajo |
|
Group |
Contenedor de respuesta de OData para obtener una lista de usuarios de Power BI con acceso a un área de trabajo |
|
Principal |
El tipo de entidad de seguridad |
|
Service |
Un perfil de entidad de servicio de Power BI. Solo es relevante para solución multiinquilino de Power BI Embedded. |
GroupUser
Un usuario de Power BI con acceso al área de trabajo
| Nombre | Tipo | Description |
|---|---|---|
| displayName |
string |
Nombre para mostrar de la entidad de seguridad |
| emailAddress |
string |
Dirección de correo electrónico del usuario |
| graphId |
string |
Identificador de la entidad de seguridad en Microsoft Graph. Solo está disponible para las API de administración. |
| groupUserAccessRight |
Derecho de acceso (nivel de permiso) que un usuario tiene en el área de trabajo |
|
| identifier |
string |
Identificador de la entidad de seguridad |
| principalType |
El tipo de entidad de seguridad |
|
| profile |
Un perfil de entidad de servicio de Power BI. Solo es relevante para solución multiinquilino de Power BI Embedded. |
|
| userType |
string |
Tipo del usuario. |
GroupUserAccessRight
Derecho de acceso (nivel de permiso) que un usuario tiene en el área de trabajo
| Valor | Description |
|---|---|
| None |
Sin acceso al contenido del área de trabajo |
| Member |
Leer, volver a compartir y explorar (ReadReshareExplore) derechos de acceso al contenido del área de trabajo |
| Admin |
Derechos de administrador para el contenido del área de trabajo |
| Contributor |
Acceso de lectura y exploración (ReadExplore) al contenido del área de trabajo |
| Viewer |
Acceso de solo lectura (lectura) al contenido del área de trabajo |
GroupUsers
Contenedor de respuesta de OData para obtener una lista de usuarios de Power BI con acceso a un área de trabajo
| Nombre | Tipo | Description |
|---|---|---|
| @odata.context |
string |
|
| value |
Lista de usuarios con acceso a un área de trabajo |
PrincipalType
El tipo de entidad de seguridad
| Valor | Description |
|---|---|
| None |
No hay ningún tipo de entidad de seguridad. Se usa para el acceso de nivel de organización completo. |
| User |
Tipo de entidad de seguridad de usuario |
| Group |
Tipo de entidad de seguridad de grupo |
| App |
Tipo de entidad de servicio |
ServicePrincipalProfile
Un perfil de entidad de servicio de Power BI. Solo es relevante para solución multiinquilino de Power BI Embedded.
| Nombre | Tipo | Description |
|---|---|---|
| displayName |
string |
El nombre del perfil de entidad de servicio |
| id |
string (uuid) |
Identificador del perfil de la entidad de servicio |