Compartir a través de

Gateways - Add Datasource User

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

Concede o actualiza los permisos necesarios para usar el origen de datos especificado para el usuario especificado.

Permisos

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

Ámbito requerido

Dataset.ReadWrite.All

Limitaciones

No se admiten puertas de enlace de red virtual (VNet). No se admite la adición de grupos a través de la API. 

POST 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.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
datasourceAccessRight True

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

La de identificador de objeto de 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 solución multiinquilino de Power BI Embedded.

Respuestas

Nombre Tipo Description
200 OK

De acuerdo

Ejemplos

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example
Example

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Solicitud de ejemplo

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users
Cuerpo de la solicitud
{
  "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
  "datasourceAccessRight": "ReadOverrideEffectiveIdentity"
}

Respuesta de muestra

status code:
200

Example

Solicitud de ejemplo

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users
Cuerpo de la solicitud
{
  "emailAddress": "john@contoso.com",
  "datasourceAccessRight": "Read"
}

Respuesta de muestra

status code:
200

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
PrincipalType

El tipo de entidad de seguridad
ServicePrincipalProfile

Un perfil de entidad de servicio de Power BI. Solo es relevante para 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

La de identificador de objeto de 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 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.

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 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