Skip to content

Commit 4c901d6

Browse files
DanipocketDanipocket
authored
Merge pull request #28732 from jccasey42/lcw/jackcasey/ProcessingInfoDocumentation
Updated documentation for processingInfo
2 parents 187eb72 + 24b49c8 commit 4c901d6

10 files changed

Lines changed: 74 additions & 18 deletions

‎api-reference/beta/api/identitygovernance-run-list-taskprocessingresults.md‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "List taskProcessingResults"
2+
title: "List taskProcessingResults (from a run)"
33
description: "Get the taskProcessingResult resources from a run."
44
author: "KristinaSmith"
55
ms.localizationpriority: medium
@@ -8,7 +8,7 @@ doc_type: apiPageType
88
ms.date: 04/05/2024
99
---
1010

11-
# List taskProcessingResults
11+
# List taskProcessingResults (from a run)
1212

1313
Namespace: microsoft.graph.identityGovernance
1414

@@ -127,6 +127,7 @@ Content-Type: application/json
127127
"processingStatus": "completed",
128128
"startedDateTime": "2023-01-20T17:16:02.8025169Z",
129129
"failureReason": null,
130+
"processingInfo": "User was already a member of all requested groups",
130131
"subject": {
131132
"id": "1baa57fa-3c4e-4526-ba5a-db47a9df95f0"
132133
},
@@ -164,7 +165,7 @@ The following example shows a request.
164165
}
165166
-->
166167
```msgraph-interactive
167-
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/a977dbe8-0f3f-4ae6-b3a7-29e1010ac4cc/runs/33bf1a9c-2b26-49b6-996f-ca416c518341/taskProcessingResults?$select=id,failureReason,processingStatus,subject
168+
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/a977dbe8-0f3f-4ae6-b3a7-29e1010ac4cc/runs/33bf1a9c-2b26-49b6-996f-ca416c518341/taskProcessingResults?$select=id,failureReason,processingStatus,subject,task
168169
```
169170

