WARNING: Version 6.2 of Elasticsearch has passed its EOL date.

This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.

› › ›

Get Calendars API

This API enables you to retrieve configuration information for calendars.

Request

GET _xpack/ml/calendars/<calendar_id>

GET _xpack/ml/calendars/_all

Description

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

Path Parameters

calendar_id: (string) Identifier for the calendar.

Request Body

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

Results

The API returns the following information:

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

Authorization

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

Examples

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

GET _xpack/ml/calendars/planned-outages

The API returns the following results:

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

« Forecast Jobs API Get Buckets API »