Compartilhar via


Admin - Pipelines GetPipelineUsersAsAdmin

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

Permissões

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

OK

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

{
  "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órios. 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

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.

Valor Description
Admin

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

PipelineUsers

Wrapper de resposta OData para uma coleção de usuários de pipeline de implantação do Power BI

Nome Tipo Description
@odata.context

string

Contexto OData

value

PipelineUser[]

A coleção de usuários do pipeline de implantação

PrincipalType

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