Get calendars APIedit

Retrieves configuration information for calendars.

Requestedit

GET _ml/calendars/<calendar_id>

GET _ml/calendars/_all

Prerequisitesedit

  • You must have monitor_ml, monitor, manage_ml, or manage cluster privileges to use this API. For more information, see Security privileges.

Descriptionedit

You can get information for a single calendar or for all calendars by using _all.

Path parametersedit

calendar_id
(Required, string) Identifier for the calendar.

Request bodyedit

page
from
(integer) Skips the specified number of calendars.
size
(integer) Specifies the maximum number of calendars to obtain.

Response bodyedit

The API returns the following information:

calendars
(array) An array of calendar resources. For more information, see Calendar resources.

Examplesedit

The following example gets configuration information for the planned-outages calendar:

GET _ml/calendars/planned-outages

The API returns the following results:

{
  "count": 1,
  "calendars": [
    {
      "calendar_id": "planned-outages",
      "job_ids": [
        "total-requests"
      ]
    }
  ]
}