expirationPattern-Ressourcentyp

Namespace: microsoft.graph

In Microsoft Entra Berechtigungsverwaltung wird eine Zugriffspaketzuweisungsanforderung von einem Benutzer erstellt, der eine Zugriffspaketzuweisung abrufen möchte. Diese Anforderung kann einen Zeitplan für den Zeitpunkt enthalten, an dem der Benutzer eine Zuweisung erhalten möchte. Eine Zugriffspaketzuweisung, die sich aus einer solchen Anforderung ergibt, verfügt ebenfalls über einen Zeitplan. Das Ablauffeld eines entitlementManagementSchedule-Objekts gibt an, wann die Zugriffspaketzuweisung ablaufen soll.

Verwenden Sie diese Ressource in PIM, um zu definieren, wann ein unifiedRoleAssignmentScheduleRequest - oder unifiedRoleEligibilityScheduleRequest-Objekt abläuft. Die für dieses Objekt zulässigen Einstellungen hängen von den Einstellungen für die Microsoft Entra Rolle ab. Wenn beispielsweise die Einstellungen der Microsoft Entra Rolle angeben, dass dauerhafte berechtigte Zuweisungen nicht zulässig sind, gibt die Angabe noExpiration für die type-Eigenschaft einen Fehler zurück.

Eigenschaften

Eigenschaft	Typ	Beschreibung
Dauer	Dauer	Die gewünschte Dauer des Zugriffs des Anforderers im ISO 8601-Format für die Dauer. Pt3H bezieht sich beispielsweise auf drei Stunden. Wenn in einer Anforderung angegeben, sollte endDateTime nicht vorhanden sein, und die type-Eigenschaft sollte auf afterDurationfestgelegt werden.
endDateTime	DateTimeOffset	Der Zeitstempel der Datums- und Uhrzeitinformationen im ISO 8601-Format und ist immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
type	expirationPatternType	Der gewünschte Ablaufmustertyp des Anforderers. Mögliche Werte sind: notSpecified, noExpiration, afterDateTime, afterDuration.

expirationPatternType-Werte

Member	Beschreibung
notSpecified	Es wurde kein Ablaufplan angegeben.
noExpiration	Der Anforderer wollte nicht, dass der Zugriff abläuft.
afterDateTime	Der Zugriff läuft nach einem angegebenen Datum und einer angegebenen Uhrzeit ab.
afterDuration	Der Zugriff läuft nach einer angegebenen Dauer relativ zum gewährten Zugriff ab. Erforderlich, wenn die duration-Eigenschaft angegeben wird.

Beziehungen

Keine.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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