Pipelines - Update Pipeline User

Service:

Power BI REST APIs

API Version:

v1.0

Belirtilen dağıtım işlem hattı için kullanıcı izinleri verir.

Gerekli Kapsam

Pipeline.ReadWrite.All

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
pipelineId	path	True	string uuid	Dağıtım işlem hattı kimliği

İstek Gövdesi

Name	Gerekli	Tür	Description
identifier	True	string	asıl türü Useriçin UPN'yi sağlayın. Aksi takdirde sorumlunun nesne kimliğini belirtin.
principalType	True	PrincipalType	Asıl tür
accessRight		PipelineUserAccessRight	Gereklidir. Kullanıcının dağıtım işlem hattı için sahip olduğu erişim hakkı.

Yanıtlar

Name	Tür	Description
200 OK		Tamam

Örnekler

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

Tanımlar

Name	Description
PipelineUser	Dağıtım işlem hattı için Power BI kullanıcı erişim hakkı girişi
PipelineUserAccessRight	Gereklidir. Kullanıcının dağıtım işlem hattı için sahip olduğu erişim hakkı.
PrincipalType	Asıl tür

PipelineUser

Dağıtım işlem hattı için Power BI kullanıcı erişim hakkı girişi

Name	Tür	Description
accessRight	PipelineUserAccessRight	Gereklidir. Kullanıcının dağıtım işlem hattı için sahip olduğu erişim hakkı.
identifier	string	asıl türü Useriçin UPN'yi sağlayın. Aksi takdirde sorumlunun nesne kimliğini belirtin.
principalType	PrincipalType	Asıl tür

PipelineUserAccessRight

Gereklidir. Kullanıcının dağıtım işlem hattı için sahip olduğu erişim hakkı.

Name	Tür	Description
Admin	string	Dağıtım işlem hattına yönetici hakları verir

PrincipalType

Asıl tür

Name	Tür	Description
App	string	Hizmet sorumlusu türü
Group	string	Grup sorumlusu türü
None	string	Sorumlu türü yok. Tüm kuruluş düzeyinde erişim için kullanın.
User	string	Kullanıcı asıl türü