Skip to content

Commit aa49182

Browse files
Learn Build Service GitHub AppLearn Build Service GitHub App
authored andcommitted
Merging changes synced from https://github.com/microsoftgraph/microsoft-graph-docs (branch live)
2 parents db104cd + 206e6e2 commit aa49182

23 files changed

Lines changed: 354 additions & 35 deletions
Lines changed: 105 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,105 @@
1+
---
2+
title: "accessReviewInstance: batchApplyCustomDataProvidedResourceDecisions"
3+
description: "Set the apply result on a custom data provided resource decision in a batch."
4+
author: "dotnet-enthusiast"
5+
ms.date: 04/01/2026
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-id-governance"
8+
doc_type: apiPageType
9+
---
10+
11+
# accessReviewInstance: batchApplyCustomDataProvidedResourceDecisions
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Enables reviewers to set the `applyResult` and `applyDescription` on all [accessReviewInstanceDecisionItem](../resources/accessreviewinstancedecisionitem.md) objects in batches by using **customDataProvidedResourceId**.
18+
19+
**NOTE:** The access review instance must be in an `Applying` state.
20+
21+
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
22+
23+
## Permissions
24+
25+
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
26+
27+
<!-- {
28+
"blockType": "permissions",
29+
"name": "accessreviewinstance-batchapplycustomdataprovidedresourcedecisions-permissions"
30+
}
31+
-->
32+
[!INCLUDE [permissions-table](../includes/permissions/accessreviewinstance-batchapplycustomdataprovidedresourcedecisions-permissions.md)]
33+
34+
[!INCLUDE [rbac-access-reviews-apis-write](../includes/rbac-for-apis/rbac-access-reviews-apis-write.md)]
35+
36+
## HTTP request
37+
38+
<!-- {
39+
"blockType": "ignored"
40+
}
41+
-->
42+
``` http
43+
POST /identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinitionId}/instances/{accessReviewInstanceId}/batchApplyCustomDataProvidedResourceDecisions
44+
```
45+
46+
## Request headers
47+
48+
|Name|Description|
49+
|:---|:---|
50+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
51+
|Content-Type|application/json. Required.|
52+
|x-accessreviews-version|`vNext`. Required.|
53+
54+
## Request body
55+
56+
In the request body, supply a JSON representation of the parameters.
57+
58+
The following table lists the parameters when you call this action.
59+
60+
|Parameter|Type|Description|
61+
|:---|:---|:---|
62+
|applyResult|[accessReviewInstanceDecisionItemApplyResult](../resources/enums.md)|The `applyResult` for the entity being reviewed. The possible values are: `new`, `appliedSuccessfully`, `appliedWithUnknownFailure`, `appliedSuccessfullyButObjectNotFound`, `applyNotSupported`. Required. |
63+
|applyDescription|String|If supplied, a description for the `applyResult`. Optional. |
64+
|customDataProvidedResourceId|String|The `applyResult` will be set on all **accessReviewInstanceDecisionItems** whose custom data provided resource `id` matches the supplied **customDataProvidedResourceId**. Required. |
65+
66+
67+
## Response
68+
69+
If successful, this action returns a `202 Accepted` response code.
70+
71+
## Examples
72+
73+
### Request
74+
75+
The following example shows a request.
76+
<!-- {
77+
"blockType": "request",
78+
"name": "accessreviewinstancethis.batchapplycustomdataprovidedresourcedecisions"
79+
}
80+
-->
81+
``` http
82+
POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinitionId}/instances/{accessReviewInstanceId}/batchApplyCustomDataProvidedResourceDecisions
83+
Content-Type: application/json
84+
85+
{
86+
"applyResult": "appliedSuccessfully",
87+
"applyDescription": "Access was removed from production application: GitHub-app.",
88+
"customDataProvidedResourceId": "5c728447-be5c-4565-b4d3-cb248b609891"
89+
}
90+
```
91+
92+
93+
### Response
94+
95+
The following example shows the response.
96+
>**Note:** The response object shown here might be shortened for readability.
97+
<!-- {
98+
"blockType": "response",
99+
"truncated": true
100+
}
101+
-->
102+
``` http
103+
HTTP/1.1 202 Accepted
104+
```
105+

api-reference/beta/api/agentidentity-post-sponsors.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
1616

1717
Add sponsors to an [agentIdentity](../resources/agentidentity.md). Sponsors can include users or groups. Sponsors may not include service principals or agent users.
1818

19+
A single agent identity may have up to 100 sponsors. No more than 5 sponsors may be groups. Only groups with dynamic membership or Microsoft 365 groups are supported as sponsors. Role-assignable groups can't be set as sponsors.
20+
1921
## Permissions
2022

2123
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/agentidentityblueprint-post-sponsors.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
1616

1717
Add a sponsor to an [agentIdentityBlueprint](../resources/agentidentityblueprint.md) object. Sponsors can include users or groups. Sponsors may not include service principals or agent users.
1818

19+
A single blueprint may have up to 100 sponsors. No more than 5 sponsors may be groups. Only groups with dynamic membership or Microsoft 365 groups are supported as sponsors. Role-assignable groups can't be set as sponsors.
20+
1921
## Permissions
2022

