Pipelines - Update Pipeline User

Služba:

Power BI REST APIs

Verze rozhraní API:

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	Jako 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é. Přístupové právo, 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

Ukázkový požadavek

POST https://api.powerbi.com/v1.0/myorg/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users

Text požadavku

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

Ukázková odpověď

Stavový kód:

200

Add a service principal to a deployment pipeline example

Ukázkový požadavek

POST https://api.powerbi.com/v1.0/myorg/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users

Text požadavku

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

Ukázková odpověď

Stavový kód:

200

Add a user to a deployment pipeline example

Ukázkový požadavek

POST https://api.powerbi.com/v1.0/myorg/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users

Text požadavku

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

Ukázková odpověď

Stavový kód:

200

Definice

Name	Description
PipelineUser	Správná položka přístupu uživatele Power BI pro kanál nasazení
PipelineUserAccessRight	Povinné. Přístupové právo, které má uživatel pro kanál nasazení.
PrincipalType	Typ objektu zabezpečení

PipelineUser

Objekt

Správná položka přístupu uživatele Power BI pro kanál nasazení

Name	Typ	Description
accessRight	PipelineUserAccessRight	Povinné. Přístupové právo, které má uživatel pro kanál nasazení.
identifier	string	Jako 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

Výčet

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

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

PrincipalType

Výčet

Typ objektu zabezpečení

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