Utilisation de l’API de communication de service dans Microsoft Graph
L’API de communications de service fournit des publications d’intégrité du service et de centre de messages relatives aux services cloud Microsoft abonnés par votre locataire. Vous pouvez obtenir les données d’intégrité actuelles et historiques d’un service Microsoft (par exemple, le service Exchange Online est arrêté). Vous pouvez case activée l’intégrité du service pour déterminer si un problème est suivi et si une résolution est en cours avant d’appeler le support technique ou de passer du temps à résoudre les problèmes. Les publications du centre de messages vous permettent de suivre les modifications à venir, notamment les nouvelles fonctionnalités, les mises à jour et d’autres annonces importantes (par exemple, Exchange Online obtient une nouvelle fonctionnalité).
Autorisation
Microsoft Graph permet aux applications d’obtenir un accès autorisé à l’intégrité et de modifier les communications relatives à un service cloud Microsoft abonné par un locataire. Avec les autorisations déléguées ou d’application appropriées, votre application peut accéder aux données de communication pour le compte d’un utilisateur connecté, ou sans utilisateur connecté dans le locataire. Les types délégués et d’application de ces autorisations sont accordés uniquement par un administrateur.
Pour plus d’informations sur les jetons d’accès, l’inscription d’application et les autorisations déléguées et d’application, consultez Concepts de base de l’authentification et de l’autorisation.
Accéder à l’API de communications de service pour le compte de l’utilisateur connecté
Des autorisations déléguées sont nécessaires pour accéder à l’API de communications de service pour le compte d’un utilisateur connecté. Les applications canevas orientées client, telles que les Centre d'administration Microsoft 365 (accessibles uniquement aux rôles d’administrateur), peuvent appeler l’API de communications de service pour obtenir l’intégrité du service et les données d’annonces de service pour le locataire de l’utilisateur connecté, au nom de l’utilisateur connecté. Les utilisateurs peuvent déterminer si leurs services abonnés sont sains ou rencontrent des problèmes. Ils peuvent également en savoir plus sur les problèmes de service actuels affectant leurs locataires.
Contrôle d’accès en fonction du rôle pour l’accès de délégation
L’API de communications de service applique le contrôle d’accès en fonction du rôle (RBAC) pour déterminer si l’utilisateur connecté qui est au nom de dispose d’un rôle de Microsoft Entra requis. L’utilisateur connecté qui est au nom de doit avoir au moins l’un des rôles d’administrateur.
Pour plus d’informations sur les rôles d’administrateur Microsoft Entra, consultez :
- Les rôles d'administration dans le Centre d’administration Microsoft 365
- Microsoft Entra rôles intégrés
- Rôles dans Microsoft 365, y compris les rôles Microsoft Entra ID, spécifiques au service et interservices
Accéder à l’API de communications de service sans utilisateur
Les autorisations d’application sont nécessaires pour accéder à l’API de communications de service sans utilisateur connecté. Les applications qui s’exécutent en tant que services principaux, tels que les services d’analyse ou d’alerte, peuvent appeler l’API de communications de service avec leur propre identité et non au nom d’un utilisateur. Ces services back-end peuvent créer des pipelines d’alerte/de supervision personnalisés et appeler l’API de communications de service pour obtenir des données d’état du service et d’annonces de service.
Cas d’usage courants et autorisations requises
| Cas d'utilisation | Demandes d’API | Autorisations requises | Types d’autorisation pris en charge |
|---|---|---|---|
| Répertorier les vues d’ensemble de l’intégrité pour le locataire | Lister l’intégritéVues d’ensemble | ServiceHealth.Read.All | Délégué et application |
| Obtenir des informations d’intégrité de service spécifiques pour le locataire | Obtenir serviceHealth | ServiceHealth.Read.All | Délégué et application |
| Répertorier tous les problèmes de service pour le locataire | Répertorier les problèmes | ServiceHealth.Read.All | Délégué et application |
| Obtenir un problème de service spécifique pour le locataire | Obtenir le problème | ServiceHealth.Read.All | Délégué et application |
| Obtenir un rapport de révision post-incident pour le locataire | Obtenir le rapport d’incident | ServiceHealth.Read.All | Délégué et application |
| Répertorier tous les messages de service pour le locataire | Répertorier des messages | ServiceMessage.Read.All | Délégué et application |
| Obtenir un message de service spécifique pour le locataire | Obtenir un message | ServiceMessage.Read.All | Délégué et application |
| Mettre à jour les status de message de service pour l’utilisateur connecté | Pour obtenir la liste des opérations status, consultez serviceUpdateMessage. | ServiceMessageViewpoint.Write | Delegated |
Disponibilité dans les clouds nationaux
Cette API de communication de service est disponible dans tous les déploiements de cloud national Microsoft. Vous pouvez obtenir des données de communication et d’intégrité du service pour tous les locataires dans les clouds nationaux Microsoft. Pour plus d’informations, consultez Déploiements de cloud national.
| Clouds nationaux | URL de l’API (partielle) |
|---|---|
| Service global Microsoft Graph | https://graph.microsoft.com/beta/admin/serviceAnnouncement/| |
| Microsoft Graph for US Government L4 (GccHigh) | https://graph.microsoft.us/beta/admin/serviceAnnouncement/ |
| Microsoft Graph for US Government L5 (DoD) | https://dod-graph.microsoft.us/beta/admin/serviceAnnouncement/ |
| Microsoft Graph en Chine géré par 21Vianet | https://microsoftgraph.chinacloudapi.cn/beta/admin/serviceAnnouncement/ |
Limites des communications de service
Pour garantir les performances du service, l’API de communications de service a des limites de limitation pour les demandes par locataire et par application. Pour plus d’informations sur les limites, consultez Limites de limitation pour le service de communications de service.
Prochaines étapes
L’API de communications de service peut vous ouvrir de nouvelles façons d’interagir avec les utilisateurs :