Pipelines - Get Pipeline Users

Service:

Power BI REST APIs

API Version:

v1.0

Zwraca listę użytkowników, którzy mają dostęp do określonego potoku wdrażania.

Zakres wymagany

Pipeline.ReadWrite.All lub Pipeline.Read.All

GET https://api.powerbi.com/v1.0/myorg/pipelines/{pipelineId}/users

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
pipelineId	path	True	string uuid	Identyfikator potoku wdrażania

Odpowiedzi

Nazwa	Typ	Opis
200 OK	PipelineUsers	OK

Przykłady

Get users of a deployment pipeline example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/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"
    }
  ]
}

Definicje

Nazwa	Opis
PipelineUser	Wpis prawa dostępu użytkownika usługi Power BI dla potoku wdrażania
PipelineUserAccessRight	Wymagane. Prawo dostępu użytkownika dla potoku wdrażania.
PipelineUsers	Otoka odpowiedzi OData dla kolekcji użytkowników potoku wdrażania usługi Power BI
PrincipalType	Typ podmiotu zabezpieczeń

PipelineUser

Wpis prawa dostępu użytkownika usługi Power BI dla potoku wdrażania

Nazwa	Typ	Opis
accessRight	PipelineUserAccessRight	Wymagane. Prawo dostępu użytkownika dla potoku wdrażania.
identifier	string	W przypadku typu podmiotu Userzabezpieczeń podaj nazwę UPN. W przeciwnym razie podaj identyfikator obiektu podmiotu zabezpieczeń.
principalType	PrincipalType	Typ podmiotu zabezpieczeń

PipelineUserAccessRight

Wymagane. Prawo dostępu użytkownika dla potoku wdrażania.

Nazwa	Typ	Opis
Admin	string	Przyznaje uprawnienia administratora do potoku wdrażania

PipelineUsers

Otoka odpowiedzi OData dla kolekcji użytkowników potoku wdrażania usługi Power BI

Nazwa	Typ	Opis
odata.context	string	Kontekst OData
value	PipelineUser[]	Kolekcja użytkowników potoku wdrażania

PrincipalType

Typ podmiotu zabezpieczeń

Nazwa	Typ	Opis
App	string	Typ jednostki usługi
Group	string	Typ podmiotu zabezpieczeń grupy
None	string	Brak typu podmiotu zabezpieczeń. Służy do uzyskiwania dostępu na poziomie całej organizacji.
User	string	Typ podmiotu zabezpieczeń użytkownika