Cancel Active Job Description Cancel a job that is in progress. Any objects in the job that were written in their entirety to physical data stores are retained. Any objects in the job that were received in their entirety in cache are retained unless the force flag is used. Additionally, if the force flag is used, any objects in the job that were partially written to physical data stores (regardless of whether or not they are completely written to cache) are deleted and any space the object pieces consumed on physical data stores are marked as eligible for reclamation. The BlackPearl system does not expect any more objects from the job. Note: This command is an alias for Cancel Job. Requests Syntax DELETE http[s]://{datapathDNSname}/_rest_/active_job/{job_id} ?force To determine the UUID for a job, see Get Active Jobs. Request Parameters Parameter Description Required force Any objects in the job that were partially written to physical data stores are deleted and any space the object pieces consumed on physical data stores are marked as eligible for reclamation. Additionally, objects received in cache are also deleted. Note: Objects written entirely to the physical data stores are not deleted. If you need to ensure that all objects from a job are deleted from the BlackPearl system after canceling the job, issue a delete object command for each of the objects. yes Responses Response Elements The operation returns status only. Notable status codes: § 204: No Content (success) § 403: Forbidden (user does not have permission to cancel the job) § 404: Not Found Example Sample Request This request cancels the job with the UUID e140e1a3-4938-4615-b08d-6dd7a7e79e4f. DELETE http://blackpearl-hostname/_rest_/active_job/e140e1a3-4938-4615-b08d-6dd7a7e79e4f HTTP/1.1 Sample Response HTTP/1.1 204 No Content
