Datasets - Get Dataset Users

Referencia

Servicio:: Power BI REST APIs

Versión de la API:: 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 volver a compartir o propietarios de conjuntos de datos.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
datasetId	path	True	string	El identificador del conjunto de datos

Respuestas

Nombre	Tipo	Description
200 OK	DatasetUsersAccess	Aceptar

Ejemplos

Example

Solicitud de ejemplo

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Respuesta de muestra

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 de derecho de acceso de entidad de seguridad de Power BI para un conjunto de datos
DatasetUserAccessRight	Derecho de acceso que tiene el usuario 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	Tipo de entidad de seguridad

DatasetUserAccess

Una entrada de derecho de acceso de entidad de seguridad de Power BI para un conjunto de datos

Nombre	Tipo	Description
datasetUserAccessRight	DatasetUserAccessRight	Derechos de acceso que se asignarán 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	Tipo de entidad de seguridad

DatasetUserAccessRight

Derecho de acceso que tiene el usuario 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 recompartición al contenido del conjunto de datos.
ReadWriteReshareExplore	string	Concede acceso de lectura, escritura, recursos compartidos y exploración 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

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. Use para el acceso de nivel de organización completo.
User	string	Tipo de entidad de seguridad de usuario

Compartir a través de