Pipelines - Update Pipeline User

Service:

Power BI REST APIs

Version d'API:

v1.0

Octroie des autorisations utilisateur au pipeline de déploiement spécifié.

Étendue requise

Pipeline.ReadWrite.All

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
pipelineId	path	True	string uuid	ID du pipeline de déploiement

Corps de la demande

Nom	Obligatoire	Type	Description
identifier	True	string	Pour le type Userde principal, indiquez l’UPN. Sinon, fournissez l’ID d’objet du principal.
principalType	True	PrincipalType	Type de principal
accessRight		PipelineUserAccessRight	Obligatoire. Droit d’accès dont dispose un utilisateur pour le pipeline de déploiement.

Réponses

Nom	Type	Description
200 OK		Ok

Exemples

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

Exemple de requête

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

Corps de la demande

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

Exemple de réponse

Code d’état:

200

Add a service principal to a deployment pipeline example

Exemple de requête

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

Corps de la demande

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

Exemple de réponse

Code d’état:

200

Add a user to a deployment pipeline example

Exemple de requête

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

Corps de la demande

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

Exemple de réponse

Code d’état:

200

Définitions

Nom	Description
PipelineUser	Entrée de droit d’accès utilisateur Power BI pour un pipeline de déploiement
PipelineUserAccessRight	Obligatoire. Droit d’accès dont dispose un utilisateur pour le pipeline de déploiement.
PrincipalType	Type de principal

PipelineUser

Object

Entrée de droit d’accès utilisateur Power BI pour un pipeline de déploiement

Nom	Type	Description
accessRight	PipelineUserAccessRight	Obligatoire. Droit d’accès dont dispose un utilisateur pour le pipeline de déploiement.
identifier	string	Pour le type Userde principal, indiquez l’UPN. Sinon, fournissez l’ID d’objet du principal.
principalType	PrincipalType	Type de principal

PipelineUserAccessRight

Enumeration

Obligatoire. Droit d’accès dont dispose un utilisateur pour le pipeline de déploiement.

Valeur	Description
Admin	Octroie des droits d’administrateur à un pipeline de déploiement

PrincipalType

Enumeration

Type de principal

Valeur	Description
App	Type de principal de service
Group	Type de principal de groupe
None	Aucun type de principal. Utiliser pour l’ensemble de l’accès au niveau de l’organisation.
User	Type d’utilisateur principal