unifiedRoleEligibilityScheduleRequest 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示通过 PIM 请求主体的角色资格。 角色资格可以永久符合条件，没有到期日期，也可以暂时有资格使用到期日期。 继承自 请求。
有关可以通过 unifiedRoleEligibilityScheduleRequest 资源类型定义的 PIM 方案的详细信息，请参阅 通过特权标识管理 (PIM) API 的角色管理概述。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | unifiedRoleEligibilityScheduleRequest 集合 | 检索通过 unifiedRoleEligibilityScheduleRequest 对象对主体的角色资格请求。 |
| 创建 | unifiedRoleEligibilityScheduleRequest | 通过 unifiedRoleEligibilityScheduleRequest 对象请求主体的角色资格。 |
| Get | unifiedRoleEligibilityScheduleRequest | 阅读通过 unifiedRoleEligibilityScheduleRequest 对象发出的角色资格请求请求的详细信息。 |
| 按当前用户筛选 | unifiedRoleEligibilityScheduleRequest 集合 | 在 PIM 中，检索特定主体的角色资格请求。 主体可以是 unifiedRoleEligibilityScheduleRequest 对象的创建者或审批者，也可以是角色资格的目标。 |
| Cancel | None | 立即取消状态为 Granted 的 unifiedRoleEligibilityScheduleRequest 对象，并让系统在 30 天后自动删除已取消的请求。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| action | String | 表示对角色资格请求的操作类型。 可能的值有：
|
| approvalId | String | 请求审批的标识符。 继承自 请求。 |
| appScopeId | String | 当角色资格限定为应用时，特定于应用的范围的标识符。 角色资格的范围决定了主体有权访问的资源集。 应用范围是仅此应用程序定义和理解的范围。 用于 / 租户范围的应用范围。 使用 directoryScopeId 将范围限制为特定的目录对象，例如管理单元。 支持$filter对值) eq (null 、 ne和 。 |
| completedDateTime | DateTimeOffset | 请求完成日期时间。 继承自 请求。 |
| createdBy | identitySet | 创建此请求的主体。 继承自 请求。 |
| createdDateTime | DateTimeOffset | 请求创建日期时间。 继承自 请求。 |
| customData | String | 用于定义请求的任何自定义数据的自由文本字段。 未使用。 继承自 请求。 |
| directoryScopeId | String | 表示角色资格范围的目录对象的标识符。 角色资格的范围决定了已向其授予主体访问权限的资源集。 目录范围是存储在目录中的共享范围，可由多个应用程序理解。 用于 / 租户范围。 使用 appScopeId 将范围限制为仅应用程序。 支持$filter对值) eq (null 、 ne和 。 |
| id | String | unifiedRoleEligibilityScheduleRequest 对象的唯一标识符。 键，不可为 null，只读。 继承自 entity。 |
| isValidationOnly | 布尔值 | 确定调用是验证还是实际调用。 仅当想要在实际提交请求之前检查激活是否受其他规则（如 MFA）的约束时，才设置此属性。 |
| 理由 | String | 用户和管理员在创建 unifiedRoleEligibilityScheduleRequest 对象时提供的消息。 |
| principalId | String | 已被授予角色资格的主体的标识符。 可以是用户或可分配角色的组。 只能授予 活动分配 服务主体。 支持 $filter（eq、ne）。 |
| roleDefinitionId | String | 要分配给主体的 unifiedRoleDefinition 对象的标识符。 支持 $filter（eq、ne）。 |
| scheduleInfo | requestSchedule | 角色资格的期限。 目前不支持定期计划。 |
| status | String | 角色资格请求的状态。 继承自 请求。 此为只读属性。 支持 $filter（eq、ne）。 |
| targetScheduleId | String | 链接到资格请求的计划对象的标识符。 支持 $filter（eq、ne）。 |
| ticketInfo | ticketInfo | 链接到角色资格请求的票证详细信息，包括票证编号和票证系统的详细信息。 可选。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| appScope | appScope | 当角色资格限定为应用时，具有特定于应用范围的详细信息的只读属性。 可为 NULL。 支持 $expand。 |
| directoryScope | directoryObject | 作为角色资格范围的目录对象。 只读。 支持 $expand。 |
| 主要 | directoryObject | 通过请求获取角色资格的主体。 支持 $expand。 |
| roleDefinition | unifiedRoleDefinition | 通过 roleDefinitionId 属性引用的 unifiedRoleDefinition 对象的详细信息。 支持 $expand。 |
| targetSchedule | unifiedRoleEligibilitySchedule | 通过 targetScheduleId 属性引用的角色资格计划。 支持 $expand。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"id": "String (identifier)",
"action": "String",
"principalId": "String",
"roleDefinitionId": "String",
"directoryScopeId": "String",
"appScopeId": "String",
"isValidationOnly": "Boolean",
"targetScheduleId": "String",
"justification": "String",
"scheduleInfo": {
"@odata.type": "microsoft.graph.requestSchedule"
},
"ticketInfo": {
"@odata.type": "microsoft.graph.ticketInfo"
}
}