Pipelines - Update Pipeline User

Service:

Power BI REST APIs

API Version:

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	Tipo de entidad de seguridad
accessRight		PipelineUserAccessRight	Necesario. El derecho de acceso que tiene un usuario para la canalización de implementación.

Respuestas

Nombre	Tipo	Description
200 OK		Aceptar

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

Sample Request

POST https://api.powerbi.com/v1.0/myorg/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users

Request Body

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

Sample Response

Status code:

200

Add a service principal to a deployment pipeline example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users

Request Body

{
  "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
  "accessRight": "Admin",
  "principalType": "App"
}

Sample Response

Status code:

200

Add a user to a deployment pipeline example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users

Request Body

{
  "identifier": "john@contoso.com",
  "accessRight": "Admin",
  "principalType": "User"
}

Sample Response

Status code:

200

Definiciones

Nombre	Description
PipelineUser	Una entrada correcta de acceso de usuario de Power BI para una canalización de implementación
PipelineUserAccessRight	Necesario. El derecho de acceso que tiene un usuario para la canalización de implementación.
PrincipalType	Tipo de entidad de seguridad

PipelineUser

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

Nombre	Tipo	Description
accessRight	PipelineUserAccessRight	Necesario. 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	Tipo de entidad de seguridad

PipelineUserAccessRight

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

Nombre	Tipo	Description
Admin	string	Concede derechos de administrador a una canalización de implementación

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