IMPORTANT: No additional bug fixes or documentation updates
will be released for this version. For the latest information, see the
current release documentation.
Get Scheduled Events API
editGet Scheduled Events API
editRetrieves information about the scheduled events in calendars.
Request
editGET _xpack/ml/calendars/<calendar_id>/events
GET _xpack/ml/calendars/_all/events
Description
editYou can get scheduled event information for a single calendar or for all
calendars by using _all
.
Path Parameters
edit-
calendar_id
(required) - (string) Identifier for the calendar.
Request Body
edit-
end
- (string) Specifies to get events with timestamps earlier than this time.
-
from
- (integer) Skips the specified number of events.
-
size
- (integer) Specifies the maximum number of events to obtain.
-
start
- (string) Specifies to get events with timestamps after this time.
Results
editThe API returns the following information:
-
events
- (array) An array of scheduled event resources. For more information, see Scheduled Event Resources.
Authorization
editYou must have monitor_ml
, monitor
, manage_ml
, or manage
cluster
privileges to use this API. For more information, see
Security privileges.
Examples
editThe following example gets information about the scheduled events in the
planned-outages
calendar:
GET _xpack/ml/calendars/planned-outages/events
The API returns the following results:
{ "count": 3, "events": [ { "description": "event 1", "start_time": 1513641600000, "end_time": 1513728000000, "calendar_id": "planned-outages", "event_id": "LS8LJGEBMTCMA-qz49st" }, { "description": "event 2", "start_time": 1513814400000, "end_time": 1513900800000, "calendar_id": "planned-outages", "event_id": "Li8LJGEBMTCMA-qz49st" }, { "description": "event 3", "start_time": 1514160000000, "end_time": 1514246400000, "calendar_id": "planned-outages", "event_id": "Ly8LJGEBMTCMA-qz49st" } ] }
For more information about these properties, see Scheduled Event Resources.