expirationPattern 资源类型

命名空间：microsoft.graph

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

在 PIM 中，使用此资源定义 unifiedRoleAssignmentScheduleRequest 或 unifiedRoleEligibilityScheduleRequest 对象何时过期。 允许用于此对象的设置取决于 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	请求者的所需过期模式类型。 可能的值包括 notSpecified、noExpiration、afterDateTime、afterDuration。

expirationPatternType 值

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

关系

无。

JSON 表示形式

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

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