Bagikan melalui

Pipelines - Update Pipeline User

  • Referensi
Layanan:
Power BI REST APIs
Versi API:
v1.0

Memberikan izin pengguna ke alur penyebaran yang ditentukan.

Cakupan yang Diperlukan

Pipeline.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/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

Permintaan sampel

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

Respon sampel

Kode status:
200

Add a service principal to a deployment pipeline example

Permintaan sampel

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

Respon sampel

Kode status:
200

Add a user to a deployment pipeline example

Permintaan sampel

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

Respon sampel

Kode status:
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

Object

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

Enumeration

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

Nilai Deskripsi
Admin

Memberikan hak administrator untuk alur penyebaran

PrincipalType

Enumeration

Jenis utama

Nilai Deskripsi
App

Jenis perwakilan layanan
Group

Jenis prinsipal grup
None

Tidak ada jenis utama. Gunakan untuk akses tingkat seluruh organisasi.
User

Jenis prinsipal pengguna