Admin - Pipelines GetPipelineUsersAsAdmin

Referência

Service:: Power BI REST APIs

API Version:: v1.0

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

Sample Request

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

Sample Response

Status code:: 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ó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 `User`de 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

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

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

Partilhar via