Admin - Pipelines UpdateUserAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Memberikan izin pengguna ke alur penyebaran tertentu.

Izin

Pengguna harus memiliki hak administrator.

Cakupan yang Diperlukan

Tenant.ReadWrite.All

Batasan

Maksimum 200 permintaan per jam.

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/{pipelineId}/users

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
pipelineId	path	True	string uuid	ID alur penyebaran

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
identifier	True	string	Untuk jenis Userutama , berikan UPN. Jika tidak, berikan ID objek utama.
principalType	True	PrincipalType	Jenis utama
accessRight		PipelineUserAccessRight	Wajib diisi. Hak akses yang dimiliki pengguna untuk alur penyebaran.

Respons

Nama	Jenis	Deskripsi
200 OK		OK

Contoh

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/admin/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/admin/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/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users

Request Body

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

Sample Response

Status code:

200

Definisi

Nama	Deskripsi
PipelineUser	Entri kanan akses pengguna Power BI untuk alur penyebaran
PipelineUserAccessRight	Wajib diisi. Hak akses yang dimiliki pengguna untuk alur penyebaran.
PrincipalType	Jenis utama

PipelineUser

Entri kanan akses pengguna Power BI untuk alur penyebaran

Nama	Jenis	Deskripsi
accessRight	PipelineUserAccessRight	Wajib diisi. Hak akses yang dimiliki pengguna untuk alur penyebaran.
identifier	string	Untuk jenis Userutama , berikan UPN. Jika tidak, berikan ID objek utama.
principalType	PrincipalType	Jenis utama

PipelineUserAccessRight

Wajib diisi. Hak akses yang dimiliki pengguna untuk alur penyebaran.

Nama	Jenis	Deskripsi
Admin	string	Memberikan hak administrator untuk alur penyebaran

PrincipalType

Jenis utama

Nama	Jenis	Deskripsi
App	string	Jenis perwakilan layanan
Group	string	Jenis prinsipal grup
None	string	Tidak ada jenis utama. Gunakan untuk akses tingkat seluruh organisasi.
User	string	Jenis prinsipal pengguna