Compartir a través de

Pipelines - Update Pipeline User

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

Concede permisos de usuario a la canalización de implementación especificada.

Ámbito requerido

Pipeline.ReadWrite.All 

POST https://api.powerbi.com/v1.0/myorg/pipelines/{pipelineId}/users

Parámetros de identificador URI

Nombre En Requerido Tipo Description
pipelineId
 path True

string (uuid)

Identificador de canalización de implementación

Cuerpo de la solicitud

Nombre Requerido Tipo Description
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
accessRight

PipelineUserAccessRight

Obligatorio. El derecho de acceso que tiene un usuario para la canalización de implementación.

Respuestas

Nombre Tipo Description
200 OK

OK

Ejemplos

Add a group to a deployment pipeline example
Add a service principal to a deployment pipeline example
Add a user to a deployment pipeline example

Add a group to a deployment pipeline example

Solicitud de ejemplo

POST https://api.powerbi.com/v1.0/myorg/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users
Cuerpo de la solicitud
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "accessRight": "Admin",
  "principalType": "Group"
}

Respuesta de muestra

status code:
200

Add a service principal to a deployment pipeline example

Solicitud de ejemplo

POST https://api.powerbi.com/v1.0/myorg/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users
Cuerpo de la solicitud
{
  "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
  "accessRight": "Admin",
  "principalType": "App"
}

Respuesta de muestra

status code:
200

Add a user to a deployment pipeline example

Solicitud de ejemplo

POST https://api.powerbi.com/v1.0/myorg/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users
Cuerpo de la solicitud
{
  "identifier": "john@contoso.com",
  "accessRight": "Admin",
  "principalType": "User"
}

Respuesta de muestra

status code:
200

Definiciones

Nombre Description
PipelineUser

Una entrada adecuada de acceso de usuario de Power BI para una canalización de implementación
PipelineUserAccessRight

Obligatorio. El derecho de acceso que tiene un usuario para la canalización de implementación.
PrincipalType

El tipo de entidad de seguridad

PipelineUser

Object

Una entrada adecuada de acceso de usuario de Power BI para una canalización de implementación

Nombre Tipo Description
accessRight

PipelineUserAccessRight

Obligatorio. El derecho de acceso que tiene un usuario para la canalización de implementación.
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

PipelineUserAccessRight

Enumeración

Obligatorio. El derecho de acceso que tiene un usuario para la canalización de implementación.

Valor Description
Admin

Concede derechos de administrador a una canalización de implementación

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