Udostępnij za pośrednictwem


Pipelines - Update Pipeline User

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

Wymagany zakres

Pipeline.ReadWrite.All

POST 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

Treść żądania

Nazwa Wymagane Typ Opis
identifier True

string

W przypadku typu podmiotu Userzabezpieczeń podaj nazwę UPN. W przeciwnym razie podaj identyfikator obiektu podmiotu zabezpieczeń.

principalType True

PrincipalType

Typ podmiotu zabezpieczeń

accessRight

PipelineUserAccessRight

Wymagane. Prawo dostępu użytkownika 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

Sample Request

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

Sample Response

Add a service principal to a deployment pipeline example

Sample Request

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

Sample Response

Add a user to a deployment pipeline example

Sample Request

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

Sample Response

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.

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

Udziela uprawnień administratora do 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