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