Compartilhar via

Trabalhar com a API de comunicações de serviço no Microsoft Graph

A API de comunicações de serviço fornece publicações do centro de mensagens e do estado de funcionamento do serviço relativas aos serviços cloud da Microsoft subscritos pelo seu inquilino. Pode obter dados de saúde atuais e históricos de um serviço Microsoft (por exemplo, o serviço Exchange Online está inativo). Pode marcar o estado de funcionamento do serviço para determinar se um problema é controlado e se está em curso uma resolução antes de chamar o suporte ou a resolução de problemas de tempo gasto. As mensagens do centro de mensagens permitem-lhe controlar as alterações futuras, incluindo novas funcionalidades, atualizações e outros anúncios importantes (por exemplo, Exchange Online está a obter uma nova funcionalidade).

Authorization

O Microsoft Graph permite que as aplicações obtenham acesso autorizado ao estado de funcionamento e alterem as comunicações sobre um serviço cloud da Microsoft subscrito por um inquilino. Com as permissões delegadas ou de aplicação adequadas, a sua aplicação pode aceder aos dados de comunicações em nome de um utilizador com sessão iniciada ou sem qualquer utilizador com sessão iniciada no inquilino. Os tipos de aplicação e delegados destas permissões são concedidos apenas por um administrador.

Para obter mais informações sobre tokens de acesso, registo de aplicações e permissões delegadas e de aplicações, veja Noções básicas de autenticação e autorização.

Aceder à API de comunicações do serviço em nome do utilizador com sessão iniciada

São necessárias permissões delegadas para aceder à API de comunicações de serviço em nome de um utilizador com sessão iniciada. As aplicações baseadas no 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 anúncios do serviço e do estado de funcionamento do serviço para o inquilino do utilizador com sessão iniciada, em nome do utilizador com sessão iniciada. Os utilizadores podem descobrir se os seus serviços subscritos estão em bom estado de funcionamento ou se têm problemas. Também podem saber mais sobre quaisquer problemas de serviço atuais que afetem os respetivos inquilinos.

Controlo de acesso baseado em funções para acesso de delegação

A API de comunicações de serviço também aplica o controlo de acesso baseado em funções (RBAC) para identificar se o utilizador com sessão iniciada que está em nome do utilizador exigiu Microsoft Entra função. O utilizador com sessão iniciada em nome de tem de ter, pelo menos, uma das funções de administrador.

Para obter mais informações sobre as funções de administrador Microsoft Entra, consulte:

Aceder à API de comunicações do serviço sem o utilizador

São necessárias permissões de aplicação para aceder à API de comunicações de serviço sem um utilizador com sessão iniciada. As aplicações que são executadas como serviços de back-end, como serviços de monitorização ou alerta, podem chamar a API de comunicações do serviço com a sua própria identidade e não em nome de um utilizador. Estes serviços de back-end podem criar pipelines de monitorização/alerta personalizados e chamar a API de comunicações do serviço para obter dados de anúncios do serviço e do estado de funcionamento do serviço.

Casos de utilização comuns e permissões necessárias

Casos de uso Pedidos de API Permissões obrigatórias Tipos de permissões suportados
List health overviews for tenant (Listar as descrições do estado de funcionamento do inquilino) Listar o estado de funcionamentoDescrições Geral ServiceHealth.Read.All Delegada e aplicação
Obter informações específicas do estado de funcionamento do serviço para o inquilino Obter serviceHealth ServiceHealth.Read.All Delegada e aplicação
Listar todos os problemas de serviço do inquilino Problemas de lista ServiceHealth.Read.All Delegada e aplicação
Obter um problema de serviço específico para o inquilino Obter problema ServiceHealth.Read.All Delegada e aplicação
Obter um relatório de revisão pós-incidente para o inquilino Obter relatório de incidente ServiceHealth.Read.All Delegada e aplicação
Listar todas as mensagens de serviço do inquilino Listar mensagens ServiceMessage.Read.All Delegada e aplicação
Obter uma mensagem de serviço específica para o inquilino Obter mensagem ServiceMessage.Read.All Delegada e aplicação
Atualizar status de mensagens do serviço para o utilizador com sessão iniciada Para obter uma lista de operações status, veja serviceUpdateMessage. ServiceMessageViewpoint.Write Delegated

Disponibilidade na cloud nacional do Microsoft Graph

A API de comunicações de serviço está disponível em clouds nacionais do Microsoft Graph. Pode obter dados de estado de funcionamento do serviço e de comunicações para os inquilinos de clouds nacionais.

Nuvens nacionais URL da API (parcial)
Serviço global do Microsoft Graph https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/|
Microsoft Graph for US Government L4 (GccHigh) https://graph.microsoft.us/v1.0/admin/serviceAnnouncement/
Microsoft Graph for US Government 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 cloud nacional, veja Clouds 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 os pedidos por inquilino por aplicação. Para obter detalhes sobre os limites, veja Limites de limitação do serviço de comunicações do serviço.

Próximas etapas

A API de comunicações de serviço pode abrir novas formas de interagir com os utilizadores. Para obter mais informações, confira o seguinte:

  • Last updated on