Skip to content

Commit 4aa96c1

Browse files
Learn Build Service GitHub AppLearn Build Service GitHub App
Learn Build Service GitHub App
authored and
Learn Build Service GitHub App
committed
Merging changes synced from https://github.com/microsoftgraph/microsoft-graph-docs (branch live)
2 parents 4af53b3 + 27780f2 commit 4aa96c1

File tree

155 files changed

+7669
-281
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

155 files changed

+7669
-281
lines changed

‎api-reference/beta/api/customdataprovidedresource-post-uploadsessions.md‎

Lines changed: 117 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,117 @@
1+
---
2+
title: "Create customDataProvidedResourceUploadSession"
3+
description: "Create a new customDataProvidedResourceUploadSession object."
4+
author: "pratima-cloudknox"
5+
ms.date: 10/09/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-id-governance"
8+
doc_type: apiPageType
9+
---
10+
11+
# Create customDataProvidedResourceUploadSession
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Create a new [customDataProvidedResourceUploadSession](../resources/customdataprovidedresourceuploadsession.md) object.
18+
19+
## Permissions
20+
21+
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).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "customdataprovidedresource-post-uploadsessions-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/customdataprovidedresource-post-uploadsessions-permissions.md)]
29+
30+
[!INCLUDE [rbac-entitlement-catalog-owner-write](../includes/rbac-for-apis/rbac-entitlement-management-catalog-owner-apis-write.md)]
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
POST /identityGovernance/entitlementManagement/accessPackageCatalogs/{accessPackageCatalogId}/accessPackageResources/{accessPackageResourceId}/uploadSessions
40+
```
41+
42+
## Request headers
43+
44+
|Header|Value|
45+
|:---|:---|
46+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
47+
|Content-Type|application/json. Required.|
48+
49+
## Request body
50+
51+
In the request body, supply a JSON representation of the [customDataProvidedResourceUploadSessionRequest](../resources/customdataprovidedresourceuploadsessionrequest.md) object.
52+
53+
You can specify the following properties when creating a **customDataProvidedResourceUploadSession**.
54+
55+
|Property|Type|Description|
56+
|:---|:---|:---|
57+
|source|String|The name of the Custom Data Provided Resource for which the customer is uploading data. Required.|
58+
|type|String| The odata type representing the columns of the CSV that are expected to be uploaded in this session. The possible values are: `accessReviewDataUploadTriggerCallbackData`. Required.|
59+
|data|[accessReviewResourceDataUploadSessionContextData](../resources/accessreviewresourcedatauploadsessioncontextdata.md)| Contains information about the access review definition and access review instance for which the data is being uploaded. Required.|
60+
61+
## Response
62+
63+
If successful, this method returns a `201 Created` response code and a [customDataProvidedResourceUploadSession](../resources/customdataprovidedresourceuploadsession.md) object in the response body.
64+
65+
## Examples
66+
67+
### Request
68+
69+
The following example shows a request.
70+
<!-- {
71+
"blockType": "request",
72+
"name": "create_customdataprovidedresourceuploadsession_from_"
73+
}
74+
-->
75+
``` http
76+
POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageCatalogs/6f4b1c6f-2a3d-4f8e-9b7a-5c1e2d3f4a6b/accessPackageResources/7b8a1c6f-2a3d-4f8e-9b7a-5c1e2d3f4a6b/uploadSessions
77+
Content-Type: application/json
78+
79+
{
80+
"source": "BuildingAccessData",
81+
"type": "#microsoft.graph.accessReviewDataUploadTriggerCallbackData",
82+
"data": {
83+
"accessReviewId": "9e4b1c6f-2a3d-4f8e-9b7a-5c1e2d3f4a6b",
84+
"accessReviewInstanceId": "6a9b1c6f-2a3d-4f8e-9b7a-5c1e2d3f4a6b"
85+
}
86+
}
87+
```
88+
89+
90+
### Response
91+
92+
The following example shows the response.
93+
>**Note:** The response object shown here might be shortened for readability.
94+
<!-- {
95+
"blockType": "response",
96+
"truncated": true,
97+
"@odata.type": "microsoft.graph.customDataProvidedResourceUploadSession"
98+
}
99+
-->
100+
``` http
101+
HTTP/1.1 201 Created
102+
Content-Type: application/json
103+
104+
{
105+
"id": "23f27c15-72f9-45fe-9e9c-e3d8f75bdc44",
106+
"status": "Active",
107+
"isUploadDone": false,
108+
"stats": {
109+
"filesUploaded": 0,
110+
"totalBytesUploaded": 0,
111+
},
112+
"files": [],
113+
"createdDateTime": "2024-03-06T01:35:12.123Z",
114+
"expirationDateTime": "2024-03-07T01:35:12.123Z"
115+
}
116+
```
117+

‎api-reference/beta/api/customdataprovidedresourceuploadsession-get.md‎

Lines changed: 108 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,108 @@
1+
---
2+
title: "Get customDataProvidedResourceUploadSession"
3+
description: "Read the properties and relationships of customDataProvidedResourceUploadSession object."
4+
author: "pratima-cloudknox"
5+
ms.date: 10/09/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-id-governance"
8+
doc_type: apiPageType
9+
---
10+
11+
# Get customDataProvidedResourceUploadSession
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Read the properties and relationships of a [customDataProvidedResourceUploadSession](../resources/customdataprovidedresourceuploadsession.md) object.
18+
19+
## Permissions
20+
21+
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).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "customdataprovidedresourceuploadsession-get-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/customdataprovidedresourceuploadsession-get-permissions.md)]
29+
30+
[!INCLUDE [rbac-entitlement-catalog-owner-write](../includes/rbac-for-apis/rbac-entitlement-management-catalog-owner-apis-write.md)]
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
GET /identityGovernance/entitlementManagement/accessPackageCatalogs/{accessPackageCatalogId}/accessPackageResources/{accessPackageResourceId}/uploadSessions/{customDataProvidedResourceUploadSessionId}
40+
```
41+
42+
## Optional query parameters
43+
44+
None.
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+
52+
## Request body
53+
54+
Don't supply a request body for this method.
55+
56+
## Response
57+
58+
If successful, this method returns a `200 OK` response code and a [customDataProvidedResourceUploadSession](../resources/customdataprovidedresourceuploadsession.md) object in the response body.
59+
60+
## Examples
61+
62+
### Request
63+
64+
The following example shows a request.
65+
<!-- {
66+
"blockType": "request",
67+
"name": "get_customdataprovidedresourceuploadsession"
68+
}
69+
-->
70+
``` http
71+
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageCatalogs/73eb2497-3b88-4c0a-8bb3-68ba8162beff/accessPackageResources/99ab2454-3b88-4c0a-8bb3-68ba8162beff/uploadSessions/23f27c15-72f9-45fe-9e9c-e3d8f75bdc44
72+
```
73+
74+
75+
### Response
76+
77+
The following example shows the response.
78+
>**Note:** The response object shown here might be shortened for readability.
79+
<!-- {
80+
"blockType": "response",
81+
"truncated": true,
82+
"@odata.type": "microsoft.graph.customDataProvidedResourceUploadSession"
83+
}
84+
-->
85+
``` http
86+
HTTP/1.1 200 OK
87+
Content-Type: application/json
88+
89+
{
90+
"id": "23f27c15-72f9-45fe-9e9c-e3d8f75bdc44",
91+
"status": "Complete",
92+
"isUploadDone": true,
93+
"stats": {
94+
"filesUploaded": 1,
95+
"totalBytesUploaded": 2000000,
96+
},
97+
"files": [
98+
{
99+
"name": "building-a-access.csv",
100+
"size": 2000000,
101+
"uploadedDateTime": "2024-03-06T01:35:12.123Z"
102+
}
103+
],
104+
"createdDateTime": "2024-03-06T01:35:12.123Z",
105+
"expirationDateTime": "2024-03-07T01:35:12.123Z"
106+
}
107+
```
108+

