UIP またはカレンダー

uip or calendars は、スケジュールされた実行を スキップするためにタイムトリガーで参照する、除外された日付 (「非稼働日」とも呼ばれる) のテナント範囲のリストであるカレンダーを管理します。各カレンダーには、名前、タイムゾーン、および除外日のリストがあります。

概要

uip or calendars <verb> [options]

動詞

動詞	目的
list	テナント内の予定表のリストを取得します。
get	除外日を含むキーで 1 つの予定表を取得します。
create	任意のタイムゾーンでカレンダーを作成します。
update	キーで予定表の名前を変更するか、予定表のタイムゾーンを変更します。
delete	キーで予定表を削除します。

すべての動詞は 、グローバル オプション (--output、 --output-filter、 --log-level、 --log-file) に従います。終了コードは 標準コントラクトに従います。

UIP またはカレンダーのリスト

テナント内のすべての予定表のリストを取得します。集計フィールド (id、 name、 timeZoneId、 excludedDates、 key) を返します。calendars get は 1 つのカレンダーに使用します。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
-t	--tenant	name	セッションの既定値	テナントを上書きします。
-l	--limit	Number	50	ページ サイズ
—	--offset	Number	0	カウントをスキップします。

例

uip or calendars list
uip or calendars list --limit 100
uip or calendars list --output-filter 'Data[].{k:key, n:name}'

データシェイプ(--output json)

{
  "Code": "CalendarList",
  "Data": [
    {
      "name": "US Holidays",
      "timeZoneId": "America/New_York",
      "excludedDates": ["2025-07-04", "2025-12-25"],
      "key": "a1b2c3d4-0000-0000-0000-000000000001",
      "id": 1001
    }
  ]
}

uip または予定表が取得

GUID キーで予定表を取得します。除外日を含む詳細を返します。

引数

名前	Required	目的
<calendar-key>	○	カレンダー キー (GUID)[ calendars list] で検索します。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
-t	--tenant	name	セッションの既定値	テナントを上書きします。

例

uip or calendars get a1b2c3d4-0000-0000-0000-000000000001
uip or calendars get a1b2c3d4-0000-0000-0000-000000000001 \
    --output-filter 'Data.excludedDates'

データシェイプ(--output json)

{
  "Code": "CalendarGet",
  "Data": {
    "name": "US Holidays",
    "timeZoneId": "America/New_York",
    "excludedDates": ["2025-07-04", "2025-12-25"],
    "key": "a1b2c3d4-0000-0000-0000-000000000001",
    "id": 1001
  }
}

uip または calendars create

新しいカレンダーを作成します。カレンダーはテナントスコープです。--time-zone省略すると、タイムゾーンは既定で UTC に設定されます。

引数

名前	Required	目的
<name>	○	カレンダー名。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
-t	--tenant	name	セッションの既定値	テナントを上書きします。
—	--time-zone	tz ID	UTC	カレンダーのタイムゾーン ( Europe/Bucharestなど)。

例

uip or calendars create "EU Holidays" --time-zone "Europe/Bucharest"
uip or calendars create "US Holidays"

データシェイプ(--output json)

{
  "Code": "CalendarCreated",
  "Data": {
    "name": "EU Holidays",
    "timeZoneId": "Europe/Bucharest",
    "excludedDates": [],
    "key": "a1b2c3d4-0000-0000-0000-000000000010",
    "id": 1010
  }
}

注:

この動詞は、空の excludedDates リストを持つカレンダーレコードを作成します。除外日の入力は CLI では公開されません。Orchestrator の UI または API を直接使用してください。

UIP またはカレンダーの更新

GUID キーで予定表を更新します。指定したフィールドのみが変更されます。残りは保存されています。

引数

名前	Required	目的
<calendar-key>	○	カレンダー キー (GUID)

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
-t	--tenant	name	セッションの既定値	テナントを上書きします。
—	--name	text	変更なし	新しい名前。
—	--time-zone	tz ID	変更なし	新しいタイムゾーン。

例

uip or calendars update a1b2c3d4-0000-0000-0000-000000000010 \
    --name "EU Public Holidays"

uip or calendars update a1b2c3d4-0000-0000-0000-000000000010 \
    --time-zone "Europe/Berlin"

データシェイプ(--output json)

{
  "Code": "CalendarUpdated",
  "Data": {
    "name": "EU Public Holidays",
    "timeZoneId": "Europe/Bucharest",
    "excludedDates": [],
    "key": "a1b2c3d4-0000-0000-0000-000000000010",
    "id": 1010
  }
}

UIP またはカレンダーの削除

GUID キーで予定表を削除します。

引数

名前	Required	目的
<calendar-key>	○	カレンダー キー (GUID)

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
-t	--tenant	name	セッションの既定値	テナントを上書きします。

例

uip or calendars delete a1b2c3d4-0000-0000-0000-000000000010

データシェイプ(--output json)

{
  "Code": "CalendarDeleted",
  "Data": {
    "Key": "a1b2c3d4-0000-0000-0000-000000000010",
    "Name": "EU Public Holidays",
    "Status": "Deleted successfully"
  }
}

関連コマンド

• uip or settings — settings timezones --time-zone有効なタイムゾーン ID をリストします。

参照

• グローバルオプション — --output、 --output-filter、 --log-level、 --log-file。
• 終了コード — 標準の終了コード限月。