subjectProcessingResult: summary

名前空間: microsoft.graph.identityGovernance

指定した期間内に subjectProcessingResult オブジェクトの subjectSummary を指定します。 リスト API によって返されるサブジェクト処理結果の数は非常に膨大になる可能性があるため、管理者はこの要約を使用して、カウントに基づく概要をすばやく取得できます。

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) LifecycleWorkflows-Reports.Read.All LifecycleWorkflows.Read.All、LifecycleWorkflows.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション LifecycleWorkflows-Reports.Read.All LifecycleWorkflows.Read.All、LifecycleWorkflows.ReadWrite.All

重要

職場または学校アカウントを使用してアクセスを委任するには、サインインしたユーザーに、サポートされている Microsoft Entra ロール、またはこの操作に必要なアクセス許可を付与するカスタム ロールが割り当てられている必要があります。 グローバル閲覧者 と ライフサイクル ワークフロー管理者 は、この操作でサポートされる最小特権ロールです。

HTTP 要求

GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/subjectProcessingResults/summary(startDateTime={TimeStamp},endDateTime={TimeStamp})

関数パラメーター

要求 URL で、次のクエリ パラメーターに値を指定します。

パラメーター 型 説明
startDateTime DateTimeOffset サブジェクト処理結果集計の開始日時。 必須です。
endDateTime DateTimeOffset サブジェクト処理結果要約の終了日時。 必須です。

オプションのクエリ パラメーター

このメソッドでは、応答のカスタマイズに役立つ OData クエリ パラメーターはサポートされていません。 一般的な情報については、「OData クエリ パラメーター」を参照してください。

要求ヘッダー

名前 説明
Authorization 必須。 認証と認可についての詳細をご覧ください。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、この関数は 200 OK 応答コードと応答本文で microsoft.graph.identityGovernance.subjectSummary を返します。

例

要求

次の例は要求を示しています。

GET https://graph.microsoft.com/v1.0/identityGovernance/lifecycleWorkflows/workflows/14879e66-9ea9-48d0-804d-8fea672d0341/runs/40efc576-8100-46eb-92c1-73eb43bb09a4/subjectProcessingResults/summary(startDateTime=2026-05-06T00:00:00Z,endDateTime=2026-05-13T00:00:00Z)

応答

次の例は応答を示しています。

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.identityGovernance.subjectSummary",
    "failedTasks": 3,
    "failedSubjects": 2,
    "successfulSubjects": 48,
    "totalTasks": 150,
    "totalSubjects": 50
}
  • Last updated on