Pipelines - Get Pipeline Users

Référence

Service:: Power BI REST APIs

API Version:: v1.0

Retourne une liste d’utilisateurs qui ont accès au pipeline de déploiement spécifié.

Étendue requise

Pipeline.ReadWrite.All ou Pipeline.Read.All

GET 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

Réponses

Nom	Type	Description
200 OK	PipelineUsers	Ok

Exemples

Get users of a deployment pipeline example

Sample Request

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

Sample Response

Status code:: 200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "accessRight": "Admin",
      "principalType": "User"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "accessRight": "Admin",
      "principalType": "Group"
    },
    {
      "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
      "accessRight": "Admin",
      "principalType": "App"
    }
  ]
}

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.
PipelineUsers	Wrapper de réponse OData pour une collection d’utilisateurs de pipeline de déploiement Power BI
PrincipalType	Type de principal

PipelineUser

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 `User`de principal, indiquez l’UPN. Sinon, fournissez l’ID d’objet du principal.
principalType	PrincipalType	Type de principal

PipelineUserAccessRight

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

Nom	Type	Description
Admin	string	Octroie des droits d’administrateur à un pipeline de déploiement

PipelineUsers

Wrapper de réponse OData pour une collection d’utilisateurs de pipeline de déploiement Power BI

Nom	Type	Description
odata.context	string	Contexte OData
value	PipelineUser[]	Collection d’utilisateurs de pipeline de déploiement

PrincipalType

Type de principal

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

Partager via