Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A API de comunicações de serviço fornece postagens de integridade de serviço e do centro de mensagens referentes aos serviços de nuvem da Microsoft assinados pelo seu locatário. Você pode obter dados de integridade atuais e históricos de um serviço da Microsoft (por exemplo, o serviço do Exchange Online está inoperante). Você pode marcar a integridade do serviço para determinar se um problema é rastreado e se uma resolução está em andamento antes de chamar o suporte ou gastar tempo solucionando problemas. As postagens do centro de mensagens permitem que você acompanhe as próximas alterações, incluindo novos recursos, atualizações e outros comunicados importantes (por exemplo, o Exchange Online está recebendo um novo recurso).
Authorization
O Microsoft Graph permite que os aplicativos obtenham acesso autorizado à integridade e alterem as comunicações sobre um serviço de nuvem da Microsoft assinado por um locatário. Com as permissões delegadas ou de aplicativo apropriadas, seu aplicativo pode acessar os dados de comunicação em nome de um usuário conectado ou sem nenhum usuário conectado no locatário. Os tipos delegados e de aplicativo dessas permissões são concedidos apenas por um administrador.
Para obter mais informações sobre tokens de acesso, registro de aplicativo e permissões delegadas e de aplicativo, consulte Noções básicas de autenticação e autorização.
Acessar a API de comunicações de serviço em nome do usuário conectado
Permissões delegadas são necessárias para acessar a API de comunicações de serviço em nome de um usuário conectado. Aplicativos de tela voltados para o cliente, como o Centro de administração do Microsoft 365 (acessível apenas para funções de administrador), podem chamar a API de comunicações de serviço para obter os dados de integridade do serviço e comunicados de serviço para o locatário do usuário conectado, em nome do usuário conectado. Os usuários podem descobrir se seus serviços assinados estão íntegros ou têm problemas. Eles também podem saber mais sobre quaisquer problemas de serviço atuais que afetem seus locatários.
Controle de acesso baseado em função para acesso de delegação
A API de comunicações de serviço também aplica o RBAC (controle de acesso baseado em função) para identificar se o usuário conectado que está em nome exigiu a função do Microsoft Entra. O usuário conectado que está em nome de deve ter pelo menos uma das funções de administrador.
Para obter mais informações sobre as funções de administrador do Microsoft Entra, confira:
- Sobre as funções de administrador no centro de administração do Microsoft 365
- Funções internas do Microsoft Entra
- Funções no Microsoft 365, incluindo o Microsoft Entra ID, funções específicas de serviço e entre serviços
Acessar a API de comunicações de serviço sem o usuário
As permissões de aplicativo são necessárias para acessar a API de comunicações de serviço sem um usuário conectado. Os aplicativos executados como serviços de back-end, como serviços de monitoramento ou alerta, podem chamar a API de comunicações de serviço com sua própria identidade e não em nome de um usuário. Esses serviços de back-end podem criar pipelines personalizados de monitoramento/alerta e chamar a API de comunicações de serviço para obter dados de integridade do serviço e comunicados de serviço.
Casos de uso comuns e permissões necessárias
| Casos de uso | Solicitações de API | Permissões obrigatórias | Tipos de permissão com suporte |
|---|---|---|---|
| Listar visões gerais de integridade para locatário | Listar healthOverviews | ServiceHealth.Read.All | Delegado e aplicação |
| Obter informações específicas de integridade do serviço para o locatário | Obter serviceHealth | ServiceHealth.Read.All | Delegado e aplicação |
| Listar todos os problemas de serviço para locatário | Listar problemas | ServiceHealth.Read.All | Delegado e aplicação |
| Obter um problema de serviço específico para o locatário | Obter problema | ServiceHealth.Read.All | Delegado e aplicação |
| Obter um relatório de revisão pós-incidente para o locatário | Obter relatório de incidente | ServiceHealth.Read.All | Delegado e aplicação |
| Listar todas as mensagens de serviço para locatário | Listar mensagens | ServiceMessage.Read.All | Delegado e aplicação |
| Obter uma mensagem de serviço específica para locatário | Obter mensagem | ServiceMessage.Read.All | Delegado e aplicação |
| Atualizar o status da mensagem de serviço para o usuário conectado | Para obter uma lista de operações de status, consulte serviceUpdateMessage. | ServiceMessageViewpoint.Write | Delegated |
Disponibilidade de nuvem nacional do Microsoft Graph
A API de comunicações de serviço está disponível nas nuvens nacionais do Microsoft Graph. Você pode obter dados de integridade e comunicações do serviço para seus locatários de nuvens nacionais.
| Nuvens nacionais | URL da API (parcial) |
|---|---|
| Serviço global do Microsoft Graph | https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/| |
| Microsoft Graph para o Governo dos EUA L4 (GccHigh) | https://graph.microsoft.us/v1.0/admin/serviceAnnouncement/ |
| Microsoft Graph para o Governo dos EUA L5 (DoD) | https://dod-graph.microsoft.us/v1.0/admin/serviceAnnouncement/ |
| Microsoft Graph China operado pela 21Vianet | https://microsoftgraph.chinacloudapi.cn/v1.0/admin/serviceAnnouncement/ |
Para obter detalhes sobre a disponibilidade da nuvem nacional, consulte Nuvens nacionais do Microsoft Graph.
Limites de comunicações de serviço
Para garantir o desempenho do serviço, a API de comunicações de serviço tem limites de limitação para as solicitações por locatário por aplicativo. Para obter detalhes sobre os limites, consulte limites de limitação para o serviço de comunicações de serviço.
Próximas etapas
A API de comunicações de serviço pode abrir novas maneiras de interagir com os usuários. Para obter mais informações, confira o seguinte: