Microsoft 365 監視 API には、organizationの Microsoft 365 サブスクリプション内のさまざまな Microsoft サービスの正常性を監視するためのテレメトリ データが用意されています。 この機能はExchange Onlineから始まり、Microsoft TeamsやMicrosoft 365 Appsなどの他の Microsoft サービスに拡張されました。 Microsoft 365 監視は、ほぼリアルタイムのユーザー テレメトリ データを提供することで、監視性を高め、ダウンタイムを最小限に抑えます。
Authorization
Microsoft Graph を使用すると、アプリケーションは、テナントによってサブスクライブされた Microsoft サービスに関するテレメトリ データに対する承認されたアクセス権を取得できます。 適切な委任された アクセス許可またはアプリケーションのアクセス許可を使用すると、アプリは、サインインしているユーザーの代わりに、またはテナントにサインインしているユーザーなしでテレメトリ データにアクセスできます。 これらのアクセス許可の委任された種類とアプリケーションの種類の両方を付与できるのは管理者だけです。
アクセス トークン、アプリの登録、委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 認証と承認の基本」を参照してください。
サインインしているユーザーの代わりに Microsoft 365 監視 API にアクセスする
サインインしているユーザーの代わりに Microsoft 365 監視 API にアクセスするには、委任されたアクセス許可が必要です。 Microsoft 365 管理センター (管理者ロールからのみアクセス可能) などの顧客向けのキャンバス アプリケーションは、Microsoft 365 監視 API を呼び出して、サインインしているユーザーのテナントのテレメトリ データをサインイン ユーザーの代わりに取得できます。
委任アクセスのロールベースのアクセス制御
Microsoft 365 監視 API は、ロールベースのアクセス制御 (RBAC) を適用して、代理でサインインしているユーザーに必要なMicrosoft Entraロールがあるかどうかを識別します。 代理でサインインしているユーザーには、少なくとも 1 つの管理者ロールが必要です。
Microsoft Entra管理者ロールの詳細については、次を参照してください。
- Microsoft 365 管理センターの管理者ロールについて
- 組み込みロールのMicrosoft Entra
- Microsoft 365 のロール (Microsoft Entra ID、サービス固有のロール、サービス間ロールなど)
ユーザーなしで Microsoft 365 監視 API にアクセスする
サインインしているユーザーなしで Microsoft 365 監視 API にアクセスするには、アプリケーションのアクセス許可が必要です。 監視サービスやアラート サービスなどのバックエンド サービスとして実行されるアプリケーションは、ユーザーの代わりにではなく、独自の ID で Microsoft 365 監視 API を呼び出すことができます。 バックエンド サービスでは、Microsoft 365 監視 API を使用してテレメトリ データを取得できます。これにより、傾向を分析し、パフォーマンスを監視し、異常をリアルタイムで検出するカスタム ダッシュボードを構築できます。
国内クラウドでの可用性
Microsoft 365 監視 API は、次の Microsoft 国内クラウドデプロイで利用できます。 詳細については、「 各国のクラウドデプロイ」を参照してください。
| 国別クラウド | API URL (部分) |
|---|---|
| Microsoft Graph グローバル サービス | https://graph.microsoft.com/beta/reports/serviceActivity/| |
| Microsoft Graph for US Government L4 (GccHigh) | サポートされていません。 |
| Microsoft Graph for US Government L5 (DoD) | サポートされていません。 |
| 21Vianet によって運営されている Microsoft Graph China | サポートされていません。 |
一般的なユース ケース
次の表に、Microsoft 365 監視 API の一般的なユース ケースを示します。
| ユース ケース | 関連コンテンツ |
|---|---|
| Exchange Online の監視 | Microsoft 365 の Exchange Online の監視 |
| Microsoft 365 Teams の監視 | Microsoft 365 Teams の監視 |
| Microsoft 365 アプリの監視 | Microsoft 365 アプリの監視 |
| Microsoft Entra |
次の手順
Microsoft 365 監視 API を使用すると、ユーザーと関わる新しい方法を開くことができます。
- 使用可能な Microsoft 365 監視 API の詳細については、 serviceActivity リソースに関するページを参照してください。
- Graph エクスプローラーで API をお試しください。