Pipelines - Update Pipeline User

Service:

Power BI REST APIs

API Version:

v1.0

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

Request Body

{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "accessRight": "Admin",
  "principalType": "Group"
}

Sample Response

Status code:

200

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

Request Body

{
  "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
  "accessRight": "Admin",
  "principalType": "App"
}

Sample Response

Status code:

200

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

Request Body

{
  "identifier": "john@contoso.com",
  "accessRight": "Admin",
  "principalType": "User"
}

Sample Response

Status code:

200

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