170171
# [C#](#tab/csharp)
@@ -212,7 +213,7 @@ HTTP/1.1 200 OK
212213
Content-Type: application/json
213214
214215
{
215-
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflows('a977dbe8-0f3f-4ae6-b3a7-29e1010ac4cc')/runs('33bf1a9c-2b26-49b6-996f-ca416c518341')/taskProcessingResults(id,failureReason,processingStatus,subject)",
216+
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflows('a977dbe8-0f3f-4ae6-b3a7-29e1010ac4cc')/runs('33bf1a9c-2b26-49b6-996f-ca416c518341')/taskProcessingResults(id,failureReason,processingStatus,subject,task)",
216217
"value": [
217218
{
218219
"id": "7a21089f-ec13-4e9c-997e-b31f4e59d41e",

‎api-reference/beta/api/identitygovernance-taskreport-list-taskprocessingresults.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,7 @@ Content-Type: application/json
127127
"processingStatus": "completed",
128128
"startedDateTime": "2022-08-24T23:28:05.1234966Z",
129129
"failureReason": null,
130+
"processingInfo": null,
130131
"subject": {
131132
"@odata.type": "#microsoft.graph.identityGovernance.ruleBasedSubjectSet",
132133
"id": "ea09ac2e-77e3-4134-85f2-25ccf3c33387"
@@ -150,6 +151,7 @@ Content-Type: application/json
150151
"processingStatus": "completed",
151152
"startedDateTime": "2022-08-24T23:28:05.1438145Z",
152153
"failureReason": null,
154+
"processingInfo": null,
153155
"subject": {
154156
"@odata.type": "#microsoft.graph.identityGovernance.ruleBasedSubjectSet",
155157
"id": "8cdf25a8-c9d2-423e-a03d-3f39f03c3e97"

‎api-reference/beta/api/identitygovernance-userprocessingresult-list-taskprocessingresults.md‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "List taskProcessingResults"
2+
title: "List taskProcessingResults (for a user)"
33
description: "Get the taskProcessingResult resources from the taskProcessingResults object."
44
author: "AlexFilipin"
55
ms.localizationpriority: medium
@@ -8,7 +8,7 @@ doc_type: apiPageType
88
ms.date: 04/05/2024
99
---
1010

11-
# List taskProcessingResults
11+
# List taskProcessingResults (for a user)
1212

1313
Namespace: microsoft.graph.identityGovernance
1414

@@ -128,6 +128,7 @@ Content-Type: application/json
128128
"processingStatus": "completed",
129129
"startedDateTime": "2022-08-24T23:28:05.1234966Z",
130130
"failureReason": null,
131+
"processingInfo": null,
131132
"subject": {
132133
"id": "ea09ac2e-77e3-4134-85f2-25ccf3c33387"
133134
},
@@ -150,6 +151,7 @@ Content-Type: application/json
150151
"processingStatus": "completed",
151152
"startedDateTime": "2022-08-24T23:28:06.3926865Z",
152153
"failureReason": null,
154+
"processingInfo": "User was already a member of all requested groups",
153155
"subject": {
154156
"id": "ea09ac2e-77e3-4134-85f2-25ccf3c33387"
155157
},
@@ -365,6 +367,7 @@ Content-Type: application/json
365367
"processingStatus": "completed",
366368
"startedDateTime": "2022-08-24T23:28:05.1234966Z",
367369
"failureReason": null,
370+
"processingInfo": null,
368371
"subject": {
369372
"id": "ea09ac2e-77e3-4134-85f2-25ccf3c33387"
370373
},
@@ -387,6 +390,7 @@ Content-Type: application/json
387390
"processingStatus": "completed",
388391
"startedDateTime": "2022-08-24T23:28:06.3926865Z",
389392
"failureReason": null,
393+
"processingInfo": "User was already a member of all requested groups",
390394
"subject": {
391395
"id": "ea09ac2e-77e3-4134-85f2-25ccf3c33387"
392396
},

‎api-reference/beta/resources/identitygovernance-taskprocessingresult.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,10 +30,11 @@ Inherits from [entity](../resources/entity.md).
3030
|:---|:---|:---|
3131
|completedDateTime|DateTimeOffset|The date time when taskProcessingResult execution ended. Value is `null` if task execution is still in progress.<br><br>Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.|
3232
|createdDateTime|DateTimeOffset|The date time when the taskProcessingResult was created.<br><br>Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.|
33-
|failureReason|String|Describes why the taskProcessingResult has failed.|
33+
|failureReason|String|Describes why the taskProcessingResult failed.|
3434
|id|String|Identifier used for individually addressing a specific task processing result. Inherited from [entity](../resources/entity.md).<br><br>Supports `$filter`(`eq`, `ne`) and `$orderby`.|
35+
|processingInfo|String|Additional human-readable context about the task processing outcome. This property contains information about edge cases where the task completed successfully but the expected action wasn't performed because the target was already in the desired state, such as when the user was already a member of the specified group. Returns `null` when no additional context is needed. Nullable.|
3536
|processingStatus|[microsoft.graph.identityGovernance.lifecycleWorkflowProcessingStatus](../resources/enums-identitygovernance-lifecycleworkflowprocessingstatus.md)|Describes the execution status of the `taskProcessingResult`. <br><br>Supports `$filter`(`eq`, `ne`) and `$orderby`.|
36-
|startedDateTime|DateTimeOffset|The date time when taskProcessingResult execution started. Value is `null` if task execution has not yet started.<br><br>Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.|
37+
|startedDateTime|DateTimeOffset|The date time when taskProcessingResult execution started. Value is `null` if task execution hasn't started yet.<br><br>Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.|
3738

3839
## Relationships
3940

@@ -60,6 +61,7 @@ The following JSON representation shows the resource type.
6061
"completedDateTime": "String (timestamp)",
6162
"createdDateTime": "String (timestamp)",
6263
"failureReason": "String",
64+
"processingInfo": "String",
6365
"processingStatus": "String",
6466
"startedDateTime": "String (timestamp)"
6567
}

‎api-reference/v1.0/api/identitygovernance-run-list-taskprocessingresults.md‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "List taskProcessingResults"
2+
title: "List taskProcessingResults (from a run)"
33
description: "Get the taskProcessingResult resources from a run."
44
author: "KristinaSmith"
55
ms.localizationpriority: medium
@@ -8,7 +8,7 @@ doc_type: apiPageType
88
ms.date: 04/04/2024
99
---
1010

11-
# List taskProcessingResults
11+
# List taskProcessingResults (from a run)
1212

1313
Namespace: microsoft.graph.identityGovernance
1414

@@ -125,6 +125,7 @@ Content-Type: application/json
125125
"processingStatus": "completed",
126126
"startedDateTime": "2023-01-20T17:16:02.8025169Z",
127127
"failureReason": null,
128+
"processingInfo": "User was already a member of all requested groups",
128129
"subject": {
129130
"id": "1baa57fa-3c4e-4526-ba5a-db47a9df95f0"
130131
},
@@ -162,7 +163,7 @@ The following example shows a request.
162163
}
163164
-->
164165
``` http
165-
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
166+
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,task
166167
```
167168

168169
# [C#](#tab/csharp)
@@ -210,7 +211,7 @@ HTTP/1.1 200 OK
210211
Content-Type: application/json
211212
212213
{
213-
"@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)",
214+
"@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,task)",
214215
"value": [
215216
{
216217
"id": "7a21089f-ec13-4e9c-997e-b31f4e59d41e",

‎api-reference/v1.0/api/identitygovernance-taskreport-list-taskprocessingresults.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -125,6 +125,7 @@ Content-Type: application/json
125125
"processingStatus": "completed",
126126
"startedDateTime": "2022-08-24T23:28:05.1234966Z",
127127
"failureReason": null,
128+
"processingInfo": null,
128129
"subject": {
129130
"@odata.type": "#microsoft.graph.identityGovernance.ruleBasedSubjectSet",
130131
"id": "ea09ac2e-77e3-4134-85f2-25ccf3c33387"
@@ -148,6 +149,7 @@ Content-Type: application/json
148149
"processingStatus": "completed",
149150
"startedDateTime": "2022-08-24T23:28:05.1438145Z",
150151
"failureReason": null,
152+
"processingInfo": null,
151153
"subject": {
152154
"@odata.type": "#microsoft.graph.identityGovernance.ruleBasedSubjectSet",
153155
"id": "8cdf25a8-c9d2-423e-a03d-3f39f03c3e97"

‎api-reference/v1.0/api/identitygovernance-userprocessingresult-list-taskprocessingresults.md‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "List taskProcessingResults"
2+
title: "List taskProcessingResults (for a user)"
33
description: "Get the taskProcessingResult resources from the taskProcessingResults object."
44
author: "AlexFilipin"
55
ms.localizationpriority: medium
@@ -8,7 +8,7 @@ doc_type: apiPageType
88
ms.date: 04/04/2024
99
---
1010

11-
# List taskProcessingResults
11+
# List taskProcessingResults (for a user)
1212

1313
Namespace: microsoft.graph.identityGovernance
1414

@@ -126,6 +126,7 @@ Content-Type: application/json
126126
"processingStatus": "completed",
127127
"startedDateTime": "2022-08-24T23:28:05.1234966Z",
128128
"failureReason": null,
129+
"processingInfo": null,
129130
"subject": {
130131
"id": "ea09ac2e-77e3-4134-85f2-25ccf3c33387"
131132
},
@@ -148,6 +149,7 @@ Content-Type: application/json
148149
"processingStatus": "completed",
149150
"startedDateTime": "2022-08-24T23:28:06.3926865Z",
150151
"failureReason": null,
152+
"processingInfo": null,
151153
"subject": {
152154
"id": "ea09ac2e-77e3-4134-85f2-25ccf3c33387"
153155
},
@@ -363,6 +365,7 @@ Content-Type: application/json
363365
"processingStatus": "completed",
364366
"startedDateTime": "2022-08-24T23:28:05.1234966Z",
365367
"failureReason": null,
368+
"processingInfo": null,
366369
"subject": {
367370
"id": "ea09ac2e-77e3-4134-85f2-25ccf3c33387"
368371
},
@@ -385,6 +388,7 @@ Content-Type: application/json
385388
"processingStatus": "completed",
386389
"startedDateTime": "2022-08-24T23:28:06.3926865Z",
387390
"failureReason": null,
391+
"processingInfo": "User was already a member of all requested groups",
388392
"subject": {
389393
"id": "ea09ac2e-77e3-4134-85f2-25ccf3c33387"
390394
},

‎api-reference/v1.0/resources/identitygovernance-taskprocessingresult.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,10 +28,11 @@ Inherits from [entity](../resources/entity.md).
2828
|:---|:---|:---|
2929
|completedDateTime|DateTimeOffset|The date time when taskProcessingResult execution ended. Value is `null` if task execution is still in progress.<br><br>Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.|
3030
|createdDateTime|DateTimeOffset|The date time when the taskProcessingResult was created.<br><br>Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.|
31-
|failureReason|String|Describes why the taskProcessingResult has failed.|
31+
|failureReason|String|Describes why the taskProcessingResult failed.|
3232
|id|String|Identifier used for individually addressing a specific task processing result. Inherited from [entity](../resources/entity.md).<br><br>Supports `$filter`(`eq`, `ne`) and `$orderby`.|
33+
|processingInfo|String|Additional human-readable context about the task processing outcome. This property contains information about edge cases where the task completed successfully but the expected action wasn't performed because the target was already in the desired state, such as when the user was already a member of the specified group. Returns `null` when no additional context is needed. Nullable.|
3334
|processingStatus|[microsoft.graph.identityGovernance.lifecycleWorkflowProcessingStatus](../resources/identitygovernance-taskprocessingresult.md)|Describes the execution status of the `taskProcessingResult`. The possible values are: `queued`, `inProgress`, `completed`, `completedWithErrors`, `canceled`, `failed`, `unknownFutureValue`.<br><br>Supports `$filter`(`eq`, `ne`) and `$orderby`.|
34-
|startedDateTime|DateTimeOffset|The date time when taskProcessingResult execution started. Value is `null` if task execution has not yet started.<br><br>Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.|
35+
|startedDateTime|DateTimeOffset|The date time when taskProcessingResult execution started. Value is `null` if task execution hasn't started yet.<br><br>Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.|
3536

3637
## Relationships
3738

@@ -58,6 +59,7 @@ The following JSON representation shows the resource type.
5859
"completedDateTime": "String (timestamp)",
5960
"createdDateTime": "String (timestamp)",
6061
"failureReason": "String",
62+
"processingInfo": "String",
6163
"processingStatus": "String",
6264
"startedDateTime": "String (timestamp)"
6365
}

‎changelog/Microsoft.AAD.LCM.json‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,41 @@
11
{
22
"changelog": [
3+
{
4+
"ChangeList": [
5+
{
6+
"Id": "14e09aad-a686-4b3d-88ab-a1076e2d052b",
7+
"ApiChange": "Property",
8+
"ChangedApiName": "processingInfo",
9+
"ChangeType": "Addition",
10+
"Description": "Added the **processingInfo** property to the [taskProcessingResult](https://learn.microsoft.com/en-us/graph/api/resources/identityGovernance-taskProcessingResult?view=graph-rest-beta) resource.",
11+
"Target": "taskProcessingResult"
12+
}
13+
],
14+
"Id": "14e09aad-a686-4b3d-88ab-a1076e2d052b",
15+
"Cloud": "Prod",
16+
"Version": "beta",
17+
"CreatedDateTime": "2026-05-06T17:17:32.7978124Z",
18+
"WorkloadArea": "Identity and access",
19+
"SubArea": "Governance"
20+
},
21+
{
22+
"ChangeList": [
23+
{
24+
"Id": "19398a2e-7e68-4d1b-b786-a0b73775007d",
25+
"ApiChange": "Property",
26+
"ChangedApiName": "processingInfo",
27+
"ChangeType": "Addition",
28+
"Description": "Added the **processingInfo** property to the [taskProcessingResult](https://learn.microsoft.com/en-us/graph/api/resources/identityGovernance-taskProcessingResult?view=graph-rest-1.0) resource.",
29+
"Target": "taskProcessingResult"
30+
}
31+
],
32+
"Id": "19398a2e-7e68-4d1b-b786-a0b73775007d",
33+
"Cloud": "Prod",
34+
"Version": "v1.0",
35+
"CreatedDateTime": "2026-05-06T17:17:32.7986703Z",
36+
"WorkloadArea": "Identity and access",
37+
"SubArea": "Governance"
38+
},
339
{
440
"ChangeList": [
541
{

‎concepts/whats-new-overview.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,8 @@ Use the new Copilot change notifications API for meetings AI insights to subscri
6666

6767
### Identity and access | Governance
6868

69-
Use `approverRemove` as a new supported value for the **requestType** property of the [accessPackageAssignmentRequest](/graph/api/resources/accesspackageassignmentrequest) resource. For more information, see [accessPackageAssignmentRequest](/graph/api/resources/accesspackageassignmentrequest).
69+
- Added the **processingInfo** property to the [taskProcessingResult](/graph/api/resources/identitygovernance-taskprocessingresult) resource. Use this property to get additional human-readable context about task execution outcomes, particularly for cases where the task completed successfully but the expected action wasn't performed because the target was already in the desired state.
70+
- Use `approverRemove` as a new supported value for the **requestType** property of the [accessPackageAssignmentRequest](/graph/api/resources/accesspackageassignmentrequest) resource. For more information, see [accessPackageAssignmentRequest](/graph/api/resources/accesspackageassignmentrequest).
7071

7172
### Identity and access | Identity and sign-in
7273

@@ -124,8 +125,9 @@ Added the **inheritedAppRoleAssignments** and **inheritedOauth2PermissionGrants*
124125

125126
### Identity and access | Governance
126127

127-
- Use `default`, `notVisible`, and `visible` as supported values for the **approverInformationVisibility** property of the [accessPackageApprovalStage](/graph/api/resources/accesspackageapprovalstage?view=graph-rest-beta&preserve-view=true) and [approvalStage](/graph/api/resources/approvalstage?view=graph-rest-beta&preserve-view=true) resources to indicate whether approver information is visible to the requestor.
128+
- Added the **processingInfo** property to the [taskProcessingResult](/graph/api/resources/identitygovernance-taskprocessingresult?view=graph-rest-beta&preserve-view=true) resource. Use this property to get additional human-readable context about task execution outcomes, particularly for cases where the task completed successfully but the expected action wasn't performed because the target was already in the desired state.
128129
- Added the [cancelProcessing](/graph/api/identitygovernance-workflow-cancelprocessing?view=graph-rest-beta&preserve-view=true) method to the [workflow](/graph/api/resources/identitygovernance-workflow?view=graph-rest-beta&preserve-view=true) resource to cancel workflow runs that are currently in progress or queued.
130+
- Use `default`, `notVisible`, and `visible` as supported values for the **approverInformationVisibility** property of the [accessPackageApprovalStage](/graph/api/resources/accesspackageapprovalstage?view=graph-rest-beta&preserve-view=true) and [approvalStage](/graph/api/resources/approvalstage?view=graph-rest-beta&preserve-view=true) resources to indicate whether approver information is visible to the requestor.
129131
- Added the **referenceId** property and the **files** relationship to [customDataProvidedResourceUploadSession](/graph/api/resources/customdataprovidedresourceuploadsession?view=graph-rest-beta&preserve-view=true) resource to identify the context for which data is being uploaded, such as an access review instance ID, and identify files uploaded during an upload session, respectively. Also added enhanced support for query capabilities for the [List customDataProvidedResourceUploadSession objects](/graph/api/accesspackageresource-list-uploadsessions?view=graph-rest-beta&preserve-view=true) API operation.
130132

131133
### Identity and access | Identity and sign-in

0 commit comments

Comments
 (0)