The schedules API provides functionality that allows a administrator to add, delete or update schedules
Lists all the schedules configured in the Aspire
GET /aspire/_api/schedules
Query String Parameters
Name | Type | Required | Description |
---|---|---|---|
type | string | Optional | Filter returned schedules to only those with the given type |
description | string | Optional | Filter returned schedules to only those whose description matches the given expression |
Response
{ "schedule": [{ "id": "AAABcID5GBc=", "type": "time", "description": "Weekly seeds" "running": false, "enabled": true, "time": { "scheduleType": "weekly", "schedule": "* * * * 1", "last": 123456789, "next": 123456789, }, "seed": ["AAABcIueWUd=", "AAABcIueWUe="] }, { "id": "AAABcIueWUc=", "type": "sequential", "description": "Rollup" "running": false, "enabled": false, "sequence": { "after": "AAABcID5GBc=", "last": 123456789, }, "seed": ["AAABcIueWUd=", "AAABcIueWUe="] }, ... }] }
Status
Response code | Description |
---|---|
200 | Success |
Get information about a single schedule configured in Aspire
GET /aspire/_api/schedules/:id
Path Parameters
Name | Type | Required | Description |
---|---|---|---|
id | string | Required | The id of the schedule to return |
Response
{ "schedule": { "id": "AAABcID5GBc=", "type": "time", "description": "Weekly seeds" "running": false, "enabled": true, "time": { "scheduleType": "weekly", "schedule": "* * * * 1", "last": 123456789, "next": 123456789, }, "seed": ["AAABcIueWUd=", "AAABcIueWUe="] }, "message": "optional response message" }
Status
Response code | Description |
---|---|
200 | Success |
404 | The given schedules id was not found |
Add one or more schedules to Aspire
POST /aspire/_api/schedules
Request Body Parameters
Name | Type | Required | Description |
---|---|---|---|
type | string | Required | The type of schedule to add
|
description | string | Optional | An optional description of the schedule |
Other parameters passed in the request body will depend on the type of schedule being created. Some candidates are shown below
Name | Description |
---|---|
enabled | Whether this schedule is enabled or not |
scheduleType | The type of the time based schedule
|
schedule | the cron like schedule for a time based schedule |
after | the id of the schedule after which this schedule should run (for a sequence based schedule) |
seed | the seed(s) this schedule applies to |
Examples
Add a single schedule
POST /aspire/_api/schedules { "type": "time", "description": "Weekly seeds" "enabled": true, "scheduleType": "weekly", "schedule": "* * * * 1", "seed": ["AAABcIueWUd=", "AAABcIueWUe="] }
Add multiple schedules
POST /aspire/_api/schedules [{ "type": "time", "description": "Weekly seeds" "enabled": true, "scheduleType": "weekly", "schedule": "* * * * 1", "seed": ["AAABcIueWUd=", "AAABcIueWUe="] }, { "type": "sequence", "description": "Rollup" "enabled": false, "after": "* * * * 1", "seed": ["AAABcIudWUd=", "AAABcIudWUe="] }]
Response
{ "schedule": [{ "id": "AAABcIueWU0", "type": "time", "description": "Weekly seeds" "enabled": true, "scheduleType": "weekly", "schedule": "* * * * 1", "seed": ["AAABcIueWUd=", "AAABcIueWUe="] }, { "id": "AAABcIueWU1", "type": "sequence", "description": "Rollup" "enabled": false, "after": "* * * * 1", "seed": ["AAABcIudWUd=", "AAABcIudWUe="] }] }
Status
Response code | Description |
---|---|
201 | Created |
406 | Not acceptable - there was an issue validating the input |
Update one or more schedules in Aspire.
PUT /aspire/_api/schedules/:id
PUT /aspire/_api/schedules
Path and Request Body Parameters
Name | Type | Required | Description |
---|---|---|---|
id | string | Required | The identifier of the schedule to update |
type | string | Required | The type of schedule |
description | string | Optional | An optional description of the schedule |
Other parameters passed in the request body will depend on the type of schedule being created - see Add schedule(s) above
Examples
Update a single schedule
PUT /aspire/_api/schedules/AAABcIueWU0%3D { "id": "AAABcIueWU0=", "type": "time", "description": "Weekly seeds" "enabled": true, "scheduleType": "weekly", "schedule": "* * * * 1", "seed": ["AAABcIueWUd=", "AAABcIueWUe="] }
Update multiple schedules
PUT /aspire/_api/schedules { "AAABcIueWU0=": { "id": "AAABcIueWU0", "type": "time", "description": "Weekly seeds" "enabled": true, "scheduleType": "weekly", "schedule": "* * * * 1", "seed": ["AAABcIueWUd=", "AAABcIueWUe="] }, "AAABcIueWU1": { "id": "AAABcIueWU1", "type": "sequence", "description": "Rollup" "enabled": false, "after": "* * * * 1", "seed": ["AAABcIudWUd=", "AAABcIudWUe="] } }
Response
{ "schedule": [{ "id": "AAABcIueWU0", "type": "time", "description": "Weekly seeds" "enabled": true, "scheduleType": "weekly", "schedule": "* * * * 1", "seed": ["AAABcIueWUd=", "AAABcIueWUe="] }, { "id": "AAABcIueWU1", "type": "sequence", "description": "Rollup" "enabled": false, "after": "* * * * 1", "seed": ["AAABcIudWUd=", "AAABcIudWUe="] }] }
Status
Response code | Description |
---|---|
200 | Success |
404 | Not found - a given schedule identifier was not found |
406 | Not acceptable - there was an issue validating the input |
Delete one or more schedules from Aspire.
DELETE /aspire/_api/schedule/:id
DELETE /aspire/_api/schedule
Path and Request Body Parameters
Name | Type | Required | Description |
---|---|---|---|
id | string | Required | The identifier(s) of the schedule(s) to delete |
Examples
Delete a single schedule
DELETE /aspire/_api/schedule/AAABcID5GBc%3D
Delete multiple schedules
DELETE /aspire/_api/schedule?id=AAABcID5GBc%3d&id=AAABcIueWUc%3D
Response
{ "message": "optional response message" }
Status
Response code | Description |
---|---|
200 | Success |
404 | Not found - a given schedule identifier was not found |
406 | Not acceptable - there was an issue validating the input |