命名空间:microsoft.graph
在 Microsoft Entra 权利管理中,访问包分配请求由想要获取访问包分配的用户或代表其创建。 如果请求成功,并获得任何必要的批准,则用户将收到访问包分配,并且是该最终的访问包分配的主体。 Microsoft Entra ID 还会自动创建访问包分配请求,以便跟踪访问删除。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | accessPackageAssignmentRequest 集合 | 检索 accesspackageassignmentrequest 对象的列表。 |
| 创建 | accessPackageAssignmentRequest | 创建新的 accessPackageAssignmentRequest 对象。 |
| Get | accessPackageAssignmentRequest | 读取 accessPackageAssignmentRequest 对象的属性和关系。 |
| 删除 | 无 | 删除 accessPackageAssignmentRequest。 |
| Cancel | accessPackageAssignmentRequest 集合 | 取消处于可取消状态的 accessPackageAssignmentRequest 对象。 |
| 按当前用户筛选 | accessPackageAssignmentRequest 集合 | 检索针对已登录用户筛选的 accessPackageAssignmentRequest 对象的列表。 |
| 重新处理 | 无 | 自动重试用户对访问包的访问权限的请求。 |
| Resume | 无 | 在等待自定义扩展的回调后恢复用户的访问包请求。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| 答案 | accessPackageAnswer 集合 | 请求者向 accessPackageQuestions 提供的答案是在请求时向他们提出的。 |
| completedDateTime | DateTimeOffset | 请求处理成功或失败的结束日期。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 只读。 |
| customExtensionCalloutInstances | customExtensionCalloutInstance 集合 | 有关在访问包分配工作流期间进行的所有自定义扩展调用的信息。 |
| createdDateTime | DateTimeOffset | 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 只读。 支持 $filter。 |
| id | String | 只读。 |
| 理由 | String | 请求者提供的理由。 |
| parameters | accessPackageAssignmentRequestParameters | 用于控制请求处理方式的其他参数,例如绕过在访问包策略上配置的审批要求。 |
| requestType | accessPackageRequestType | 请求的类型。 可能的值为: notSpecified、 userAdd、 userRemovesystemAddadminUpdateadminAdduserUpdatesystemUpdatesystemRemoveadminRemove (onBehalfAdd 不支持) 、 。 unknownFutureValue 使用 Prefer: include-unknown-enum-members 请求标头在此 可进化枚举中获取以下值: approverRemove.
用户请求的请求为 userAdd、 、 userUpdate或 。userRemove 设置后,无法更改此属性。 |
| schedule | entitlementManagementSchedule | 要为请求者分配访问权限的日期范围。 此属性在设置后无法更改,但可以将作业的新日程安排包含在另一个 userUpdate 作业请求或 adminUpdate 作业请求中。 |
| state | accessPackageRequestState | 请求的状态。 可取值包括:submitted、pendingApproval、delivering、delivered、deliveryFailed、denied、scheduled、canceled、partiallyDelivered、unknownFutureValue。 此为只读属性。 支持 $filter(eq)。 |
| status | String | 有关请求处理状态的详细信息。 只读。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| accessPackage | accessPackage | 与 accessPackageAssignmentRequest 关联的访问包。 访问包定义资源角色的集合以及一个或多个用户如何访问这些资源的策略。 此为只读属性。 可为 NULL。 支持 $expand。 |
| 工作分配 | accessPackageAssignment | 对于 requestTypeuserAddadminAdd或 ,这是请求创建的访问包分配。 对于 、 、 adminRemoveapproverRemove或 systemRemove的 requestTypeuserRemove,这具有id要删除的现有分配的属性。 支持 $expand。 |
| 请求者 | accessPackageSubject | 请求的主题,或者如果是直接分配,则分配了主题。 只读。 可为 NULL。 支持 $expand。 |
JSON 表示形式
以下 JSON 表示形式显示资源类型。
{
"@odata.type": "#microsoft.graph.accessPackageAssignmentRequest",
"completedDateTime": "String (timestamp)",
"createdDateTime": "String (timestamp)",
"id": "String (identifier)",
"requestType": "String",
"justification": "String",
"parameters": {"@odata.type": "microsoft.graph.accessPackageAssignmentRequestParameters"},
"schedule": {
"@odata.type": "microsoft.graph.entitlementManagementSchedule"
},
"state": "String",
"status": "String",
"answers": [
{
"@odata.type": "microsoft.graph.accessPackageAnswerString"
}
]
}