フィードバック 編集

Microsoft Graph でのサービス通信 API のGraph

  • [アーティクル]

サービス通信 API は、テナントがサブスクライブしている Microsoft クラウド サービスに関連するサービス正常性とメッセージ センターの投稿を提供します。 Microsoft サービスの現在および過去の正常性データを取得できます (たとえば、サービスがダウンExchange Onlineなど)。 サービスの正常性を確認して、問題が追跡され、解決が進行中かどうかを確認してから、サポートを呼び出したり、トラブルシューティングに時間を費やしたりできます。 メッセージ センターの投稿を使用すると、新機能、更新プログラム、その他の重要なアナウンス (たとえば、Exchange Online が新しい機能を取得しているなど)、今後の変更を追跡できます。

Authorization

Microsoft Graphでは、アプリケーションが正常性への承認されたアクセスを取得し、テナントがサブスクライブしている Microsoft クラウド サービスに関する通信を変更できます。 適切な委任またはアプリケーションのアクセス許可を使用すると、アプリは、サインインしているユーザーの代わりに、またはテナント内のサインインしているユーザーなしで通信データにアクセスできます。 これらのアクセス許可の委任された種類とアプリケーションの種類の両方は、管理者によってのみ付与されます。

アクセス トークン、アプリ登録、委任およびアプリケーションのアクセス許可の詳細については、「認証と承認の基本 」を参照してください。

サインインしているユーザーに代わってサービス通信 API にアクセスする

サインインしているユーザーに代わってサービス通信 API にアクセスするには、委任されたアクセス許可が必要です。 Microsoft 365 管理センター (管理者の役割にのみアクセス可能) などの顧客向けキャンバス アプリケーションは、サインインしているユーザーの代わりに、サービス通信 API を呼び出して、サインインしているユーザーのテナントのサービス正常性とサービスアナウンス データを取得できます。 ユーザーは、サブスクライブしたサービスが正常か、問題を持っているのかを確認できます。 また、テナントに影響を与える現在のサービスの問題について説明します。

ユーザーなしでサービス通信 API にアクセスする

サインインしているユーザーなしでサービス通信 API にアクセスするには、アプリケーションのアクセス許可が必要です。 監視サービスやアラート サービスなどのバックエンド サービスとして実行されるアプリケーションは、ユーザーの代わりにではなく、独自の ID でサービス通信 API を呼び出す可能性があります。 これらのバックエンド サービスは、カスタム監視/アラート パイプラインを構築し、サービス通信 API を呼び出して、サービスの正常性とサービスのお知らせデータを取得できます。

一般的な使用例と必要なアクセス許可

使用例 API 要求 必要なアクセス許可 サポートされているアクセス許可の種類
テナントの正常性の概要を一覧表示する リスト healthOverviews ServiceHealth.Read.All 委任とアプリケーション
テナントの特定のサービス正常性情報を取得する Get serviceHealth ServiceHealth.Read.All 委任とアプリケーション
テナントのすべてのサービスの問題を一覧表示する リストの問題 ServiceHealth.Read.All 委任とアプリケーション
テナントの特定のサービスの問題を取得する 問題を取得する ServiceHealth.Read.All 委任とアプリケーション
テナントのインシデント後レビュー レポートを取得する インシデント レポートの取得 ServiceHealth.Read.All 委任とアプリケーション
テナントのすべてのサービス メッセージを一覧表示する List messages ServiceMessage.Read.All 委任とアプリケーション
テナントの特定のサービス メッセージを取得する メッセージの取得 ServiceMessage.Read.All 委任とアプリケーション
サインインしているユーザーのサービス メッセージの状態を更新する 状態操作の一覧については、「 serviceUpdateMessage」を参照してください。 ServiceMessageViewpoint.Write 委任

国内クラウドの可用性

そのサービス通信 API は、Microsoft 国内のすべてのクラウド展開で利用できます。 Microsoft 国内クラウド内のすべてのテナントのサービス正常性と通信データを取得できます。 詳細については、「国内クラウド 展開」を参照してください。

国別クラウド API URL (部分的)
Microsoft Graph グローバル サービス https://graph.microsoft.com/beta/admin/serviceAnnouncement/|
Microsoft Graph米国政府機関 L4 (GccHigh) https://graph.microsoft.us/beta/admin/serviceAnnouncement/
Microsoft Graph米国政府機関 L5 (DoD) https://dod-graph.microsoft.us/beta/admin/serviceAnnouncement/
Microsoft Graph Germany https://graph.microsoft.de/beta/admin/serviceAnnouncement/
21Vianet によって運営されている Microsoft Graph China https://microsoftgraph.chinacloudapi.cn/beta/admin/serviceAnnouncement/

サービス通信の制限

サービスのパフォーマンスを保証するために、サービス通信 API には、アプリケーションごとのテナントごとの要求に対する調整制限があります。 制限の詳細については、「サービス通信サービス の調整制限」を参照してください。

新機能

この API セットに関する 最新機能や更新プログラム を検索してください。

次の手順

サービス通信 API は、ユーザーと関わる新しい方法を開く可能性があります。

さらに情報が必要な場合「パートナーによる Microsoft Graph の活用方法」を参照してください。