Admin - Pipelines UpdateUserAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Concede permissões de usuário a um pipeline de implantação especificado.

Permissões

O usuário deve ter direitos de administrador.

Escopo necessário

Tenant.ReadWrite.All

Limitações

Máximo de 200 solicitações por hora.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
pipelineId	path	True	string uuid	A ID do pipeline de implantação

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
identifier	True	string	Para o tipo Userde entidade de segurança, forneça o UPN. Caso contrário, forneça a ID do objeto da entidade de segurança.
principalType	True	PrincipalType	O tipo principal
accessRight		PipelineUserAccessRight	Obrigatórios. O direito de acesso que um usuário tem para o pipeline de implantação.

Respostas

Nome	Tipo	Description
200 OK		OK

Exemplos

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/admin/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/admin/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/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users

Request Body

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

Sample Response

Status code:

200

Definições

Nome	Description
PipelineUser	Uma entrada certa de acesso de usuário do Power BI para um pipeline de implantação
PipelineUserAccessRight	Obrigatórios. O direito de acesso que um usuário tem para o pipeline de implantação.
PrincipalType	O tipo principal

PipelineUser

Uma entrada certa de acesso de usuário do Power BI para um pipeline de implantação

Nome	Tipo	Description
accessRight	PipelineUserAccessRight	Obrigatórios. O direito de acesso que um usuário tem para o pipeline de implantação.
identifier	string	Para o tipo Userde entidade de segurança, forneça o UPN. Caso contrário, forneça a ID do objeto da entidade de segurança.
principalType	PrincipalType	O tipo principal

PipelineUserAccessRight

Obrigatórios. O direito de acesso que um usuário tem para o pipeline de implantação.

Nome	Tipo	Description
Admin	string	Concede direitos de administrador a um pipeline de implantação

PrincipalType

O tipo principal

Nome	Tipo	Description
App	string	Tipo de entidade de serviço
Group	string	Tipo de entidade de segurança do grupo
None	string	Nenhum tipo de entidade de segurança. Use todo o acesso ao nível da organização.
User	string	Tipo de entidade de usuário