Compartir a través de

Gateways - Get Datasource Users

Servicio:
Power BI REST APIs
Versión de la API:
v1.0

Devuelve una lista de usuarios que tienen acceso al origen de datos especificado.

Permissions

El usuario debe tener permisos de administrador de puerta de enlace.

Ámbito requerido

Dataset.ReadWrite.All o Dataset.Read.All

Limitaciones

No se admiten puertas de enlace de red virtual (VNet). 

GET https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources/{datasourceId}/users

Parámetros de identificador URI

Nombre En Requerido Tipo Description
datasourceId
 path True

string (uuid)

Identificador del origen de datos
gatewayId
 path True

string (uuid)

Identificador de puerta de enlace. Cuando se usa un clúster de puerta de enlace, el identificador de puerta de enlace hace referencia a la puerta de enlace principal (primera) del clúster. En tales casos, el identificador de puerta de enlace es similar al identificador de clúster de puerta de enlace.

Respuestas

Nombre Tipo Description
200 OK

DatasourceUsers

OK

Ejemplos

Example

Solicitud de ejemplo

GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users

Respuesta de muestra

status code:
200 
{
  "value": [
    {
      "datasourceAccessRight": "Read",
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "identifier": "john@contoso.com",
      "principalType": "User"
    },
    {
      "datasourceAccessRight": "ReadOverrideEffectiveIdentity",
      "displayName": "ContosoTestApp",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

Definiciones

Nombre Description
DatasourceUser

Un usuario de Power BI con acceso al origen de datos
DatasourceUserAccessRight

Derecho de acceso (nivel de permiso) que un usuario tiene en el origen de datos
DatasourceUsers

Contenedor de respuesta de OData para obtener una lista de usuarios de Power BI con acceso a un origen 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.

DatasourceUser

Object

Un usuario de Power BI con acceso al origen de datos

Nombre Tipo Description
datasourceAccessRight

DatasourceUserAccessRight

Derecho de acceso (nivel de permiso) que un usuario tiene en el origen de datos
displayName

string

Nombre para mostrar de la entidad de seguridad
emailAddress

string

Dirección de correo electrónico del usuario
identifier

string

Identificador de objeto 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.

DatasourceUserAccessRight

Enumeración

Derecho de acceso (nivel de permiso) que un usuario tiene en el origen de datos

Valor Description
None

No hay permiso para acceder al origen de datos. Solo se aplica al actualizar los permisos de usuario.
Read

Los conjuntos de datos propiedad del usuario tienen acceso de lectura al origen de datos
ReadOverrideEffectiveIdentity

El usuario puede invalidar la identidad efectiva de Power BI Embedded. Solo se aplica a orígenes de datos locales de Analysis Services.

DatasourceUsers

Object

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

Nombre Tipo Description
@odata.context

string

value

DatasourceUser[]

Lista de usuarios con acceso a un origen de datos

PrincipalType

Enumeración

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

Object

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