Admin - Pipelines GetPipelineUsersAsAdmin

Serviço:: Power BI REST APIs

Versão da API:: v1.0

Retorna uma lista de usuários que têm acesso a um pipeline de implantação especificado.

Permissions

O usuário deve ter direitos de administrador ou autenticar usando uma entidade de serviço.

Escopo necessário

Tenant.Read.All ou Tenant.ReadWrite.All

Limitações

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

GET 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

Respostas

Nome	Tipo	Description
200 OK	PipelineUsers	OKEY

Exemplos

Get users of a deployment pipeline example

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "accessRight": "Admin",
      "principalType": "User"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "accessRight": "Admin",
      "principalType": "Group"
    },
    {
      "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
      "accessRight": "Admin",
      "principalType": "App"
    }
  ]
}

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.
PipelineUsers	Wrapper de resposta OData para uma coleção de usuários de pipeline de implantação do Power BI
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 `User`principal, 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

PipelineUsers