Compartir a través de


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
datasetId
path True

string (uuid)

Identificador del conjunto de datos

Respuestas

Nombre Tipo Description
200 OK

DatasetUsers

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
DatasetUser

Una entrada adecuada de acceso de usuario de Power BI para un conjunto de datos

DatasetUserAccessRight

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

DatasetUsers

Contenedor de respuesta de OData para obtener una lista de usuarios de Power BI con acceso a un conjunto de datos

PrincipalType

El tipo de entidad de seguridad

ServicePrincipalProfile

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

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

PrincipalType

El tipo de entidad de seguridad

profile

ServicePrincipalProfile

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

DatasetUser[]

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