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 servies suscritos están en buen estado o 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 también aplica el control de acceso basado en rol (RBAC) para identificar si el usuario que ha iniciado sesión en nombre ha requerido Microsoft Entra rol. 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 la nube nacional de Microsoft Graph
La API de comunicaciones de servicio está disponible en nubes nacionales de Microsoft Graph. Puede obtener datos de comunicaciones y estado del servicio para los inquilinos de nubes nacionales.
| Nubes nacionales | DIRECCIÓN URL de API (parcial) |
|---|---|
| Servicio global de Microsoft Graph | https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/| |
| Microsoft Graph para US Government L4 (GccHigh) | https://graph.microsoft.us/v1.0/admin/serviceAnnouncement/ |
| Microsoft Graph para US Government L5 (DoD) | https://dod-graph.microsoft.us/v1.0/admin/serviceAnnouncement/ |
| Microsoft Graph China gestionado por 21Vianet | https://microsoftgraph.chinacloudapi.cn/v1.0/admin/serviceAnnouncement/ |
Para obtener más información sobre la disponibilidad de la nube nacional, consulte Nubes nacionales de Microsoft Graph.
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. Para obtener más información, vea los artículos siguientes: