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.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
400BadRequestResponse indicates a request with invalid parameters.
401UnauthorizedResponse signals an unauthorized API access.
403ForbiddenResponse signals a request for a resource that does not exist or is not authorized.
500GenericError generic error.