recurrenceRange-Ressourcentyp
Namespace: microsoft.graph
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 | recurrenceRangeType | Der Serienbereich. Die möglichen Werte sind: 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 |
Beziehungen
Keine.
JSON-Darstellung
Die folgende JSON-Darstellung zeigt den Ressourcentyp.
{
"endDate": "String (timestamp)",
"numberOfOccurrences": 1024,
"recurrenceTimeZone": "string",
"startDate": "String (timestamp)",
"type": "String"
}