2123
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

api-reference/beta/api/agentidentityblueprintprincipal-post-sponsors.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,9 @@ Namespace: microsoft.graph
1414

1515
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
1616

17-
Add sponsors to an [agent identity blueprint principal](../resources/agentidentityblueprintprincipal.md) by posting to the sponsors collection.
17+
Add sponsors to an [agent identity blueprint principal](../resources/agentidentityblueprintprincipal.md). Sponsors can include users, groups, or service principals. Sponsors may not include agent users.
18+
19+
A single blueprint principal may have up to 100 sponsors. No more than 5 sponsors may be groups. Only groups with dynamic membership or Microsoft 365 groups are supported as sponsors. Role-assignable groups can't be set as sponsors.
1820

1921
## Permissions
2022

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
description: Automatically generated file. DO NOT MODIFY
3+
ms.topic: include
4+
ms.localizationpriority: medium
5+
---
6+
7+
|Permission type|Least privileged permission|Higher privileged permissions|
8+
|:---|:---|:---|
9+
|Delegated (work or school account)|AccessReview.ReadWrite.All|Not available.|
10+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
11+
|Application|AccessReview.ReadWrite.All|Not available.|
12+

api-reference/beta/resources/accessreviewinstance.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ Every **accessReviewInstance** contains a list of [decisions](accessreviewinstan
2727
|[List](../api/accessreviewscheduledefinition-list-instances.md) | [accessReviewInstance](accessreviewinstance.md) collection | Get a list of the [accessReviewInstance](../resources/accessreviewinstance.md) objects and their properties. |
2828
|[Get](../api/accessreviewinstance-get.md) | [accessReviewInstance](accessreviewinstance.md) | Read the properties and relationships of an [accessReviewInstance](../resources/accessreviewinstance.md) object. |
2929
|[Update](../api/accessreviewinstance-update.md)|[accessReviewInstance](../resources/accessreviewinstance.md)|Update the reviewers of an [accessReviewInstance](../resources/accessreviewinstance.md) object.|
30+
|[Apply custom data provided resource decisions](../api/accessreviewinstance-batchapplycustomdataprovidedresourcedecisions.md)|None|Set the `applyResult` on all decisions for a specific custom data provided resource in one call. |
3031
|[Filter by current user](../api/accessreviewinstance-filterbycurrentuser.md)|[accessReviewInstance](../resources/accessreviewinstance.md) collection|Returns all instances on a given [accessReviewScheduleDefinition](accessreviewscheduledefinition.md) for which the calling user is the reviewer of one or more decisions.|
3132
|[List contacted reviewers](../api/accessreviewinstance-list-contactedreviewers.md)|[accessReviewReviewer](../resources/accessreviewreviewer.md) collection|Get the reviewers who received notifications for an access review instance.|
3233
|[Send reminder](../api/accessreviewinstance-sendreminder.md) | None. | Send a reminder to the reviewers of an accessReviewInstance. |

api-reference/beta/resources/accessreviewinstancedecisionitemcustomdataprovidedresource.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "accessReviewInstanceDecisionItemCustomDataProvidedResource resource type"
33
description: "Represents custom data provided resources for which access is represented through an accessReviewInstanceDecisionItem object."
44
author: "dotnet-enthusiast"
5-
ms.date: 11/05/2025
5+
ms.date: 04/01/2026
66
ms.localizationpriority: medium
77
ms.subservice: "entra-id-governance"
88
doc_type: resourcePageType
@@ -24,9 +24,12 @@ Inherits from [accessReviewInstanceDecisionItemResource](../resources/accessrevi
2424
## Properties
2525
|Property|Type|Description|
2626
|:---|:---|:---|
27+
|customData|String|Custom data to include with the decision.|
2728
|description|String|The description of the custom data provided resource. Inherited from [accessReviewInstanceDecisionItemResource](../resources/accessreviewinstancedecisionitemresource.md).|
2829
|displayName|String|The display name of the custom data provided resource. Inherited from [accessReviewInstanceDecisionItemResource](../resources/accessreviewinstancedecisionitemresource.md).|
2930
|id|String|The identifier of the custom data provided resource. Inherited from [accessReviewInstanceDecisionItemResource](../resources/accessreviewinstancedecisionitemresource.md).|
31+
|scopeDisplayName|String|The name of the scope for the decision.|
32+
|scopeId|String|The id of the scope for the decision.|
3033
|type|String|The type of the custom data provided resource. Inherited from [accessReviewInstanceDecisionItemResource](../resources/accessreviewinstancedecisionitemresource.md).|
3134

3235
## Relationships
@@ -45,7 +48,10 @@ The following JSON representation shows the resource type.
4548
"id": "String",
4649
"displayName": "String",
4750
"type": "String",
48-
"description": "String"
51+
"description": "String",
52+
"customData": "String",
53+
"scopeId": "String",
54+
"scopeDisplayName": "String"
4955
}
5056
```
5157

api-reference/beta/resources/cloudpconpremisesconnection.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,7 @@ Represents a defined collection of Azure resource information that can be used t
5959
|subscriptionId|String|The ID of the target Azure subscription associated with your tenant.|
6060
|subscriptionName|String|The name of the target Azure subscription. Read-only.|
6161
|type (deprecated)|[cloudPcOnPremisesConnectionType](../resources/cloudpconpremisesconnection.md#cloudpconpremisesconnectiontype-values)|Specifies the method by which a provisioned Cloud PC is joined to Microsoft Entra. The `azureADJoin` option indicates the absence of an on-premises Active Directory (AD) in the current tenant, which results in the Cloud PC device only joining to Microsoft Entra. The `hybridAzureADJoin` option indicates the presence of an on-premises AD in the current tenant and that the Cloud PC joins both the on-premises AD and Microsoft Entra. The selected option also determines the types of users who can be assigned and can sign into a Cloud PC. The `azureADJoin` option allows both cloud-only and hybrid users to be assigned and sign in, whereas `hybridAzureADJoin` is restricted to hybrid users only. The default value is `hybridAzureADJoin`. The possible values are: `hybridAzureADJoin`, `azureADJoin`, `unknownFutureValue`. The **type** property is deprecated and stopped returning data on January 31, 2024. Going forward, use the **connectionType** property.|
62+
|subnetPrivateIpDetail |[cloudPcOnPremisesConnectionSubnetIpDetail](../resources/cloudpconpremisesconnectionsubnetipdetail.md) |Contains detailed information about the private IP addresses associated with the subnet. Returned only on `$select`. For an example that shows how to retrieve specific properties using `$select`, see [Example 2: Get the selected properties of an Azure network connection, including healthCheckStatusDetails](../api/cloudpconpremisesconnection-get.md#example-2-get-the-selected-properties-of-an-azure-network-connection-including-healthcheckstatusdetails). Read-only.|
6263

6364
### cloudPcManagementService values
6465

@@ -118,17 +119,18 @@ The following JSON representation shows the resource type.
118119
"alternateResourceUrl": "String",
119120
"connectionType": "String",
120121
"displayName": "String",
122+
"healthCheckPaused": "Boolean",
121123
"healthCheckStatus": "String",
122124
"healthCheckStatusDetail": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetail" },
123125
"healthCheckStatusDetails": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetails" },
124126
"id": "String (identifier)",
125127
"inUse": "Boolean",
126128
"inUseByCloudPc": "Boolean",
127-
"healthCheckPaused": "Boolean",
128129
"managedBy": "String",
129130
"organizationalUnit": "String",
130131
"resourceGroupId": "String",
131132
"subnetId": "String",
133+
"subnetPrivateIpDetail": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionSubnetIpDetail" },
132134
"subscriptionId": "String",
133135
"subscriptionName": "String",
134136
"type": "String",
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
title: "cloudPcOnPremisesConnectionSubnetIpDetail resource type"
3+
description: "Describes the subnet IP details of a Cloud PC on-premises connection."
4+
author: "shijun2026-3"
5+
ms.localizationpriority: medium
6+
ms.subservice: "cloud-pc"
7+
doc_type: resourcePageType
8+
ms.date: 03/05/2026
9+
---
10+
11+
# cloudPcOnPremisesConnectionSubnetIpDetail resource type
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Describes the subnet IP details of a [Cloud PC on-premises connection](../resources/cloudpconpremisesconnection.md).
18+
19+
[!INCLUDE [on-premise-rename-note](../../includes/on-premise-rename-note.md)]
20+
21+
## Properties
22+
23+
|Property|Type|Description|
24+
|:---|:---|:---|
25+
|subnetAvailableIpCount|Int32|The number of available private IP addresses within the subnet.|
26+
|subnetAvailableIpCountLastSyncDateTime|DateTimeOffset|Indicates the date and time at which the subnet available IP count was synced with Azure. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|
27+
28+
## Relationships
29+
30+
None.
31+
32+
## JSON representation
33+
34+
The following JSON representation shows the resource type.
35+
36+
<!-- {
37+
"blockType": "resource",
38+
"@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionSubnetIpDetail"
39+
}
40+
-->
41+
42+
``` json
43+
{
44+
"@odata.type": "#microsoft.graph.cloudPcOnPremisesConnectionSubnetIpDetail",
45+
"subnetAvailableIpCount": "Int32",
46+
"subnetAvailableIpCountLastSyncDateTime": "String (timestamp)"
47+
}
48+
```

api-reference/beta/resources/enums.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5988,3 +5988,14 @@ Possible values for user account types (group membership), per Windows definitio
59885988
|sessionPersistence|
59895989
|performance|
59905990
|unknownFutureValue|
5991+
5992+
### accessReviewInstanceDecisionItemApplyResult values
5993+
5994+
|Member|
5995+
|:---|
5996+
|new|
5997+
|appliedSuccessfully|
5998+
|appliedWithUnknownFailure|
5999+
|appliedSuccessfullyButObjectNotFound|
6000+
|applyNotSupported|
6001+
|unknownFutureValue|

0 commit comments

Comments
 (0)