カレンダーにイベントを追加（Add events to calendar）

カレンダーAPIにイベントを追加

カレンダーに予定されたイベントを投稿します。

リクエスト

POST _ml/calendars/<calendar_id>/events

前提条件

manage_ml クラスター権限が必要です。この権限は machine_learning_admin ビルトインロールに含まれています。

説明

このAPIは、各イベントに開始時刻、終了時刻、および説明が必要な 予定されたイベント のリストを受け入れます。

パスパラメータ

• <calendar_id>
• （必須、文字列）カレンダーを一意に識別する文字列。

リクエストボディ

• events
• （必須、配列）1つ以上の予定されたイベントのリスト。イベントの開始時刻と終了時刻は、エポックからのミリ秒の整数またはISO 8601形式の文字列として指定できます。
  イベントのプロパティ
  • description
  • （オプション、文字列）予定されたイベントの説明。
  • end_time
  • （必須、日付）予定されたイベントの終了時刻のタイムスタンプ（エポックからのミリ秒またはISO 8601形式）。
  • start_time
  • （必須、日付）予定されたイベントの開始時刻のタイムスタンプ（エポックからのミリ秒またはISO 8601形式）。

例

Python

resp = client.ml.post_calendar_events(
   calendar_id="planned-outages",
   events=[
   {
   "description": "event 1",
   "start_time": 1513641600000,
   "end_time": 1513728000000
   },
   {
   "description": "event 2",
   "start_time": 1513814400000,
   "end_time": 1513900800000
   },
   {
   "description": "event 3",
   "start_time": 1514160000000,
   "end_time": 1514246400000
   }
   ],
)
print(resp)

Ruby

response = client.ml.post_calendar_events(
  calendar_id: 'planned-outages',
  body: {
   events: [
   {
   description: 'event 1',
   start_time: 1_513_641_600_000,
   end_time: 1_513_728_000_000
   },
   {
   description: 'event 2',
   start_time: 1_513_814_400_000,
   end_time: 1_513_900_800_000
   },
   {
   description: 'event 3',
   start_time: 1_514_160_000_000,
   end_time: 1_514_246_400_000
   }
   ]
  }
)
puts response

Js

const response = await client.ml.postCalendarEvents({
  calendar_id: "planned-outages",
  events: [
   {
   description: "event 1",
   start_time: 1513641600000,
   end_time: 1513728000000,
   },
   {
   description: "event 2",
   start_time: 1513814400000,
   end_time: 1513900800000,
   },
   {
   description: "event 3",
   start_time: 1514160000000,
   end_time: 1514246400000,
   },
  ],
});
console.log(response);

コンソール

POST _ml/calendars/planned-outages/events
{
  "events" : [
   {"description": "event 1", "start_time": 1513641600000, "end_time": 1513728000000},
   {"description": "event 2", "start_time": 1513814400000, "end_time": 1513900800000},
   {"description": "event 3", "start_time": 1514160000000, "end_time": 1514246400000}
  ]
}

APIは次の結果を返します:

コンソール-結果

{
  "events": [
   {
   "description": "event 1",
   "start_time": 1513641600000,
   "end_time": 1513728000000,
   "calendar_id": "planned-outages"
   },
   {
   "description": "event 2",
   "start_time": 1513814400000,
   "end_time": 1513900800000,
   "calendar_id": "planned-outages"
   },
   {
   "description": "event 3",
   "start_time": 1514160000000,
   "end_time": 1514246400000,
   "calendar_id": "planned-outages"
   }
  ]
}