Udostępnij za pośrednictwem


Admin - Pipelines GetPipelineUsersAsAdmin

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

Uprawnienia

Użytkownik musi mieć uprawnienia administratora lub uwierzytelnić się przy użyciu jednostki usługi.

Zakres wymagany

Tenant.Read.All lub Tenant.ReadWrite.All

Ograniczenia

Maksymalna liczba żądań na godzinę wynosi 200.

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

Sample Response

{
  "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