Datasets - Get Dataset Users In Group

Referencia

Service:: Power BI REST APIs

API Version:: v1.0

Devuelve una lista de entidades de seguridad que tienen acceso al conjunto de datos especificado.

Cuando los permisos de usuario para un conjunto de datos se han actualizado recientemente, es posible que los nuevos permisos no estén disponibles inmediatamente a través de llamadas API. Para actualizar los permisos de usuario, use la llamada API Actualizar permisos de usuario .

Permisos

Los permisos de esta llamada API se enumeran en Permisos de conjuntos de datos.

Ámbito requerido

Dataset.Read.All o Dataset.ReadWrite.All

Limitaciones

El autor de la llamada debe tener permisos ReadWriteReshare en el conjunto de datos. Es decir, administradores de carpetas, miembros y colaboradores con permisos de recompartido o propietarios de conjuntos de datos.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
datasetId	path	True	string	Identificador del conjunto de datos
groupId	path	True	string uuid	Identificador del área de trabajo

Respuestas

Nombre	Tipo	Description
200 OK	DatasetUsersAccess	Aceptar

Ejemplos

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Sample Response

Status code:: 200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "principalType": "User",
      "datasetUserAccessRight": "Read"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "principalType": "Group",
      "datasetUserAccessRight": "ReadReshare"
    },
    {
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App",
      "datasetUserAccessRight": "ReadWriteReshareExplore"
    }
  ]
}

Definiciones

Nombre	Description
DatasetUserAccess	Una entrada adecuada de acceso a la entidad de seguridad de Power BI para un conjunto de datos
DatasetUserAccessRight	Derecho de acceso que el usuario tiene para el conjunto de datos (nivel de permiso)
DatasetUsersAccess	Contenedor de respuesta de OData para una lista de entidades de seguridad de Power BI con acceso a un conjunto de datos
PrincipalType	El tipo de entidad de seguridad

DatasetUserAccess

Una entrada adecuada de acceso a la entidad de seguridad de Power BI para un conjunto de datos

Nombre	Tipo	Description
datasetUserAccessRight	DatasetUserAccessRight	Derechos de acceso que se van a asignar al usuario para el conjunto de datos (nivel de permiso)
identifier	string	Para el tipo `User`de entidad de seguridad , proporcione el UPN. De lo contrario, proporcione el identificador de objeto de la entidad de seguridad.
principalType	PrincipalType	El tipo de entidad de seguridad

DatasetUserAccessRight

Derecho de acceso que el usuario tiene para el conjunto de datos (nivel de permiso)

Nombre	Tipo	Description
None	string	Quita el permiso para el contenido del conjunto de datos.
Read	string	Concede acceso de lectura al contenido del conjunto de datos.
ReadExplore	string	Concede acceso de lectura y exploración al contenido del conjunto de datos.
ReadReshare	string	Concede acceso de lectura y recompartición al contenido del conjunto de datos
ReadReshareExplore	string	Concede acceso de lectura, volver a compartir y explorar el contenido del conjunto de datos.
ReadWrite	string	Concede acceso de lectura y escritura al contenido del conjunto de datos.
ReadWriteExplore	string	Concede acceso de lectura, escritura y exploración al contenido del conjunto de datos.
ReadWriteReshare	string	Concede acceso de lectura, escritura y volver a compartir el contenido del conjunto de datos.
ReadWriteReshareExplore	string	Concede acceso de lectura, escritura, volver a compartir y explorar el acceso al contenido del conjunto de datos.

DatasetUsersAccess

Contenedor de respuesta de OData para una lista de entidades de seguridad de Power BI con acceso a un conjunto de datos

Nombre	Tipo	Description
odata.context	string
value	DatasetUserAccess[]	Lista de usuarios con acceso a un conjunto de datos

PrincipalType

El tipo de entidad de seguridad

Nombre	Tipo	Description
App	string	Tipo de entidad de servicio
Group	string	Tipo de entidad de seguridad de grupo
None	string	No hay ningún tipo de entidad de seguridad. Se usa para el acceso de nivel de organización completo.
User	string	Tipo de entidad de seguridad de usuario