Datasets - Put Dataset User

Service:

Power BI REST APIs

API Version:

v1.0

Novedades los permisos de conjunto de datos existentes del usuario especificado a los permisos especificados.

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 . Esta llamada API se puede usar para quitar todos los permisos del conjunto de datos del usuario especificado mediante datasetUserAccessRight: None

Ámbito requerido

Dataset.ReadWrite.All

Permisos

Los permisos de esta llamada API se enumeran en Permisos de conjuntos de datos.

Limitaciones

• No se admite la actualización de permisos a entidades de servicio (app principalType)
• 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.
• Esta API no se puede usar para agregar o quitar el permiso de escritura .
• Esta API no se puede usar para quitar permisos heredados de nivel de carpeta. En el caso de los administradores y miembros de carpetas, se hereda el permiso ReadWriteReshareExplore en los conjuntos de datos de la carpeta. Para los colaboradores de carpetas, se hereda el permiso ReadWriteExplore en los conjuntos de datos de la carpeta. En el caso de los visores de carpetas, se hereda el permiso De lectura en los conjuntos de datos de la carpeta.
  
  

PUT 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

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
datasetUserAccessRight	True	DatasetUserAccessRight	Derechos de acceso que se asignarán al usuario para el conjunto de datos (nivel de permiso)
identifier	True	string	Para el tipo Userde entidad de seguridad , proporcione el UPN. De lo contrario, proporcione el identificador de objeto de la entidad de seguridad.
principalType	True	PrincipalType	Tipo de entidad de seguridad

Respuestas

Nombre	Tipo	Description
200 OK		Aceptar

Ejemplos

Example

Example for updating security group dataset permissions to ReadExplore

Example

Sample Request

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

Request Body

{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Sample Response

Status code:

200

Example for updating security group dataset permissions to ReadExplore

Sample Request

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

Request Body

{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Sample Response

Status code:

200

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)
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 Userde 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.

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