FAQ sur les API et services mesurés dans Microsoft Graph
Cet article fournit des réponses aux questions fréquemment posées sur les API et les services à l’utilisation dans Microsoft Graph.
FAQ sur la configuration de la facturation
Quelles sont les autorisations requises pour configurer la facturation ?
La configuration de la facturation nécessite des autorisations à la fois pour l’inscription de l’application et l’abonnement Azure que vous souhaitez utiliser. Les autorisations requises pour l’inscription de l’application sont Propriétaire de l’application ou Administrateur d’application. Les autorisations requises pour l’abonnement Azure sont Contributeur d’abonnement, Propriétaire/Contributeur de groupe de ressources ou Propriétaire.
Puis-je utiliser un principal de service pour configurer la facturation sur mon inscription d’application ?
Oui, elle nécessite un rôle d’administrateur d’application ou un rôle similaire pour l’inscription de l’application affectée au principal de service. Le rôle peut être étendu uniquement à l’application cible configurée pour la facturation afin d’empêcher l’octroi d’autorisations trop étendues.
Puis-je utiliser une identité managée pour configurer la facturation sur l’inscription de mon application ?
Oui, vous pouvez créer une identité managée pour les ressources Azure. Affectez le contrôle d’accès en fonction du rôle à votre abonnement ou groupe de ressources, puis ajoutez le rôle d’administrateur d’application Microsoft Entra au principal de service associé à l’identité managée. Pour plus d’informations, consultez Tutoriel : Utiliser une machine virtuelle Windows/VMSS pour accéder aux ressources Azure pour obtenir un exemple.
Comment puis-je vérifier que mon application est correctement configurée pour la facturation ?
Pour plus d’informations sur la vérification de la configuration de la facturation, consultez Activer les API et les services à l’usage.
FAQ sur la facturation de l’API d’exportation Microsoft Teams
Existe-t-il d’autres exigences que la configuration de la facturation pour appeler les API d’exportation Microsoft Teams ?
Oui, les API d’exportation Microsoft Teams nécessitent qu’un model paramètre soit passé dans le cadre de l’appel d’API. Selon la valeur du model paramètre, une licence utilisateur peut également être requise pour certaines données. Pour plus d’informations, consultez Modèles de paiement de l’API Teams et exigences de licence.
Comment faire savez quel paramètre de modèle est utilisé dans les appels d’API ?
La meilleure façon de déterminer quel model paramètre est utilisé consiste à inspecter le code de l’application appelante.
Comment la capacité d’amorçage est-elle calculée ?
La capacité d’amorçage pour les API d’exportation Teams appelées avec le model=a paramètre est calculée en fonction du nombre d’utilisateurs éligibles dans le locataire cible. La capacité amorçage est ensuite appliquée à chaque application en cours d’exécution sur ce locataire.
Comment la capacité d’amorçage est-elle appliquée ?
La capacité amorçage est évaluée au début du mois et toute licence éligible est comptabilisée dans le calcul de la capacité amorçage au niveau du locataire. Chaque application consomme ensuite la capacité amorçage qui lui est allouée jusqu’à ce qu’elle soit épuisée. La consommation supplémentaire par l’application est ensuite mesurée et apparaît sur la facture mensuelle.
Que se passe-t-il lorsqu’une application inscrite mais non configurée pour la facturation lance un appel d’API d’exportation Teams limitée ?
L’appel d’API échoue avec une erreur de paiement 402 obligatoire. Cela se produit même lorsque vous ciblez un utilisateur avec une licence utilisateur valide et passez le model=a paramètre .
Que se passe-t-il lorsque le paramètre de modèle est exclu d’un appel à une API d’exportation Microsoft Teams qui l’exige ?
Lors de l’appel d’une API sans paramètre requis model , l’API utilise par défaut le comportement en mode évaluation. Le mode d’évaluation fournit un nombre limité d’appels d’API par mois avant de retourner l’erreur de paiement 402 requise. Le mode d’évaluation est fourni uniquement pour l’évaluation et le développement et n’est pas destiné à une utilisation en production.
FAQ sur les consommateurs d’applications
Pourquoi mon fournisseur d’applications me demande-t-il de configurer la facturation ?
Le propriétaire de l’inscription d’application gère la facturation des API et des services à l’usage dans Microsoft Graph. Si vous avez acquis une application qui nécessite que vous soyez le propriétaire de l’inscription de l’application, vous êtes responsable de tous les services et API à l’usage de l’application.
Ai-je besoin de licences pour chaque utilisateur de mon locataire ?
Une licence est requise pour chaque utilisateur soumis à des stratégies de sécurité et de conformité. D’autres scénarios peuvent ne pas nécessiter de licence. Pour plus d’informations, consultez Modèles de paiement de l’API Teams et exigences de licence.
FAQ sur la gestion des coûts et la facturation
Où puis-je obtenir les informations de facturation pour les API et les services à l’usage ?
Les données de facturation sont envoyées à l’abonnement Azure utilisé pour créer la ressource de facturation Microsoft Graph sous le nom de service Services Microsoft Graph, et elles sont généralement disponibles 24 heures après les transactions.
Pour plus d’informations, consultez Vue d’ensemble de la gestion des coûts et de la facturation Azure.
Le tableau suivant répertorie les outils les plus fréquemment utilisés pour examiner et surveiller les frais de facturation.
| Type | Description |
|---|---|
| Analyse des coûts | Graphique interactif qui affiche la consommation. Conseil : Utilisez les coûts cumulés et filtrez par nom de service services Microsoft Graph. |
| Exportations | Crée des rapports détaillés avec la fréquence souhaitée (par exemple, quotidienne ou mensuelle). |
| Alertes | Configure les alertes en combinant des filtres. |
La facture est-elle répartie pour chaque API ?
Le tableau suivant montre comment les détails de facturation peuvent être agrégés ou rompus.
| Type | Exporte la propriété | Filtre d’analyse des coûts, de budgets et d’alertes |
|---|---|---|
| Informations sur le compteur | MeterName, MeterId, MeterCategory, MeterSubcategory, ProductName, ConsumedService | Compteur, Catégorie du compteur, Sous-catégorie du compteur, Nom du service |
| Informations sur la ressource | InstanceId, ResourceType, ResourceGroup, SubscriptionGuid | Ressource, GUID de ressource, Type de ressource, Groupe de ressources, Nom du service |
| Tags | TenantId | TenantId |
| AdditionalInfo | AppId, TenantId |
Certains points de terminaison peuvent partager un compteur, et les données de facturation ne peuvent pas être réparties par point de terminaison. Une application cliente peut également configurer la journalisation de l’API côté client ou utiliser les journaux d’activité Microsoft Graph.
Limitations connues
Les limitations suivantes s’appliquent aux API limitées :
- Les API et services à l’évaluation dans Microsoft Graph sont actuellement disponibles uniquement dans l’environnement global Microsoft et non dans les déploiements de cloud national, y compris les déploiements Microsoft 365 GCC accessibles via le point de terminaison Microsoft Graph mondial. Pour plus d’informations sur les clouds nationaux, consultez Déploiements de clouds nationaux.
- L’application cible doit être une application cliente confidentielle (par exemple, application web, API web ou démon/service). Les applications clientes publiques (applications de bureau et mobiles) ne sont pas prises en charge.
- Les identités managées Azure ne sont pas prises en charge pour appeler des API limitées. Pour plus d’informations, consultez Services Azure qui prennent en charge les identités managées.