expirationPattern 资源类型

命名空间:microsoft.graph

Microsoft Entra 权利管理中,访问包分配请求由想要获取访问包分配的用户创建。 此请求可以包含用户希望何时进行分配的计划。 此类请求产生的访问包分配也有一个计划。 entitlementManagementSchedule 的过期字段指示访问包分配应何时过期。

在 PIM 中,使用此资源定义 unifiedRoleAssignmentScheduleRequestunifiedRoleEligibilityScheduleRequest 对象何时过期。 允许用于此对象的设置取决于 Microsoft Entra 角色的设置。 例如,如果 Microsoft Entra 角色的设置指定不允许永久的合格分配,则 noExpiration类型 属性指定将返回错误。

属性

属性 类型 说明
duration 持续时间 请求者所需的访问持续时间以 ISO 8601 格式表示的持续时间。 例如,PT3H 是指 3 小时。 如果在请求中指定, 则 endDateTime 不应存在,并且 type 属性应设置为 afterDuration
endDateTime DateTimeOffset 使用 ISO 8601 格式的日期和时间信息的时间戳,始终采用 UTC 时间。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
type expirationPatternType 请求者的所需过期模式类型。 可能的值包括 notSpecifiednoExpirationafterDateTimeafterDuration

expirationPatternType 值

成员 说明
notSpecified 未指定过期计划。
noExpiration 请求者不希望访问权限过期。
afterDateTime 访问将在指定的日期和时间后过期。
afterDuration 访问权限将在相对于授予访问权限的指定持续时间后过期。 指定 持续时间 属性时是必需的。

关系

无。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "@odata.type": "#microsoft.graph.expirationPattern",
  "duration": "String (duration)",
  "endDateTime": "String (timestamp)",
  "type": "String"
}