Admin - Pipelines GetPipelineUsersAsAdmin

Référence

Service:: Power BI REST APIs

API Version:: v1.0

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

Autorisations

L’utilisateur doit disposer de droits d’administrateur ou s’authentifier à l’aide d’un principal de service.

Étendue requise

Tenant.Read.All ou Tenant.ReadWrite.All

Limites

200 requêtes maximales par heure.

GET https://api.powerbi.com/v1.0/myorg/admin/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/admin/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 appropriée de l’accès utilisateur Power BI pour un pipeline de déploiement
PipelineUserAccessRight	Obligatoire. Le droit d’accès d’un utilisateur pour le pipeline de déploiement.
PipelineUsers	Wrapper de réponse OData pour une collection d’utilisateurs du pipeline de déploiement Power BI
PrincipalType	Type de principal

PipelineUser

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

Nom	Type	Description
accessRight	PipelineUserAccessRight	Obligatoire. Le droit d’accès d’un utilisateur pour le pipeline de déploiement.
identifier	string	Pour le type `User`principal, fournissez l’UPN. Sinon, fournissez l’ID d’objet du principal.
principalType	PrincipalType	Type de principal

PipelineUserAccessRight

Obligatoire. Le droit d’accès d’un utilisateur pour le pipeline de déploiement.

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

PipelineUsers

Wrapper de réponse OData pour une collection d’utilisateurs du 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 principal. Utiliser pour l’ensemble de l’accès au niveau de l’organisation.
User	string	Type de principal de l’utilisateur

Partager via