Datasets - Post Dataset User

Service:

Power BI REST APIs

API Version:

v1.0

Concede los permisos del usuario especificado al conjunto de datos especificado.

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 .

Ámbito requerido

Dataset.ReadWrite.All

Limitaciones

• No se admite la adición de permisos a entidades de servicio (app principalType)
• El autor de la llamada debe tener permisos ReadReshare en el conjunto de datos.
• Esta llamada API no se puede usar para conceder permiso de escritura del conjunto de datos en el conjunto de datos.
  
  

POST 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	DatasetUserAccessRightEntry	Necesario. Derecho de acceso que se va a conceder al usuario para el conjunto de datos.
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 granting ReadExplore right to a security group

Example

Sample Request

POST 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 granting ReadExplore right to a security group

Sample Request

POST 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
DatasetUserAccessRightEntry	Necesario. Derecho de acceso que se va a conceder al usuario para el conjunto de datos.
PostDatasetUserAccess	Una entrada de derecho de acceso de usuario de Power BI para un conjunto de datos
PrincipalType	Tipo de entidad de seguridad

DatasetUserAccessRightEntry

Necesario. Derecho de acceso que se va a conceder al usuario para el conjunto de datos.

Nombre	Tipo	Description
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.

PostDatasetUserAccess

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

Nombre	Tipo	Description
datasetUserAccessRight	DatasetUserAccessRightEntry	Necesario. Derecho de acceso que se va a conceder al usuario para el conjunto de datos.
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

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