将事件添加到日历 API编辑

在日历中发布计划的事件。

请求编辑

POST _ml/calendars/<calendar_id>/events

先决条件编辑

需要 manage_ml 集群权限。此权限包含在 machine_learning_admin 内置角色中。

描述编辑

此 API 接受 计划的事件 列表,每个事件都必须有开始时间、结束时间和描述。

路径参数编辑

<calendar_id>
(必需,字符串) 唯一标识日历的字符串。

请求正文编辑

events

(必需,数组) 一个或多个计划事件的列表。事件的开始和结束时间可以指定为自纪元以来的毫秒数,也可以指定为 ISO 8601 格式的字符串。

事件属性
description
(可选,字符串) 计划事件的描述。
end_time
(必需,日期) 计划事件结束时间的自纪元以来的毫秒数或 ISO 8601 格式。
start_time
(必需,日期) 计划事件开始时间的自纪元以来的毫秒数或 ISO 8601 格式。

示例编辑

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
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"
    }
  ]
}