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?)

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

  • はい(Yes)
  • いいえ
ドロップダウン 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

テキスト