Vue d’ensemble des API et des services à l’usage dans Microsoft Graph
Microsoft Graph inclut des API qui sont disponibles sans coût supplémentaire avec les licences d’abonnement utilisateur et les API et services qui sont mesurés. Les API et les services à l’usage dans Microsoft Graph entraînent des coûts en fonction de l’utilisation. Les coûts peuvent être induits par appel d’API effectué, par objet retourné dans un appel d’API ou par le biais d’autres mesures.
Qu’elles soient mesurées ou non, les API de Microsoft Graph suivent ces deux principes :
- Propriété des données client : les données client appartiennent au client. En savoir plus sur la façon dont Microsoft catégorise les données client.
- Accès raisonnable : le service fournit l’accès au contenu client, dans les limites définies.
Le contrôle de certaines API permet de garantir l’intégrité de l’écosystème Microsoft Graph actuel et futur en équilibrant l’accès à la plateforme et le coût. Dans le cas où une API Microsoft Graph incluse avec les licences d’abonnement utilisateur serait limitée, il s’agirait d’une modification non rétrocompatible et les stratégies de contrôle de version, de prise en charge et de changement cassant pour Microsoft Graph s’appliqueraient.
Pour obtenir la liste des API et services à l’usage, consultez API et services à l’usage.
Catégories d’API et contrôle
Les API Microsoft Graph se répartissent en trois catégories, et le contrôle peut s’appliquer en fonction de la catégorie de l’API.
API standard
La plupart des API Microsoft Graph sont des API standard. Ces API effectuent des opérations standard (créer, lire, mettre à jour, supprimer) sur le contenu client et les points de terminaison administratifs. Des limites d’accès raisonnables pour ces API sont définies en fonction des seuils d’utilisation documentés. Cela permet de garantir une expérience client positive et encourage l’efficacité des modèles d’utilisation des API. L’accès aux API standard dans les seuils d’utilisation définis est disponible dans le cadre de la licence utilisateur sans frais supplémentaires.
API haute capacité
Les API à capacité élevée garantissent que les clients et les développeurs ont accès aux données à grande échelle. Cette catégorie inclut les points de terminaison d’exportation ou d’importation en bloc et les services Microsoft Graph. Ces API peuvent être mesurées et entraîner des coûts supplémentaires au-delà des licences d’abonnement utilisateur.
API avancées
Les API avancées permettent d’accéder à des données enrichies ou agrégées, ou à des fonctionnalités avancées qui s’étendent à partir de Microsoft 365. L’API assignSensitivityLabel est un exemple d’API avancée. Ces API peuvent être mesurées et entraîner des coûts supplémentaires au-delà des licences d’abonnement utilisateur.
Accès aux API limitées
Pour accéder aux API et services limités dans Microsoft Graph, une application doit être associée à un abonnement Microsoft Azure actif. Pour plus d’informations sur l’association d’une application à un abonnement, consultez Activer les API et les services limités dans Microsoft Graph.
Considérations relatives à l’utilisation d’API limitées
Gardez les considérations suivantes à l’esprit lorsque vous utilisez des API et des services à l’usage dans Microsoft Graph :
- Les API limitées peuvent retourner des erreurs liées à l’état de votre abonnement en plus d’autres erreurs courantes. Pour plus d’informations sur les erreurs Microsoft Graph, consultez Erreurs microsoft Graph et types de ressources.
- Les API limitées sont facturées en fonction de l’utilisation de l’API. Veillez à comprendre l’unité de mesure afin de pouvoir estimer les coûts associés à une API particulière.
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.