Admin - Users GetUserSubscriptionsAsAdmin

Référence

Service:: Power BI REST APIs

API Version:: v1.0

Retourne une liste d’abonnements pour l’utilisateur spécifié. Il s’agit d’un appel d’API en préversion.

Autorisations

L’utilisateur doit disposer de droits d’administrateur (tels que Office 365 administrateur général ou administrateur de service Power BI) ou s’authentifier à l’aide d’un principal de service.
Les autorisations déléguées sont prises en charge.

Étendue requise

Tenant.Read.All ou Tenant.ReadWrite.All

Limites

Maximum 200 requêtes par heure.

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/subscriptions

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/subscriptions?continuationToken={continuationToken}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
userId	path	True	string	ID de graphique ou nom d’utilisateur principal (UPN) de l’utilisateur
continuationToken	query		string	Jeton requis pour obtenir le segment suivant du jeu de résultats

Réponses

Nom	Type	Description
200 OK	SubscriptionsByUserResponse	Ok

Exemples

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/subscriptions

Sample Response

Status code:: 200

{
  "subscriptionEntities": [
    {
      "id": "9225d0bc-9f5e-4819-a637-799c0c4fh3f1",
      "title": "Team Scorecard-test",
      "artifactId": "0b50f0bf-b22b-4685-83b9-b6d17f7f4e46",
      "artifactDisplayName": "Customer Profitability Sample",
      "subArtifactDisplayName": "Team Scorecard",
      "artifactType": "Report",
      "isEnabled": false,
      "frequency": "Daily",
      "startDate": "8/10/2021 12:00:00 AM",
      "endDate": "8/10/2022 12:00:00 AM",
      "linkToContent": false,
      "previewImage": true,
      "attachmentFormat": "PNG",
      "users": []
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/subscriptions?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Définitions

Nom	Description
PrincipalType	Type principal
ServicePrincipalProfile	Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.
Subscription	Un abonnement de messagerie pour un élément Power BI (tel qu’un rapport ou un tableau de bord)
SubscriptionsByUserResponse	Wrapper de réponse OData pour un abonnement Power BI pour l’utilisateur
SubscriptionUser	Un utilisateur d’abonnement de messagerie Power BI

PrincipalType

Type principal

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

ServicePrincipalProfile

Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.

Nom	Type	Description
displayName	string	Nom du profil principal de service
id	string	ID de profil du principal de service

Subscription

Un abonnement de messagerie pour un élément Power BI (tel qu’un rapport ou un tableau de bord)

Nom	Type	Description
artifactDisplayName	string	Nom de l’élément Power BI abonné (par exemple, un rapport ou un tableau de bord)
artifactId	string	ID de l’élément Power BI abonné (tel qu’un rapport ou un tableau de bord)
artifactType	string	Type d’élément Power BI (par exemple `Report`, `Dashboard`ou `Dataset`)
attachmentFormat	string	Format du rapport joint dans l’abonnement par courrier électronique
endDate	string	Date et heure de fin de l’abonnement par e-mail
frequency	string	Fréquence de l’abonnement par e-mail
id	string	ID d’abonnement
isEnabled	boolean	Si l’abonnement de messagerie est activé
linkToContent	boolean	Si un lien d’abonnement existe dans l’abonnement par e-mail
previewImage	boolean	Si une capture d’écran du rapport existe dans l’abonnement par e-mail
startDate	string	Date et heure de début de l’abonnement par e-mail
subArtifactDisplayName	string	Nom de page de l’élément Power BI abonné, s’il s’agit d’un rapport.
title	string	Nom de l’application
users	SubscriptionUser[]	Détails de chaque abonné à l’e-mail. Lors de l’utilisation de l’appel d’API Get User Subscriptions As Administration, la valeur retournée est un tableau vide (null). Cette propriété sera supprimée de la réponse de charge utile dans une version à venir. Vous pouvez récupérer des informations d’abonnement sur un rapport ou un tableau de bord Power BI à l’aide des appels d’API Get Report Subscriptions As Administration ou Get Dashboard Subscriptions As Administration.

SubscriptionsByUserResponse

Wrapper de réponse OData pour un abonnement Power BI pour l’utilisateur

Nom	Type	Description
continuationToken	string	Jeton pour obtenir le segment suivant du jeu de résultats
continuationUri	string	URI du segment suivant dans le jeu de résultats
odata.context	string
subscriptionEntities	Subscription[]	Abonnements pour l’utilisateur

SubscriptionUser

Un utilisateur d’abonnement de messagerie Power BI

Nom	Type	Description
displayName	string	Nom d’affichage du principal
emailAddress	string	Adresse e-mail de l’utilisateur
graphId	string	Identificateur du principal dans Microsoft Graph. Disponible uniquement pour les API d’administration.
identifier	string	Identificateur du principal
principalType	PrincipalType	Type principal
profile	ServicePrincipalProfile	Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.
userType	string	Type de l’utilisateur.

Partager via