スケジュールローテーションの作成

Opsgenieで特定のスケジュールローテーションを作成します。

オプション

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

スケジュール識別子（Schedule Identifier）

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

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

時間制限の追加？（Add Time Restrictions?）

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

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

入力

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

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

ローテーション（Rotation）

時間制限（Time Restrictions）

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

時間制限の追加？（Add Time Restrictions?） オプションでTime Onlyが選択された場合、次のオプションが使用可能です。時間は切り捨てられ、分は最も近い00/30に丸められます。

  • startHour：0～23
  • startMinute：00または30
  • endHour：0～23
  • endMinute：00または30

例： 

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

時間制限の追加？（Add Time Restrictions?） オプションでDay and Timeが選択された場合、次のオプションが使用可能です。曜日と時刻の両方のオプションが必要です。

  • 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
	}
]
 オブジェクト 正

スケジュールID（Schedule ID）

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

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

 テキスト 正

スケジュール名（Schedule Name）

スケジュールの名前。

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

 テキスト 正

名前（Name）

新規スケジュールローテーションの名前。

 テキスト FALSE

入社年月日（Start Date）

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

 日時 正

終了日（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）

 ドロップダウン 正

長さ（Length）

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

 数値 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

出力

フィールド 定義 タイプ

ステータスコード（Status Code）

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

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

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

 数値

結果（Result）

API呼び出しの結果。

例：Deleted。

 テキスト

ローテーションID（Rotation ID）

新規スケジュールローテーションの名前。

 テキスト

名前（Name）

新規スケジュールローテーションの名前。

 テキスト

関連項目

Opsgenieコネクター

Okta Workflowsの要素について

Opsgenie APIの概要