Admin - Pipelines GetPipelineUsersAsAdmin

Usługa:: Power BI REST APIs

Wersja interfejsu API:: v1.0

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

Permissions

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

Wymagany zakres

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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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	To jest wymagane. Prawo dostępu, które użytkownik ma 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

Objekt

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

Nazwa	Typ	Opis
accessRight	PipelineUserAccessRight	To jest wymagane. Prawo dostępu, które użytkownik ma dla potoku wdrażania.
identifier	string	W przypadku typu `User`podmiotu zabezpieczeń podaj nazwę UPN. W przeciwnym razie podaj identyfikator obiektu podmiotu zabezpieczeń.
principalType	PrincipalType	Typ podmiotu zabezpieczeń

PipelineUserAccessRight

Wyliczanie

To jest wymagane. Prawo dostępu, które użytkownik ma dla potoku wdrażania.

Wartość	Opis
Admin	Przyznaje uprawnienia administratora do potoku wdrażania

PipelineUsers