Spectra Logic

1-800-833-1132 : 1-303-449-6400

Cancel Jobs

Description

Cancel all jobs that are in progress. Any objects in the jobs that have been 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 have been partially written to physical data stores (regardless of whether or not they have been 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 gateway does not expect any more objects from the jobs. Use parameters to cancel a subset of the jobs.

Requests

Syntax

DELETE http[s]://{datapathDNSname}/_rest_/job/[?force] [&bucket_id={string}][&request_type=PUT|GET|VERIFY]

Request Parameters 

Parameter	Description	Required
force	If included, any objects in the jobs that have been 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.	no
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

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