Pipelines - Update Pipeline User

Service:

Power BI REST APIs

API Version:

v1.0

Udělí uživatelům oprávnění k zadanému kanálu nasazení.

Požadovaný obor

Pipeline.ReadWrite.All

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
pipelineId	path	True	string uuid	ID kanálu nasazení

Text požadavku

Name	Vyžadováno	Typ	Description
identifier	True	string	Pro typ Userobjektu zabezpečení zadejte hlavní název uživatele ( UPN). V opačném případě zadejte ID objektu objektu.
principalType	True	PrincipalType	Typ objektu zabezpečení
accessRight		PipelineUserAccessRight	Povinná hodnota. Přístupová práva, které má uživatel pro kanál nasazení.

Odpovědi

Name	Typ	Description
200 OK		OK

Příklady

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

Definice

Name	Description
PipelineUser	Přístup uživatele Power BI ke správné položce kanálu nasazení
PipelineUserAccessRight	Povinná hodnota. Přístupová práva, které má uživatel pro kanál nasazení.
PrincipalType	Typ objektu zabezpečení

PipelineUser

Přístup uživatele Power BI ke správné položce kanálu nasazení

Name	Typ	Description
accessRight	PipelineUserAccessRight	Povinná hodnota. Přístupová práva, které má uživatel pro kanál nasazení.
identifier	string	Pro typ Userobjektu zabezpečení zadejte hlavní název uživatele ( UPN). V opačném případě zadejte ID objektu objektu.
principalType	PrincipalType	Typ objektu zabezpečení

PipelineUserAccessRight

Povinná hodnota. Přístupová práva, které má uživatel pro kanál nasazení.

Name	Typ	Description
Admin	string	Uděluje oprávnění správce kanálu nasazení.

PrincipalType

Typ objektu zabezpečení

Name	Typ	Description
App	string	Typ instančního objektu
Group	string	Typ objektu zabezpečení skupiny
None	string	Žádný typ objektu zabezpečení. Používá se pro přístup na úrovni celé organizace.
User	string	Typ objektu zabezpečení uživatele