15.1.1.19. Periodic Task endpoints¶
These endpoints are used to create, modify and delete periodic tasks.
This module is tested in tests/test_api_periodictask.py
-
GET
/periodictask/taskmodules/
¶ Return a list of task module identifiers.
-
GET
/periodictask/nodes/
¶ Return a list of available nodes
-
GET
/periodictask/
¶ Return a list of objects of defined periodic tasks.
-
POST
/periodictask/
¶ Create or replace an existing periodic task definition.
- Parameters
id – ID of an existing periodic task definition that should be updated
name – Name of the periodic task
active – true if the periodic task should be active
retry_if_failed – privacyIDEA will retry to execute the task if failed
interval – Interval at which the periodic task should run (in cron syntax)
nodes – Comma-separated list of nodes on which the periodic task should run
taskmodule – Task module name of the task
ordering – Ordering of the task, must be a number >= 0.
options – A dictionary (possibly JSON) of periodic task options, mapping unicodes to unicodes
- Return
ID of the periodic task
-
GET
/periodictask/options/
(taskmodule)¶ Return the available options for the given taskmodule.
- Parameters
taskmodule – Identifier of the task module
- Return
a dictionary mapping option keys to description dictionaries
-
POST
/periodictask/disable/
(ptaskid)¶ Disable a certain periodic task.
- Parameters
ptaskid – ID of the periodic task
- Return
ID of the periodic task
-
POST
/periodictask/enable/
(ptaskid)¶ Enable a certain periodic task.
- Parameters
ptaskid – ID of the periodic task
- Return
ID of the periodic task
-
GET
/periodictask/
(ptaskid)¶ Return the dictionary describing a periodic task.
- Parameters
ptaskid – ID of the periodic task
-
DELETE
/periodictask/
(ptaskid)¶ Delete a certain periodic task.
- Parameters
ptaskid – ID of the periodic task
- Return
ID of the periodic task