accessPackageAssignmentRequest：resume

  • 项目

命名空间：microsoft.graph

在Microsoft Entra权利管理中，如果启用了访问包策略来调用自定义扩展，并且请求处理正在等待客户的回调，则客户可以启动恢复操作。 它在 accessPackageAssignmentRequest 对象（其 requestStatus 处于状态） WaitingForCallback 上执行。

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ❌ ❌ ❌

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。

权限类型 最低特权权限 更高特权权限
委派（工作或学校帐户） EntitlementManagement.ReadWrite.All 不可用。
委派（个人 Microsoft 帐户） 不支持。 不支持。
应用程序 EntitlementManagement.ReadWrite.All 不可用。

HTTP 请求

POST /identityGovernance/entitlementManagement/assignmentRequests/{accessPackageAssignmentRequestId}/resume

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
Content-Type application/json. 必需。

请求正文

在请求正文中，提供参数的 JSON 表示形式。

下表显示了可用于此操作的参数。

参数 类型 说明
source String 来自客户尝试恢复请求的源，请求可以存储在服务中，并且有助于审核。
type String 指示在哪个阶段执行自定义标注扩展。 可能的值为： microsoft.graph.accessPackageCustomExtensionStage.assignmentRequestCreated、 microsoft.graph.accessPackageCustomExtensionStage.assignmentRequestApproved、、 microsoft.graph.accessPackageCustomExtensionStage.assignmentRequestGranted、 microsoft.graph.accessPackageCustomExtensionStage.assignmentRequestRemoved
data accessPackageAssignmentRequestCallbackData 包含有关对客户终结点进行的标注实例的信息。

响应

如果成功，此操作返回 204 No Content 响应代码。

示例

示例 1：恢复访问包分配请求

请求

下面是一个调用示例，用于恢复正在等待回调的访问包分配请求。

POST https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignmentRequests/0e60f18c-b2a0-4887-9da8-da2e30a39d99/resume
Content-Type: application/json

{
  "source": "Contoso.SodCheckProcess",
  "type": "microsoft.graph.accessPackageCustomExtensionStage.assignmentRequestCreated",
  "data": {
    "@odata.type": "microsoft.graph.accessPackageAssignmentRequestCallbackData",
    "stage": "assignmentRequestCreated",
    "customExtensionStageInstanceId": "957d0c50-466b-4840-bb5b-c92cea7141ff",
    "customExtensionStageInstanceDetail": "This user is all verified"
  }
}

响应

以下示例显示了相应的响应。

HTTP/1.1 204 No Content

示例 2：恢复和拒绝访问包分配请求

请求

下面是通过拒绝正在等待回调的请求来继续处理访问包分配请求的示例。 不能在 assignmentRequestCreated 标注阶段拒绝请求。

POST https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignmentRequests/9e60f18c-b2a0-4887-9da8-da2e30a39d99/resume
Content-Type: application/json

{
  "source": "Contoso.SodCheckProcess",
  "type": "microsoft.graph.accessPackageCustomExtensionStage.assignmentRequestCreated",
  "data": {
    "@odata.type": "microsoft.graph.accessPackageAssignmentRequestCallbackData",
    "stage": "AssignmentRequestCreated",
    "customExtensionStageInstanceId": "857d0c50-466b-4840-bb5b-c92cea7141ff",
    "state": "denied",
    "customExtensionStageInstanceDetail": "Potential risk user based on the SOD check"
  }
}

响应

以下示例显示了相应的响应。

HTTP/1.1 204 No Content