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"
}