Datasets - Post Dataset User

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