列出 taskProcessingResults

命名空间:microsoft.graph.identityGovernance

获取运行的任务ProcessingResult 资源。

此 API 可用于以下国家级云部署

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考

权限类型 最低特权权限 更高特权权限
委派(工作或学校帐户) LifecycleWorkflows.ReadReports.All LifecycleWorkflows.Read.All、LifecycleWorkflows.ReadWrite.All
委派(个人 Microsoft 帐户) 不支持。 不支持。
应用程序 LifecycleWorkflows.ReadReports.All LifecycleWorkflows.Read.All、LifecycleWorkflows.ReadWrite.All

重要

在具有工作或学校帐户的委托方案中,必须为登录用户分配受支持的Microsoft Entra角色或具有支持的角色权限的自定义角色。 全局读取者和生命周期工作流管理员是此操作支持的最低特权角色。

HTTP 请求

GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/taskProcessingResults

可选的查询参数

此方法支持 $select$orderby$expand$filter OData 查询参数来帮助自定义响应。 若要了解一般信息,请参阅 OData 查询参数

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权

请求正文

请勿提供此方法的请求正文。

响应

如果成功,此方法在 200 OK 响应正文中返回响应代码和 microsoft.graph.identityGovernance.taskProcessingResult 对象的集合。

示例

示例 1:从工作流获取运行报表中的任务处理结果

请求

以下示例显示了一个请求。

GET https://graph.microsoft.com/v1.0/identityGovernance/lifecycleWorkflows/workflows/a977dbe8-0f3f-4ae6-b3a7-29e1010ac4cc/runs/33bf1a9c-2b26-49b6-996f-ca416c518341/taskProcessingResults

响应

以下示例显示了相应的响应。

注意:为了提高可读性,可能缩短了此处显示的响应对象。

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identityGovernance/lifecycleWorkflows/workflows('a977dbe8-0f3f-4ae6-b3a7-29e1010ac4cc')/runs('33bf1a9c-2b26-49b6-996f-ca416c518341')/taskProcessingResults",
    "value": [
        {
            "completedDateTime": "2023-01-20T17:16:03.4863553Z",
            "createdDateTime": "2023-01-20T17:16:00.9095011Z",
            "id": "7a21089f-ec13-4e9c-997e-b31f4e59d41e",
            "processingStatus": "completed",
            "startedDateTime": "2023-01-20T17:16:02.8025169Z",
            "failureReason": null,
            "subject": {
                "id": "1baa57fa-3c4e-4526-ba5a-db47a9df95f0"
            },
            "task": {
                "category": "joiner,leaver",
                "continueOnError": false,
                "description": "Add user to selected groups",
                "displayName": "Add User To Groups",
                "executionSequence": 3,
                "id": "c8dbaed8-3d23-4e5a-8f65-130767639667",
                "isEnabled": true,
                "taskDefinitionId": "22085229-5809-45e8-97fd-270d28d66910",
                "arguments": [
                    {
                        "name": "groupID",
                        "value": "1624be55-d924-491e-ac72-401f6f961e4d"
                    }
                ]
            }
        }
    ]
}

示例 2:在工作流的运行报告中获取任务处理结果的特定属性

请求

以下示例显示了一个请求。

GET https://graph.microsoft.com/v1.0/identityGovernance/lifecycleWorkflows/workflows/a977dbe8-0f3f-4ae6-b3a7-29e1010ac4cc/runs/33bf1a9c-2b26-49b6-996f-ca416c518341/taskProcessingResults?$select=id,failureReason,processingStatus,subject

响应

以下示例显示了相应的响应。

注意:为了提高可读性,可能缩短了此处显示的响应对象。

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identityGovernance/lifecycleWorkflows/workflows('a977dbe8-0f3f-4ae6-b3a7-29e1010ac4cc')/runs('33bf1a9c-2b26-49b6-996f-ca416c518341')/taskProcessingResults(id,failureReason,processingStatus,subject)",
    "value": [
        {
            "id": "7a21089f-ec13-4e9c-997e-b31f4e59d41e",
            "processingStatus": "completed",
            "failureReason": null,
            "subject": {
                "id": "1baa57fa-3c4e-4526-ba5a-db47a9df95f0"
            },
            "task": {
                "category": "joiner,leaver",
                "continueOnError": false,
                "description": "Add user to selected groups",
                "displayName": "Add User To Groups",
                "executionSequence": 3,
                "id": "c8dbaed8-3d23-4e5a-8f65-130767639667",
                "isEnabled": true,
                "taskDefinitionId": "22085229-5809-45e8-97fd-270d28d66910",
                "arguments": [
                    {
                        "name": "groupID",
                        "value": "1624be55-d924-491e-ac72-401f6f961e4d"
                    }
                ]
            }
        }
    ]
}