‎api-reference/beta/api/customdataprovidedresourceuploadsession-update.md‎

Lines changed: 116 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,116 @@
1+
---
2+
title: "Update customDataProvidedResourceUploadSession"
3+
description: "Update the properties of a customDataProvidedResourceUploadSession object."
4+
author: "pratima-cloudknox"
5+
ms.date: 10/09/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-id-governance"
8+
doc_type: apiPageType
9+
---
10+
11+
# Update customDataProvidedResourceUploadSession
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Update the properties of a [customDataProvidedResourceUploadSession](../resources/customdataprovidedresourceuploadsession.md) created for a [customDataProvidedResource](../resources/customdataprovidedresource.md) object.
18+
19+
## Permissions
20+
21+
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).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "customdataprovidedresourceuploadsession-update-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/customdataprovidedresourceuploadsession-update-permissions.md)]
29+
30+
[!INCLUDE [rbac-entitlement-catalog-owner-write](../includes/rbac-for-apis/rbac-entitlement-management-catalog-owner-apis-write.md)]
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
PATCH /identityGovernance/entitlementManagement/accessPackageCatalogs/{accessPackageCatalogId}/accessPackageResources/{accessPackageResourceId}/uploadSessions/{customDataProvidedResourceUploadSessionId}
40+
```
41+
42+
## Request headers
43+
44+
|Name|Description|
45+
|:---|:---|
46+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
47+
|Content-Type|application/json. Required.|
48+
49+
## Request body
50+
51+
[!INCLUDE [table-intro](../../includes/update-property-table-intro.md)]
52+
53+
54+
|Property|Type|Description|
55+
|:---|:---|:---|
56+
|isUploadDone|Boolean|Whether the upload session is completed. Required.|
57+
58+
59+
## Response
60+
61+
If successful, this method returns a `200 OK` response code and an updated [customDataProvidedResourceUploadSession](../resources/customdataprovidedresourceuploadsession.md) object in the response body. The only allowed update is to set isUploadDone to true.
62+
63+
## Examples
64+
65+
### Request
66+
67+
The following example shows a request.
68+
<!-- {
69+
"blockType": "request",
70+
"name": "update_customdataprovidedresourceuploadsession"
71+
}
72+
-->
73+
``` http
74+
PATCH https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageCatalogs/73eb2497-3b88-4c0a-8bb3-68ba8162beff/accessPackageResources/99ab2454-3b88-4c0a-8bb3-68ba8162beff/uploadSessions/23f27c15-72f9-45fe-9e9c-e3d8f75bdc44
75+
Content-Type: application/json
76+
77+
{
78+
"isUploadDone": true
79+
}
80+
```
81+
82+
83+
### Response
84+
85+
The following example shows the response.
86+
>**Note:** The response object shown here might be shortened for readability.
87+
<!-- {
88+
"blockType": "response",
89+
"truncated": true,
90+
"@odata.type": "microsoft.graph.customDataProvidedResourceUploadSession"
91+
}
92+
-->
93+
``` http
94+
HTTP/1.1 200 OK
95+
Content-Type: application/json
96+
97+
{
98+
"id": "23f27c15-72f9-45fe-9e9c-e3d8f75bdc44",
99+
"status": "Complete",
100+
"isUploadDone": true,
101+
"stats": {
102+
"filesUploaded": 1,
103+
"totalBytesUploaded": 2000000,
104+
},
105+
"files": [
106+
{
107+
"name": "building-a-access.csv",
108+
"size": 2000000,
109+
"uploadedDateTime": "2024-03-06T01:35:12.123Z"
110+
}
111+
],
112+
"createdDateTime": "2024-03-06T01:35:12.123Z",
113+
"expirationDateTime": "2024-03-07T01:35:12.123Z"
114+
}
115+
```
116+

0 commit comments

Comments
 (0)