Partilhar via


Admin - Pipelines UpdateUserAsAdmin

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
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "accessRight": "Admin",
  "principalType": "Group"
}

Sample Response

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
{
  "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
  "accessRight": "Admin",
  "principalType": "App"
}

Sample Response

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
{
  "identifier": "john@contoso.com",
  "accessRight": "Admin",
  "principalType": "User"
}

Sample Response

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