Create Schedule Rotation（スケジュールローテーションの作成）

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

注

このカードのOpsgenie接続を作成するために使用されるAPIキーがチーム固有でないことを確認します。そうでない場合、このカードの［Team ID（チームID）］または［Team Name（チーム名）］フィールドのすべての値はチーム固有のAPIキーで指定されるチームをオーバーライドしません。Opsgenie APIキー管理ページでAPIキーを作成・管理することをお勧めします。

オプション

フィールド 定義 タイプ 必須
Schedule Identifier（スケジュール識別子） チームのスケジュール識別子のタイプ。以下のいずれかのオプションを選択します。
  • Schedule ID（スケジュール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
    }
]

オブジェクト

正
Schedule ID（スケジュールID） スケジュールの一意のID。

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

テキスト

TRUE
Schedule Name（スケジュール名） スケジュールの名前。

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

テキスト

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

テキスト

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

日時

TRUE
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（毎週）

ドロップダウン

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

数値

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

ユーザーとチームの場合、オプションで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"
    }
]
 オブジェクトの配列

誤

出力

フィールド 定義 タイプ
Status Code（ステータスコード）

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

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

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

数値
Result（結果） API呼び出しの結果。

たとえば、［削除済み］など。

テキスト
Rotation ID（ローテーションID） 新規スケジュールローテーションの名前。

テキスト
Name（名前） 新規スケジュールローテーションの名前。

テキスト

関連項目

Opsgenieコネクター

Workflows要素

Opsgenie APIの概要