expirationPattern リソースの種類

名前空間: microsoft.graph

Microsoft Entra エンタイトルメント管理では、アクセス パッケージの割り当てを取得するユーザーがアクセス パッケージの割り当て要求を作成します。 この要求には、ユーザーが割り当てを行うタイミングのスケジュールを含めることができます。 このような要求に起因するアクセス パッケージの割り当てにもスケジュールがあります。 entitlementManagementSchedule の有効期限フィールドは、アクセス パッケージの割り当ての有効期限を示します。

PIM では、このリソースを使用して、 unifiedRoleAssignmentScheduleRequest または unifiedRoleEligibilityScheduleRequest オブジェクトの有効期限を定義します。 このオブジェクトに対して許可される設定は、 Microsoft Entra ロールの設定によって異なります。 たとえば、Microsoft Entra ロールの設定で永続的な適格な割り当てが許可されていないことが指定されている場合、type プロパティにnoExpirationを指定するとエラーが返されます。

プロパティ

プロパティ	型	説明
duration	期間	要求者の必要なアクセス期間は、ISO 8601 形式で表示されます。 たとえば、PT3H は 3 時間を指します。 要求で指定した場合、 endDateTime は存在せず、 type プロパティを afterDuration に設定する必要があります。
endDateTime	DateTimeOffset	ISO 8601 形式を使用した日時情報のタイムスタンプ。常に UTC 時刻です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
type	expirationPatternType	要求者の目的の有効期限パターンの種類。 使用可能な値: notSpecified、noExpiration、afterDateTime、afterDuration。

expirationPatternType 値

メンバー	説明
notSpecified	有効期限スケジュールが指定されませんでした。
noExpiration	要求者は、アクセスの有効期限を切れたくありませんでした。
afterDateTime	アクセスは、指定した日付と時刻の後に期限切れになります。
afterDuration	アクセスは、アクセスが許可された期間に対して指定された期間が経過すると期限切れになります。 duration プロパティが指定されている場合は必須です。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

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