Compartir a través de

Datasets - Put Dataset User In Group

  • Referencia
Servicio:
Power BI REST APIs
Versión de la API:
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 recompartido 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. Para 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. Para 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/groups/{groupId}/datasets/{datasetId}/users

Parámetros de identificador URI

Nombre En Requerido Tipo Description
datasetId
 path True

string

Identificador del conjunto de datos
groupId
 path True

string

uuid

Identificador del área de trabajo

Cuerpo de la solicitud

Nombre Requerido Tipo Description
datasetUserAccessRight True

DatasetUserAccessRight

Derechos de acceso que se van a asignar 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

El tipo de entidad de seguridad

Respuestas

Nombre Tipo Description
200 OK

Aceptar

Ejemplos

Example
Example for updating security group dataset permissions to ReadExplore

Example

Solicitud de ejemplo

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Cuerpo de la solicitud
{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Respuesta de muestra

status code:
200

Example for updating security group dataset permissions to ReadExplore

Solicitud de ejemplo

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Cuerpo de la solicitud
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Respuesta de muestra

status code:
200

Definiciones

Nombre Description
DatasetUserAccess

Una entrada adecuada de acceso a la entidad de seguridad de Power BI para un conjunto de datos
DatasetUserAccessRight

Derecho de acceso que el usuario tiene para el conjunto de datos (nivel de permiso)
PrincipalType

El tipo de entidad de seguridad

DatasetUserAccess

Una entrada adecuada de acceso a la entidad de seguridad de Power BI para un conjunto de datos

Nombre Tipo Description
datasetUserAccessRight

DatasetUserAccessRight

Derechos de acceso que se van a asignar 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

El tipo de entidad de seguridad

DatasetUserAccessRight

Derecho de acceso que el usuario tiene 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 volver a compartir el contenido del conjunto de datos.
ReadWriteReshareExplore

string

Concede acceso de lectura, escritura, volver a compartir y explorar el acceso al contenido del conjunto de datos.

PrincipalType

El 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. Se usa para el acceso de nivel de organización completo.
User

string

Tipo de entidad de seguridad de usuario