Freigeben über


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, für welche Instanz der zulässigen Tage, die in daysOfWeek angegeben sind, das Ereignis auftritt, das von der ersten Instanz 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

Anmerkung: 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

Anmerkung: 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

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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