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.

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

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

PipelineUser

Object

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

Enumeration

Obrigatórios. 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

Enumeration

O tipo principal

Valor	Description
App	Tipo de entidade de serviço
Group	Tipo de entidade de segurança do grupo
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