Set the expiration timestamp

put/jobs/{jobId}/expirationTimeStamp

Updates the job's expiration timestamp with a data string in the format yyyy-MM-ddTHH:mm:ss.SSSZ. To clear the expiration timestamp, provide an empty value for the value-query parameter. The body of this request must be empty. Until the job has completed, this operation returns a 409 conflict with an error code of 31503.

Request Samples

1

Response Samples

12023-04-07T23:59:31.570Z

Path Parameters

NameTypeRequiredDescription
jobId
string
true

The ID of the job.

Query Parameters

NameTypeRequiredDescription
value
string
false

The expiration timestamp in the format yyyy-MM-ddTHH:mm:ss.SSSZ. To clear the expirationTimeStamp, leave this field empty.

Responses

StatusMeaningDescription
200OK

The request succeeded. The timestamp is returned in a string format of yyyy-MM-ddTHH:mm:ss.SSSZ.

Schema
204No Content

The expiration timestamp is not set.

400Bad Request

The request was invalid. The request included a timestamp that was not in the format yyyy-MM-ddTHH:mm:ss.SSSZ (error code 31504).

Schema
404Not Found

No job exists at the requested path.

Schema
409Conflict

The request could not be completed due to a conflict with the current state of the resource. The job has not yet completed and the expiration timestamp cannot be set (error code 31503).

Schema