requestSchedule resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

In Microsoft Entra entitlement management, an access package assignment request is created by a user who wants to obtain an access package assignment. This request can include a schedule for when the user would like to have an assignment. An access package assignment that results from such a request also has a schedule.

In PIM for Microsoft Entra roles and PIM for Groups, use this resource to define the schedule for when the principal will have an eligible or active role assignment.

Properties

Property	Type	Description
startDateTime	DateTimeOffset	The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. In PIM, when the eligible or active assignment becomes active.
expiration	expirationPattern	In entitlement management, when the access should expire.
recurrence	patternedRecurrence	For recurring access, or eligible or active assignment. This property is currently unsupported in both PIM and entitlement management.

JSON representation

The following is a JSON representation of the resource.

{
  "@odata.type": "#microsoft.graph.requestSchedule",
  "startDateTime": "String (timestamp)",
  "expiration": {
    "@odata.type": "microsoft.graph.expirationPattern"
  },
  "recurrence": {
    "@odata.type": "microsoft.graph.patternedRecurrence"
  }
}