更新 accessPackageAssignmentWorkflowExtension
命名空间:microsoft.graph
重要
Microsoft Graph /beta
版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
更新 accessPackageAssignmentWorkflowExtension 对象的属性。
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | EntitlementManagement.ReadWrite.All | 不可用。 |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用程序 | EntitlementManagement.ReadWrite.All | 不可用。 |
提示
在具有工作或学校帐户的委托方案中,还必须通过以下选项之一为已登录用户分配具有支持的角色权限的管理员角色:
- 在逻辑应用本身或更高范围(如资源组、订阅或管理组)上需要以下 Azure 角色 分配之一:
- 逻辑应用参与者
- 参与者
- 所有者
以及以下其中一项:
- 权利管理系统中最低特权角色为目录所有者的角色。 这是最低特权选项。
- 此操作支持的更多特权Microsoft Entra角色:
- 标识治理管理员
在仅限应用的情况下,可为调用应用分配上述受支持的角色之一,而不是 EntitlementManagement.ReadWrite.All
应用程序权限。
目录所有者角色的特权低于EntitlementManagement.Read.All
应用程序权限。 如果是在 logicAppTriggerEndpointConfiguration 中没有 URL
属性的委托调用,则调用方还需要在逻辑应用上获得授权。
有关详细信息,请参阅 权利管理中的委派和角色 以及如何 在权利管理中将访问管理委托给访问包管理员。
HTTP 请求
PUT /identityGovernance/entitlementManagement/accessPackageCatalogs/{catalogId}/customAccessPackageWorkflowExtensions/{customAccessPackageWorkflowExtensionId}
请求标头
名称 | 说明 |
---|---|
Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
Content-Type | application/json. 必需。 |
请求正文
在请求正文中, 仅 提供要更新的属性的值。 请求正文中未包含的现有属性会保留其以前的值,或者根据对其他属性值的更改重新计算。
下表指定可更新的属性。
属性 | 类型 | 说明 |
---|---|---|
authenticationConfiguration | customExtensionAuthenticationConfiguration | 身份验证类型。 继承自 customCalloutExtension。 可选。 |
description | String | accessPackageCustomWorkflowExtension 对象的说明。 继承自 customCalloutExtension。 可选。 |
displayName | String | accessPackageCustomWorkflowExtension 的显示名称。 继承自 customCalloutExtension。 可选。 |
endpointConfiguration | customExtensionEndpointConfiguration | 用于配置终结点以调用逻辑应用的工作流的类型和详细信息。 继承自 customCalloutExtension。 可选。 |
callbackConfiguration | customExtensionCallbackConfiguration | 回调的超时持续时间。 可选。 |
响应
如果成功,此方法在响应正文中返回响应 200 OK
代码和更新的 accessPackageAssignmentWorkflowExtension 对象。
示例
请求
以下示例显示了一个请求。
PUT https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageCatalogs/32efb28c-9a7a-446c-986b-ca6528c6669d/accessPackageCustomWorkflowExtensions/78ffaec5-ae8e-4902-a434-5ffc5d3d3cd0
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.accessPackageAssignmentWorkflowExtension",
"displayName": "test_action_0124_email",
"description": "this is for graph testing only"
}
响应
以下示例显示了相应的响应。
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-Type: application/json
{
"value":{
"@odata.type":"#microsoft.graph.accessPackageAssignmentWorkflowExtension",
"id":"78ffaec5-ae8e-4902-a434-5ffc5d3d3cd0",
"displayName":"test_action_0127_email",
"description": "this is for graph testing only",
"createdDateTime":"2022-01-24T21:48:57.15Z",
"lastModifiedDateTime":"2022-01-24T21:55:44.953Z",
"clientConfiguration":null,
"endpointConfiguration":{
"@odata.type":"#microsoft.graph.logicAppTriggerEndpointConfiguration",
"subscriptionId":"38ab2ccc-3747-4567-b36b-9478f5602f0d",
"resourceGroupName":"test",
"logicAppWorkflowName":"elm-extension-email",
"url":"https://prod-31.eastus.logic.azure.com:443/workflows/7ccffea766ae48e680gd9a22d1549bbc/triggers/manual/paths/invoke?api-version=2016-10-01"
},
"authenticationConfiguration":{
"@odata.type":"#microsoft.graph.azureAdPopTokenAuthentication"
}
}
}