recurrenceRange リソースの種類

名前空間: microsoft.graph

定期的なイベントの日付範囲について説明します。 この共有オブジェクトは、Microsoft Entra IDでのアクセス レビュー、予定表イベント、およびアクセス パッケージの割り当ての繰り返しを定義するために使用されます。

シナリオに応じて、定期的なイベントの 3 通りの期間のいずれかを指定できます。 期間の startDate 値は必ず指定する必要がありますが、定期的なイベントの終了は、特定の日付までに終了する、終了しない、または特定の回数繰り返した後に終了する、など指定することができます。 イベントに対して指定した期間内の定期的なイベントは、必ずこの定期的なパターンに従って発生します。 定期的なイベントは常に、recurrencePattern (イベントを繰り返す頻度)、および recurrenceRange (イベントを繰り返す期間) によって定義されます。

プロパティ

プロパティ	型	説明
endDate	Date	定期的なパターンの適用を停止する日付。 イベントの定期的なパターンによっては、最後に会議が発生するのは、この日付にならない可能性があります。 type が endDate の場合、必要です。
numberOfOccurrences	Int32	イベントを繰り返す回数を指定します。 必須です。type が numbered の場合、正の値である必要があります。
recurrenceTimeZone	String	startDate プロパティと endDate プロパティのタイム ゾーン。 省略可能。 指定されていない場合は、イベントのタイム ゾーンが使用されます。
startDate	Date	定期的なパターンの適用を開始する日付。 イベントの定期的なパターンによっては、最初に会議が発生するのは、この日付以降になる場合があります。 定期的なイベントの start プロパティと同じ値である必要があります。 必須。
type	recurrenceRangeType	繰り返す期間。 使用可能な値: endDate、noEnd、numbered。 必須です。

type プロパティを使用して、recurrenceRange のさまざまな種類から期間を指定します。 種類ごとに必要なプロパティについては、次の表の説明を参照してください。

type プロパティ	繰り返す期間の種類	説明	例	必須のプロパティ
endDate	終了日が指定された期間	startDate と endDate の範囲内の、対応する定期的なパターンに適合するすべての日に、イベントが繰り返されます。	2017 年 6 月 1 日から 2017 年 6 月 15 日の期間で、イベントを繰り返します。	type、startDate、endDate
noEnd	終了日が指定されていない期間	startDate に始まる、対応する定期的なパターンに適合するすべての日に、イベントが繰り返されます。	2017 年 6 月 1 日に始まる期間に、イベントを無期限に繰り返します。	type、startDate
numbered	発生回数を指定した期間	startDate に始まる定期的なパターンに基づいて、numberOfOccurrences で指定した回数、イベントが繰り返されます。	2017 年 6 月 1 日に始まる期間に、イベントを 10 回繰り返します。	type、startDate、numberOfOccurrences

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

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