Trabajar con la API de comunicaciones de servicio en Microsoft Graph

  • Artículo

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:

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: