Trabajar con la API de comunicaciones de servicio en Microsoft Graph
La API de comunicaciones de servicio proporciona publicaciones del centro de mensajes y estado del servicio relacionadas con los servicios en la nube de Microsoft suscritos por el inquilino. Puede obtener datos de mantenimiento actuales e históricos de un servicio de Microsoft (por ejemplo, el servicio Exchange Online está inactivo). Puede comprobar el estado del servicio para determinar si se realiza un seguimiento de un problema y si hay una resolución en curso antes de llamar al soporte técnico o dedicar tiempo a solucionarlo. Las publicaciones del Centro de mensajes le permiten realizar un seguimiento de los próximos cambios, incluidas las nuevas características, actualizaciones y otros anuncios importantes (por ejemplo, Exchange Online está obteniendo una nueva característica).
Autorización
Microsoft Graph permite a las aplicaciones obtener acceso autorizado al estado y cambiar las comunicaciones sobre un servicio en la nube de Microsoft suscrito por un inquilino. Con los permisos delegados o de aplicación adecuados, la aplicación puede acceder a los datos de comunicaciones en nombre de un usuario que ha iniciado sesión o sin ningún usuario que haya iniciado sesión en el inquilino. Los tipos delegados y de aplicación de estos permisos solo los concede un administrador.
Para obtener más información sobre los tokens de acceso, el registro de aplicaciones y los permisos delegados y de aplicación, consulte Conceptos básicos de autenticación y autorización.
API de comunicaciones del servicio de acceso en nombre del usuario que ha iniciado sesión
Se necesitan permisos delegados para acceder a la API de comunicaciones de servicio en nombre de un usuario que ha iniciado sesión. Las aplicaciones de lienzo orientadas al cliente, como la Centro de administración de Microsoft 365 (accesible solo para los roles de administrador), pueden llamar a la API de comunicaciones del servicio para obtener los datos de anuncios de servicio y estado del servicio para el inquilino del usuario que ha iniciado sesión, en nombre del usuario que ha iniciado sesión. Los usuarios pueden averiguar si sus servicios suscritos están en buen estado o si tienen problemas. También pueden obtener información sobre los problemas de servicio actuales que afectan a sus inquilinos.
Control de acceso basado en rol para el acceso de delegación
La API de comunicaciones de servicio aplica el control de acceso basado en rol (RBAC) para identificar si el usuario que ha iniciado sesión en nombre de tiene un rol de Microsoft Entra necesario. El usuario que ha iniciado sesión en nombre de debe tener al menos uno de los roles de administrador.
Para obtener más información sobre los roles de administrador de Microsoft Entra, consulte:
- Acerca de los roles de administrador en el Centro de administración de Microsoft 365
- Microsoft Entra roles integrados
- Roles en Microsoft 365, incluidos los roles de Microsoft Entra ID, específicos del servicio y entre servicios
API de comunicaciones de servicio de acceso sin usuario
Se necesitan permisos de aplicación para acceder a la API de comunicaciones del servicio sin que un usuario haya iniciado sesión. Las aplicaciones que se ejecutan como servicios back-end, como los servicios de supervisión o alertas, pueden llamar a la API de comunicaciones de servicio con su propia identidad y no en nombre de un usuario. Estos servicios back-end pueden crear canalizaciones personalizadas de supervisión y alertas y llamar a la API de comunicaciones de servicio para obtener datos de anuncios de servicio y estado del servicio.
Casos de uso comunes y permisos necesarios
| Casos de uso | Solicitudes de API | Permisos necesarios | Tipos de permisos admitidos |
|---|---|---|---|
| Información general sobre el estado de la lista para el inquilino | Enumerar healthOverviews | ServiceHealth.Read.All | Delegado y aplicación |
| Obtención de información de estado de servicio específica para el inquilino | Obtener serviceHealth | ServiceHealth.Read.All | Delegado y aplicación |
| Enumerar todos los problemas de servicio para el inquilino | Enumerar problemas | ServiceHealth.Read.All | Delegado y aplicación |
| Obtención de un problema de servicio específico para el inquilino | Obtener problema | ServiceHealth.Read.All | Delegado y aplicación |
| Obtención de un informe de revisión posterior al incidente para el inquilino | Obtención del informe de incidentes | ServiceHealth.Read.All | Delegado y aplicación |
| Enumerar todos los mensajes de servicio para el inquilino | Enumerar mensajes | ServiceMessage.Read.All | Delegado y aplicación |
| Obtener un mensaje de servicio específico para el inquilino | Obtener mensaje | ServiceMessage.Read.All | Delegado y aplicación |
| Actualización del estado del mensaje de servicio para el usuario que ha iniciado sesión | Para obtener una lista de las operaciones de estado, vea serviceUpdateMessage. | ServiceMessageViewpoint.Write | Delegated |
Disponibilidad en nubes nacionales
Esa API de comunicaciones de servicio está disponible en todas las implementaciones de nube nacionales de Microsoft. Puede obtener datos de comunicaciones y estado del servicio para cualquier inquilino en nubes nacionales de Microsoft. Para obtener más información, consulte Implementaciones nacionales de nube.
| Nubes nacionales | DIRECCIÓN URL de API (parcial) |
|---|---|
| Servicio global de Microsoft Graph | https://graph.microsoft.com/beta/admin/serviceAnnouncement/| |
| Microsoft Graph para US Government L4 (GccHigh) | https://graph.microsoft.us/beta/admin/serviceAnnouncement/ |
| Microsoft Graph para US Government L5 (DoD) | https://dod-graph.microsoft.us/beta/admin/serviceAnnouncement/ |
| Microsoft Graph China gestionado por 21Vianet | https://microsoftgraph.chinacloudapi.cn/beta/admin/serviceAnnouncement/ |
Límites de comunicaciones de servicio
Para garantizar el rendimiento del servicio, la API de comunicaciones de servicio tiene límites de limitación para las solicitudes por inquilino por aplicación. Para obtener más información sobre los límites, consulte Límites de limitación para el servicio de comunicaciones de servicio.
Pasos siguientes
La API de comunicaciones de servicio puede abrir nuevas formas de interactuar con los usuarios: