accessPackageAssignmentRequest: resume

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

在等待自定义扩展的回调后恢复用户的访问包请求。

在 Microsoft Entra 权利管理中,当启用访问包策略来调用自定义扩展,并且请求处理正在等待客户的回调时,客户可以启动恢复操作。 它是对 requestStatus 处于状态的 WaitingForCallbackaccessPackageAssignmentRequest 对象执行的。

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

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

权限

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

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

提示

对于使用工作或学校帐户的委派访问权限,必须通过以下选项之一为登录用户分配具有受支持角色权限的管理员角色:

  • 权利管理系统中的角色,其中最小特权角色为:
    • 访问包分配管理员。 这是特权最低的选项
    • 访问包管理器
    • 目录所有者
  • 此操作支持的更多特权 Microsoft Entra 角色:
    • Identity Governance Administrator

在仅限应用的情况下,可为调用应用分配上述支持的角色之一,而不是 EntitlementManagement.ReadWrite.All 应用程序权限。 访问包分配管理员角色的特EntitlementManagement.ReadWrite.All权低于应用程序权限。

有关详细信息,请参阅 权利管理中的委派和角色以及如何 将 访问治理委托给权利管理中的访问包管理员。

HTTP 请求

注意

该 /accessPackageAssignmentRequests 路径将很快停用。 请改用 /assignmentRequests 路径。

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

请求标头

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

请求正文

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

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

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

响应

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

示例

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

请求

下面的示例显示了一个调用请求,以恢复一个等待回调的访问包分配请求。

POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentRequests/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/beta/identityGovernance/entitlementManagement/accessPackageAssignmentRequests/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

示例 3:恢复访问包分配请求

请求

下面的示例显示了一个调用请求,以恢复一个等待回调的访问包分配请求。

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

{
  "source": "Contoso.AADProcess",
  "type": "microsoft.graph.accessPackageCustomExtensionStage.assignmentRequestCreated",
  "data": {
    "@odata.type": "microsoft.graph.accessPackageRequestApprovalStageCallbackConfiguration",
    "stage": "assignmentRequestCreated",
    "customExtensionStageInstanceId": "7bf58d34-b3f9-4bae-8deb-abcd25cddea1",
    "customExtensionStageInstanceDetail": "Completed."
  }
}

响应

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

HTTP/1.1 204 No Content

示例 4:从自定义扩展恢复访问包分配请求

请求

下面的示例显示了一个调用恢复访问包分配请求的请求,该请求正在等待来自自定义扩展的回调,以确定访问包分配的审批者。

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

{
  "source": "Contoso.CustoEXT",
  "type": "microsoft.graph.accessPackageCustomExtensionStage.assignmentRequestCreated",
  "data": {
    "@odata.type": "microsoft.graph.microsoft.graph.assignmentRequestApprovalStageCallbackData",
    "approvalStage": {
      "durationBeforeAutomaticDenial": "P2D",
      "escalationApprovers": [],
      "fallbackEscalationApprovers": [],
      "fallbackPrimaryApprovers": [],
      "isApproverJustificationRequired": false,
      "isEscalationEnabled": false,
      "primaryApprovers": [
        {
          "@@odata.type": "#microsoft.graph.singleUser",
          "description": "Primary approver of access package assignment.",
          "id": "",
          "isBackup": false
        }
      ]
    },
    "customExtensionStageInstanceDetail": "A approval stage from Logic Apps",
    "customExtensionStageInstanceId": "@{triggerBody()?['CustomExtensionStageInstanceId']}",
    "stage": "assignmentRequestDeterminingApprovalRequirements"
  },
  "source": "LogicApps",
  "type": "microsoft.graph.accessPackageCustomExtensionStage.assignmentRequestCreated"
}

响应

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

HTTP/1.1 204 No Content