recurrenceRange リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

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

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

プロパティ

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