Create and run a job instance

This operation enables you to create a job instance if one is not currently running. The job instance created runs on an immediate single-run schedule. If there is a current job instance and the "requested_status" parameter is given, then the system attempts to change the status of the current job instance to the requested status.

NOTE: This status change is not guaranteed as there may be occasions where the requested status is invalid, e.g. setting the status of a running job instance to "suspended". The client should poll the current job instance with a GET to determine whether the requested state has been achieved.

Language