Spectra Logic

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

Cancel Job

Description

Cancel a job that is in progress. Any objects in the job that have been 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 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 job.

Requests

Syntax

DELETE http[s]://{datapathDNSname}/_rest_/job/{job_id}/[?force]

To determine the UUID for a job, see Get Jobs.

Request Parameters 

Parameter	Description	Required
force	If included, any objects in the job 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

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 38ada8a6-0116-42ac-9b58-a95cc89ddec9.

DELETE http://blackpearl-hostname/_rest_/job/38ada8a6-0116-42ac-9b58-a95cc89ddec9 HTTP/1.1

Sample Response

HTTP/1.1 204 No Content