Partilhar via

Admin - Pipelines UpdateUserAsAdmin

Serviço:
Power BI REST APIs
Versão da API:
v1.0

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

Permissions

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 Userprincipal, 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ório O direito de acesso que um usuário tem para o pipeline de implantação.

Respostas

Nome Tipo Description
200 OK

OKEY

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

Solicitação de exemplo

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users
Corpo da solicitação
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "accessRight": "Admin",
  "principalType": "Group"
}

Resposta de exemplo

Código de status:
200

Add a service principal to a deployment pipeline example

Solicitação de exemplo

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users
Corpo da solicitação
{
  "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
  "accessRight": "Admin",
  "principalType": "App"
}

Resposta de exemplo

Código de status:
200

Add a user to a deployment pipeline example

Solicitação de exemplo

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users
Corpo da solicitação
{
  "identifier": "john@contoso.com",
  "accessRight": "Admin",
  "principalType": "User"
}

Resposta de exemplo

Código de status:
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ório O direito de acesso que um usuário tem para o pipeline de implantação.
PrincipalType

O tipo principal

PipelineUser

Objeto

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

Nome Tipo Description
accessRight

PipelineUserAccessRight

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

string

Para o tipo Userprincipal, forneça o UPN. Caso contrário, forneça a ID do objeto da entidade de segurança.
principalType

PrincipalType

O tipo principal

PipelineUserAccessRight

Enumeração

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

Valor Description
Admin

Concede direitos de administrador a um pipeline de implantação

PrincipalType

Enumeração

O tipo principal

Valor Description
None

Nenhum tipo de entidade de segurança. Use todo o acesso ao nível da organização.
User

Tipo de entidade de usuário
Group

Tipo de entidade de grupo
App

Tipo de entidade de serviço