Cancel Active Jobs Description Cancel all jobs that are in progress. Any objects in the jobs that were written in their entirety to physical data stores are retained. Any objects in the jobs 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 jobs 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 jobs. Use parameters to cancel a subset of the jobs. Note: This command is an alias for Cancel Jobs. Requests Syntax DELETE http[s]://{datapathDNSname}/_rest_/active_job[?force][&bucket_id={string}][&request_type=PUT|GET|VERIFY] Request Parameters Parameter Description Required force Any objects in the jobs 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 system after canceling the job, issue a delete object command for each of the objects. yes bucket_id a The UUID, name, or other unique identifier for the bucket on which the job is operating. no request_type Type of job request. Values: GET, PUT, VERIFY no a. Parameter values can use wild cards (see Wild Card Syntax). 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 jobs) Example Sample Request This request cancels all jobs in progress. DELETE http://blackpearl-hostname/_rest_/job/ HTTP/1.1 Sample Response HTTP/1.1 204 No Content
