recurrencePattern リソースの種類

名前空間: microsoft.graph

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

シナリオに応じて、定期的なイベントの 6 通りの繰り返しパターンのいずれかを指定できます。 パターンの種類ごとに、次のイベント発生までの期間を指定します。 イベントに対して指定した期間内に発生する定期的なイベントは、必ずこのパターンに従って発生します。 定期的なイベントは常に、recurrencePattern (イベントを繰り返す頻度)、および recurrenceRange (イベントを繰り返す期間) によって定義されます。

type プロパティを使用して recurrencePattern のさまざまな種類からパターンを指定し、interval プロパティを使用してイベント発生までの期間を指定します。type によって、その期間は数日、数週間、数か月、数年になる可能性があります。 種類ごとに必要なプロパティについては、次の表の説明を参照してください。

注 定期的なパターンに必要なプロパティのみを含めます。 含めたプロパティにサポートされている値がない場合、エラーになる可能性があります。

プロパティ

プロパティ	型	説明
dayOfMonth	Int32	イベントが発生する月の日付。 type が、absoluteMonthly または absoluteYearly の場合、必要です。
daysOfWeek	dayOfWeek コレクション	イベントが発生する曜日のコレクションです。 使用可能な値: sunday、monday、tuesday、wednesday、thursday、friday、saturday。 type が relativeMonthly または relativeYearly であり、daysOfWeek で 1 日以上を指定する場合、パターンを満たす最初の日にイベントが発生します。 type が weekly、relativeMonthly、relativeYearly の場合、必要です。
firstDayOfWeek	dayOfWeek	週の最初の曜日を指定します。 使用可能な値: sunday、monday、tuesday、wednesday、thursday、friday、saturday。 既定値は sunday です。 type が weekly の場合、必要です。
index	weekIndex	daysOfWeek で指定された日数のインスタンスを指定します。イベントが発生し、月の最初のインスタンスからカウントされます。 使用可能な値: first、second、third、fourth、last。 既定値は first です。 オプションです。type が relativeMonthly か relativeYearly の場合、使用します。
interval	Int32	次のイベント発生までの単位数。type によって、単位は、日、週、月、年などになります。 必須。
month	Int32	イベントが発生する月。 これは、1 から 12 までの数字です。
type	recurrencePatternType	定期的なパターンの種類は、daily、weekly、absoluteMonthly、relativeMonthly、absoluteYearly、relativeYearly です。 必須です。 詳細については、「 type プロパティの値」を参照してください。

重要

アクセス レビューでは、 dayOfMonth、 interval、および type (weekly, absoluteMonthly) プロパティのみがサポートされています。

type プロパティの値

type プロパティの値	説明	例	必須のプロパティ
daily	interval で指定された、次のイベント発生までの日数に基づいて、イベントが繰り返されます。	イベントを 3 日ごとに繰り返します。	type、interval
weekly	次の一連のイベント発生までの週数に基づいて、同じ曜日 (複数の曜日も可) にイベントが繰り返されます。	イベントを隔週の月曜日と火曜日に繰り返します。	type、interval、daysOfWeek、firstDayOfWeek メモ： アクセス レビューでは、 interval プロパティと type プロパティのみがサポートされます。
absoluteMonthly	次のイベント発生までの月数に基づいて、該当月の指定日 (例: 15 日) にイベントが繰り返されます。	四半期 (3 か月ごと) の 15 日にイベントを繰り返します。	type、interval、dayOfMonth メモ： アクセス レビューでは、 interval、 dayOfMonth、および type プロパティのみがサポートされます。
relativeMonthly	次のイベント発生までの月数に基づいて、該当月の同じ相対位置にある指定した曜日 (複数の曜日も可) にイベントが繰り返されます。	3 か月ごとに、第 2 木曜日または金曜日にイベントを繰り返します。	type、interval、daysOfWeek
absoluteYearly	次のイベント発生までの年数に基づいて、指定した日付にイベントが繰り返されます。	3 年ごとに、3 月 15 日にイベントを繰り返します。	type、interval、dayOfMonth、month
relativeYearly	次のイベント発生までの年数に基づいて、該当年の特定の月の同じ相対位置にある指定した曜日 (複数の曜日も可) にイベントが繰り返されます。	3 年ごとに、11 月の第 2 木曜日または金曜日にイベントを繰り返します。	type、interval、daysOfWeek、month

JSON 表記

リソースの JSON 表記を次に示します。

{
  "dayOfMonth": 1024,
  "daysOfWeek": ["String"],
  "firstDayOfWeek": "String",
  "index": "String",
  "interval": 1024,
  "month": 1024,
  "type": "String"
}