命名空间:microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
创建新的 customDataProvidedResourceUploadSession 对象。
此 API 可用于以下国家级云部署。
| 全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
| 权限类型 | 最低特权权限 | 更高特权权限 |
|---|---|---|
| 委派(工作或学校帐户) | EntitlementManagement.ReadWrite.All | 不可用。 |
| 委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
| 应用程序 | EntitlementManagement.ReadWrite.All | 不可用。 |
提示
在具有工作或学校帐户的委托方案中,还必须通过以下选项之一为已登录用户分配具有支持的角色权限的管理员角色:
- 权利管理系统中最低特权角色为目录所有者的角色。 这是最低特权选项。
- 此作支持的更多特权Microsoft Entra角色:
- 标识治理管理员
在仅限应用的情况下,可为调用应用分配上述受支持的角色之一,而不是 EntitlementManagement.ReadWrite.All 应用程序权限。
目录所有者角色的特权低于EntitlementManagement.ReadWrite.All应用程序权限。
有关详细信息,请参阅 权利管理中的委派和角色 以及如何 在权利管理中将访问管理委托给访问包管理员。
HTTP 请求
POST /identityGovernance/entitlementManagement/accessPackageCatalogs/{accessPackageCatalogId}/accessPackageResources/{accessPackageResourceId}/uploadSessions
请求标头
| 标头 | 值 |
|---|---|
| Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
| Content-Type | application/json. 必需。 |
请求正文
在请求正文中,提供 customDataProvidedResourceUploadSessionRequest 对象的 JSON 表示形式。
在创建 customDataProvidedResourceUploadSession 时,可以指定以下属性。
| 属性 | 类型 | 说明 |
|---|---|---|
| source | String | 客户为其上传数据的自定义数据提供资源的名称。 必填。 |
| type | String | 表示应在此会话中上传的 CSV 列的 odata 类型。 可能的值为: accessReviewDataUploadTriggerCallbackData。 必填。 |
| data | accessReviewResourceDataUploadSessionContextData | 包含有关正在为其上传数据的访问评审定义和访问评审实例的信息。 必填。 |
响应
如果成功,此方法在 201 Created 响应正文中返回响应代码和 customDataProvidedResourceUploadSession 对象。
示例
请求
以下示例显示了一个请求。
POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageCatalogs/6f4b1c6f-2a3d-4f8e-9b7a-5c1e2d3f4a6b/accessPackageResources/7b8a1c6f-2a3d-4f8e-9b7a-5c1e2d3f4a6b/uploadSessions
Content-Type: application/json
{
"source": "BuildingAccessData",
"type": "#microsoft.graph.accessReviewDataUploadTriggerCallbackData",
"data": {
"accessReviewId": "9e4b1c6f-2a3d-4f8e-9b7a-5c1e2d3f4a6b",
"accessReviewInstanceId": "6a9b1c6f-2a3d-4f8e-9b7a-5c1e2d3f4a6b"
}
}
响应
以下示例显示了相应的响应。
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "23f27c15-72f9-45fe-9e9c-e3d8f75bdc44",
"status": "Active",
"isUploadDone": false,
"stats": {
"filesUploaded": 0,
"totalBytesUploaded": 0,
},
"files": [],
"createdDateTime": "2024-03-06T01:35:12.123Z",
"expirationDateTime": "2024-03-07T01:35:12.123Z"
}