Udostępnij przez

Admin - Pipelines UpdateUserAsAdmin

Usługa:
Power BI REST APIs
Wersja interfejsu API:
v1.0

Przyznaje użytkownikowi uprawnienia do określonego potoku wdrażania.

Permissions

Użytkownik musi mieć uprawnienia administratora.

Wymagany zakres

Tenant.ReadWrite.All

Ograniczenia

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

POST 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

Treść żądania

Nazwa Wymagane Typ Opis
identifier True

string

W przypadku typu Userpodmiotu zabezpieczeń podaj nazwę UPN. W przeciwnym razie podaj identyfikator obiektu podmiotu zabezpieczeń.
principalType True

PrincipalType

Typ podmiotu zabezpieczeń
accessRight

PipelineUserAccessRight

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

Odpowiedzi

Nazwa Typ Opis
200 OK

OK

Przykłady

Add a group to a deployment pipeline example
Add a service principal to a deployment pipeline example
Add a user to a deployment pipeline example

Add a group to a deployment pipeline example

Przykładowe żądanie

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users
Treść żądania
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "accessRight": "Admin",
  "principalType": "Group"
}

Przykładowa odpowiedź

Kod stanu:
200

Add a service principal to a deployment pipeline example

Przykładowe żądanie

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users
Treść żądania
{
  "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
  "accessRight": "Admin",
  "principalType": "App"
}

Przykładowa odpowiedź

Kod stanu:
200

Add a user to a deployment pipeline example

Przykładowe żądanie

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users
Treść żądania
{
  "identifier": "john@contoso.com",
  "accessRight": "Admin",
  "principalType": "User"
}

Przykładowa odpowiedź

Kod stanu:
200

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.
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 Userpodmiotu 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

PrincipalType

Wyliczanie

Typ podmiotu zabezpieczeń

Wartość Opis
None

Brak typu podmiotu zabezpieczeń. Służy do uzyskiwania dostępu na poziomie całej organizacji.
User

Typ podmiotu zabezpieczeń użytkownika
Group

Typ podmiotu zabezpieczeń grupy
App

Typ jednostki usługi