recurrencePattern-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Beschreibt die Häufigkeit, mit der sich ein wiederkehrendes Ereignis wiederholt. Dieses freigegebene Objekt wird verwendet, um die Wiederholung von Zugriffsüberprüfungen, Kalenderereignissen und Zugriffspaketzuweisungen in Microsoft Entra ID zu definieren.

Je nach Ihrem Szenario können das Serienmuster einer Ereignisserie auf die sechs folgenden Arten angeben. Geben Sie für jeden Mustertyp die Zeitdauer zwischen Vorkommen an. Die tatsächlichen Vorkommen des wiederkehrenden Ereignisses folgen immer diesem Muster, das in den Datumsbereich fällt, den Sie für das Ereignis angeben. Ein wiederkehrendes Ereignis wird immer durch sein recurrencePattern (wie oft sich das Ereignis wiederholt), und seinen recurrenceRange (über welchen Zeitraum sich das Ereignis wiederholt) definiert.

Verwenden Sie die type-Eigenschaft, um die unterschiedlichen Typen von recurrencePattern anzugeben, und die interval-Eigenschaft, um die Zeit zwischen Vorkommen anzugeben, die je nach type eine Anzahl von Tagen, Wochen, Monaten oder Jahren sein kann. Beachten Sie, welche Eigenschaften für jeden Typ erforderlich sind, wie in der folgenden Tabelle beschrieben.

Hinweis Schließen Sie nur die Eigenschaften ein, die Sie für ein Serienmuster benötigen. Jede Eigenschaft, die Sie einschließen, die keinen unterstützten Typ aufweist, würde einen Fehler zurückgeben.

Eigenschaften

Eigenschaft	Typ	Beschreibung
dayOfMonth	Int32	Der Tag des Monats, an dem das Ereignis stattfindet. Erforderlich, wenn typeabsoluteMonthly oder absoluteYearly ist.
daysOfWeek	dayOfWeek-Sammlung	Eine Auflistung der Tage der Woche, an denen das Ereignis stattfindet. Mögliche Werte sind: sunday, monday, tuesday, wednesday, thursday, friday, saturday. Wenn typerelativeMonthly oder relativeYearly ist und daysOfWeek mehr als einen Tag angibt, fällt das Ereignis auf den ersten Tag, der dem Muster entspricht. Erforderlich, wenn typeweekly, relativeMonthly oder relativeYearly ist.
firstDayOfWeek	dayOfWeek	Der erste Tag der Woche. Mögliche Werte sind: sunday, monday, tuesday, wednesday, thursday, friday, saturday. Der Standardwert ist sunday. Erforderlich, wenn typeweekly ist.
Index	weekIndex	Gibt an, an welchem instance der zulässigen Tage, die in daysOfWeek angegeben sind, das Ereignis auftritt, das ab der ersten instance im Monat gezählt wird. Mögliche Werte sind: first, second, third, fourth, last. Der Standardwert ist first. Optional; wird verwendet, wenn typerelativeMonthly oder relativeYearly ist.
Intervall	Int32	Die Anzahl von Einheiten zwischen den Vorkommen, wobei Einheiten je nach type in Tagen, Wochen, Monaten oder Jahren angegeben werden können. Erforderlich.
Monat	Int32	Der Monat, in dem das Ereignis stattfindet. Dies ist eine Zahl zwischen 1 und 12.
type	recurrencePatternType	Typ des Serienmusters: daily, weekly, absoluteMonthly, relativeMonthly, absoluteYearly, relativeYearly. Erforderlich. Weitere Informationen finden Sie unter Werte der Typeigenschaft.

Wichtig

Für Zugriffsüberprüfungen werden nur die Eigenschaften dayOfMonth, interval und type (weekly, absoluteMonthly) unterstützt.

Werte der Typeigenschaft

Wert der type-Eigenschaft	Beschreibung	Beispiel	Erforderliche Eigenschaften
daily	Das Ereignis wiederholt sich basierend auf der Anzahl von Tagen, die von interval zwischen den einzelnen Vorkommen angegeben werden.	Ereignis alle 3 Tage wiederholen	type, interval
weekly	Das Ereignis wird am gleichen Tag oder an den gleichen Tagen einer Woche basierend auf der Anzahl von Wochen zwischen zwei Vorkommen wiederholt.	Ereignis jeden Montag und Dienstag wiederholen	type, interval, daysOfWeek, firstDayOfWeek Hinweis: Für Zugriffsüberprüfungen werden nur Intervall- und Typeigenschaften unterstützt.
absoluteMonthly	Das Ereignis wird an dem angegebenen Tag des Monats (z. B. am 15.) basierend auf der Anzahl von Monaten zwischen den Vorkommen wiederholt.	Ereignis vierteljährlich (alle 3 Monate) am 15. wiederholen	type, interval, dayOfMonth Hinweis: Für Zugriffsüberprüfungen werden nur die Eigenschaften interval, dayOfMonth und type unterstützt.
relativeMonthly	Das Ereignis wird an dem angegebenen Tag oder an den angegebenen Tagen der Woche in derselben relativen Position im Monat basierend auf der Anzahl von Monaten zwischen den Vorkommen wiederholt.	Ereignis am zweiten Donnerstag oder Freitag alle drei Monate wiederholen	type, interval, daysOfWeek
absoluteYearly	Das Ereignis wird an dem angegebenen Tag und Monat basierend auf der Anzahl von Jahren zwischen den Vorkommen wiederholt.	Ereignis am 15. März alle 3 Jahre wiederholen	type, interval, dayOfMonth, month
relativeYearly	Das Ereignis wird an dem angegebenen Tag oder an den angegebenen Tagen der Woche in derselben relativen Position in einem bestimmten Monat des Jahres basierend auf der Anzahl von Jahren zwischen den Vorkommen wiederholt.	Ereignis am zweiten Donnerstag oder Freitag jeden November alle 3 Jahre wiederholen	type, interval, daysOfWeek, month

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "dayOfMonth": 1024,
  "daysOfWeek": ["String"],
  "firstDayOfWeek": "String",
  "index": "String",
  "interval": 1024,
  "month": 1024,
  "type": "String"
}