recurrenceRange-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 einen Datumsbereich, über den ein wiederkehrendes Ereignis übertragen wird. 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 Sie den Datumsbereich einer Ereignisserie in einer der drei folgenden Arten angeben. Sie müssen zwar immer einen startDate-Wert für den Datumsbereich angeben, Sie können aber auch ein wiederkehrendes Ereignis angeben, das an einen angegebenen Datum endet, das nicht endet oder das nach 5 Vorkommen endet. Beachten Sie, dass die tatsächlichen Vorkommen innerhalb des Datumsbereichs immer dem Serienmuster folgen, das Sie für das wiederkehrende 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.

Eigenschaften

Eigenschaft	Typ	Beschreibung
endDate	Datum	Das Datum zum Beenden des Anwendens des Musters. Je nach dem Serienmuster des Ereignisses ist das letzte Vorkommen der Besprechung möglicherweise nicht an diesem Datum. Erforderlich, wenn typeendDate ist.
numberOfOccurrences	Int32	Die Anzahl von Wiederholungen für das Ereignis. Erforderlich; muss positiv sein, wenn typenumbered ist.
recurrenceTimeZone	String	Zeitzone für die startDate- und endDate-Eigenschaften. Optional. Falls nicht angegeben, wird die Zeitzone des Ereignisses verwendet.
startDate	Datum	Das Datum zum Starten des Anwendens des Musters. Je nach dem Serienmuster des Ereignisses findet das erste Vorkommen der Besprechung möglicherweise an diesem Datum oder später statt. Muss der gleiche Wert wie die start-Eigenschaft des wiederkehrenden Ereignisses sein. Erforderlich.
type	Zeichenfolge	Der Serienbereich. Mögliche Werte: endDate, noEnd, numbered. Erforderlich.

Verwenden Sie die type-Eigenschaft, um die unterschiedlichen Typen von recurrenceRange anzugeben. Beachten Sie die erforderlichen Eigenschaften für jeden Typ, wie in der folgenden Tabelle beschrieben.

Eigenschaft "type"	Typ des Serienbereichs	Beschreibung	Beispiel	Erforderliche Eigenschaften
endDate	Bereich mit Enddatum	Ereignis an allen Tagen wiederholen, die mit dem entsprechenden Serienmuster zwischen dem startDate und dem endDate übereinstimmen.	Ereignis im Datumsbereich zwischen 1. Juni 2017 und 15. Juni 2017 wiederholen.	type, startDate, endDate
noEnd	Bereich ohne Enddatum	Ereignis an allen Tagen wiederholen, die mit dem entsprechenden Serienmuster beginnend am startDate übereinstimmen.	Ereignis im Datumsbereich beginnend am 1. Juni 2017 unbegrenzt wiederholen.	type, startDate
numbered	Bereich mit einer bestimmten Anzahl von Vorkommen	Ereignis für die numberOfOccurrences basierend auf dem Serienmuster beginnend am startDate wiederholen.	Ereignis im Datumsbereich beginnend am 1. Juni 2017 für 10 Vorkommen wiederholen.	type, startDate, numberOfOccurrences

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "endDate": "String (timestamp)",
  "numberOfOccurrences": 1024,
  "recurrenceTimeZone": "string",
  "startDate": "String (timestamp)",
  "type": "String"
}