Update Schedule Rotation(スケジュールローテーションの更新)

特定のスケジュールローテーションの参加者および時間制限を更新します。

オプション

フィールド 定義 タイプ 必須

スケジュール識別子(Schedule Identifier)

チームのスケジュール識別子のタイプ。次のいずれかのオプションを選択します。

  • Schedule ID:スケジュールの一意のID。
  • Schedule Name:スケジュールの名前。
ドロップダウン 正

時間制限の更新?(Update Time Restriction?)

時間制限が更新されるかどうかを指定します。次のいずれかのオプションを選択します。

  • No:時間制限は追加されません。
  • Time Only:スケジュールローテーションを週の一定の時刻に限定します。
  • Day and Time:スケジュールローテーションを週の特定の曜日と時刻に基づいて限定します。
ドロップダウン 正

入力

これらのフィールドは、オプションで選択されたフィールドに基づいて動的に生成されます。

フィールド 定義 タイプ 必須

ローテーション(Rotation)

スケジュールID(Schedule ID)

スケジュールの一意のID。

このフィールドは、スケジュール識別子(Schedule Identifier)オプションからSchedule IDが選択された場合に表示されます。

テキスト 正

スケジュール名(Schedule Name)

スケジュールの名前。

このフィールドは、スケジュール識別子(Schedule Identifier)オプションからSchedule Nameが選択された場合に表示されます。

テキスト 正

ローテーションID(Rotation ID)

スケジュールローテーションの一意のID。

テキスト 正

名前(Name)

ローテーションの名前。

テキスト FALSE

入社年月日(Start Date)

ローテーションの開始日。日付形式はyyyy-MM-dd'T'HH:mm:ssZ(例:2017-01-15T08:00:00+02:00)。分は値として0または30を取ることができます。それ以外の場合、最も近い0または30に自動的に変換されます。

日時 FALSE

終了日(End Date)

ローテーションの終了日。日付形式はyyyy-MM-dd'T'HH:mm:ssZ(例:2017-01-15T08:00:00+02:00)。分は値として0または30を取ることができます。それ以外の場合、最も近い0または30に自動的に変換されます。

日時 FALSE

タイプ(Type)

ローテーションの期間。次のいずれかのオプションを選択します。

  • 毎時(Hourly)
  • 毎日(Daily)
  • 週給(Weekly)
ドロップダウン FALSE

長さ(Length)

ローテーションの長さ。デフォルト値は1です。

数値 FALSE

参加者のマージ?(Merge Participants?)

既存の参加者リストと入力リストをマージするかどうかを示します。次のいずれかのオプションを選択します。

  • あり
  • いいえ
ドロップダウン FALSE

参加者(Participants)

スケジュールで使用されるエスカレーション、チーム、ユーザーのリスト、またはなし。各参加者は複数回使用することが可能で、指定された順序でローテーションされます。

ユーザーとチームの場合、オプションでIDまたはユーザー名のプロパティーを定義します。

例:

[
	{
		"type":"escalation",
		"id":"3f145401-e6f3-428f-9f3c-41b0e1d172d5",
		"name":"Team 2_escalation"
	},
	{
		"type":"user",
		"id":"d92b2aa1-4bc8-481b-a30e-4f19e5a27f83",
		"username":"johnathan.doe@okta.com"
	},
	{
		"type":"team",
		"id":"d00f95c1-2cce-4110-adbc-2ceca786c305",
		"username":"lily.doe@okta.com"
	},
	{
	"type":"none"
	}
]

オブジェクトの配列

FALSE

時間制限(Time Restrictions)

週の各曜日に対する複数の開始および終了時刻を使用し、スケジュールローテーションを週の特定の曜日と時刻に限定するために使用されます。これにより、さまざまな時間にさまざまなスケジュールローテーションを適用できます。

このフィールドは、オプションの時間制限を更新しますか?(Update Time Restriction?)からTime OnlyまたはDay and Timeが選択された場合に表示されます。

オブジェクト 正

オプションの時間制限を更新しますか?(Update Time Restrictions?)フィールドでTime Onlyが選択された場合、次のオプションが使用可能です。

注(Note):時間は切り捨てられ、分は最も近い00/30に丸められます。

数値 正

startHour - 0~23

数値 正

startMinute - 00または30

数値 正

endHour - 0~23

数値 正

endMinute - 00または30

数値 正

例:

{
	"startHour": 5
	"startMin": 30
	"endHour": 16
	"endMin": 0
}

オプションの時間制限を更新しますか?(Update Time Restrictions?)フィールドで>Day and Timeが選択された場合、次のオプションが使用可能です。

注(Note):曜日と時刻の両方のオプションが必要です。

オブジェクトの配列

正

月曜日~日曜日(startDay:monday~sunday)

テキスト 正

startHour:0~23

数値 正

startMinute:00または30

数値 正

endDay:monday~sunday (月曜日~日曜日)

テキスト 正

endHour:0~23

数値 正

endMinute:00または30

数値 正

例:

[
	{
		"startDay":"monday",
		"endDay":"tuesday",
		"startHour":8,
		"endHour":18,
		"startMin":0,
		"endMin":30
	},
	{
		"startDay":"thursday",
		"endDay":"sunday",
		"startHour":6,
		"endHour":8,
		"startMin":0,
		"endMin":30
	}
]

出力

フィールド 定義 タイプ

ステータスコード(Status Code)

操作の結果。コネクターは、カードによって実行されたアクションの成否を示すHTTPステータスコードを返します。例:

  • 201 Createdステータスコードは、アクションが成功し、新しいリソースが作成されたことを示します。
  • 403 Forbiddenエラーは、必要な権限が不足していたためにHTTPリクエストが処理されなかったことを示します。

発生する可能性があるステータスコードの完全なリストについては、HTTPステータスコードを参照してください。

数値

結果(Result)

API呼び出しの結果。

例:Deleted。

テキスト