Admin - Datasets GetDatasetUsersAsAdmin
Devuelve una lista de usuarios que tienen acceso al conjunto de datos especificado.
Permissions
- El usuario debe ser un administrador de Fabric o autenticarse mediante una entidad de servicio.
- Se admiten permisos delegados.
- Los permisos de esta llamada API se muestran en Permisos de conjuntos de datos.
Cuando se ejecuta en la autenticación prinicipal del servicio, una aplicación no debe tener ninguna premisión necesaria de consentimiento del administrador para Power BI establecida 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/datasets/{datasetId}/users
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
dataset
|
path | True |
string (uuid) |
Identificador del conjunto de datos |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
OK |
Ejemplos
Example
Solicitud de ejemplo
GET https://api.powerbi.com/v1.0/myorg/admin/datasets/{datasetId}/users
Respuesta de muestra
{
"value": [
{
"displayName": "John Nick",
"emailAddress": "john@contoso.com",
"datasetUserAccessRight": "ReadWriteReshareExplore",
"identifier": "john@contoso.com",
"graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
"principalType": "User"
}
]
}
Definiciones
| Nombre | Description |
|---|---|
|
Dataset |
Una entrada adecuada de acceso de usuario de Power BI para un conjunto de datos |
|
Dataset |
Derecho de acceso que el usuario tiene para el conjunto de datos (nivel de permiso) |
|
Dataset |
Contenedor de respuesta de OData para obtener una lista de usuarios de Power BI con acceso a un conjunto de datos |
|
Principal |
El tipo de entidad de seguridad |
|
Service |
Un perfil de entidad de servicio de Power BI. Solo es relevante para la solución multiinquilino de Power BI Embedded. |
DatasetUser
Una entrada adecuada de acceso de usuario de Power BI para un conjunto de datos
| Nombre | Tipo | Description |
|---|---|---|
| datasetUserAccessRight |
Derecho de acceso que el usuario tiene para el conjunto de datos (nivel de permiso) |
|
| 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. |
| 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 la solución multiinquilino de Power BI Embedded. |
|
| userType |
string |
Tipo del usuario. |
DatasetUserAccessRight
Derecho de acceso que el usuario tiene para el conjunto de datos (nivel de permiso)
| Valor | Description |
|---|---|
| None |
Quita el permiso para el contenido del conjunto de datos. |
| Read |
Concede acceso de lectura al contenido del conjunto de datos. |
| ReadWrite |
Concede acceso de lectura y escritura al contenido del conjunto de datos |
| ReadReshare |
Concede acceso de lectura y volver a compartir el contenido del conjunto de datos |
| ReadWriteReshare |
Concede acceso de lectura, escritura y volver a compartir el contenido del conjunto de datos |
| ReadExplore |
Concede acceso de lectura y exploración al contenido del conjunto de datos |
| ReadReshareExplore |
Concede acceso de lectura, volver a compartir y explorar el acceso al contenido del conjunto de datos |
| ReadWriteExplore |
Concede acceso de lectura, escritura y exploración al contenido del conjunto de datos |
| ReadWriteReshareExplore |
Concede acceso de lectura, escritura, volver a compartir y explorar el acceso al contenido del conjunto de datos |
DatasetUsers
Contenedor de respuesta de OData para obtener una lista de usuarios de Power BI con acceso a un conjunto de datos
| Nombre | Tipo | Description |
|---|---|---|
| @odata.context |
string |
|
| value |
Lista de usuarios con acceso a un conjunto de datos |
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 la 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 |