tencent cloud

All product documents
Cloud Object Storage
DocumentationCloud Object StorageAPI DocumentationBatch Operation APIsUpdateJobPriority
UpdateJobPriority
Download PDF
Last updated: 2024-06-12 15:20:05
UpdateJobPriority
Last updated: 2024-06-12 15:20:05
Download PDF

Feature Description

This API is used to upgrade the priority of a job. The greater the value, the higher the priority. Jobs with a higher priority will be carried out first. For more information on batch operation jobs, see Batch Operation Overview.

Request

Sample Request
POST /jobs/<JobId>/priority?priority=<Priority> HTTP/1.1
x-cos-appid: <appid>
Request Parameters
Calling the UpdateJobPriority API requires the following parameters:
Parameter
Description
Required
JobId
ID of the batch operation job to be updated; length: 1–64 bytes.
Yes
priority
New job priority. Value range: 0-2,147,483,647.
Yes
x-cos-appid
User APPID with a length of 1–64 bytes.
Yes
Request Headers
This API only uses common request headers. For more information, see Common Request Headers.
Request Body
This request does not have a request body.

Response

Sample Response
HTTP/1.1 200
<UpdateJobPriorityResult>
    <JobId>string</JobId>
    <Priority>integer</Priority>
</UpdateJobPriorityResult>
Response Headers This API only returns common response headers. For more information, see Common Response Headers.
Response Body
<UpdateJobPriorityResult>
    <JobId>string</JobId>
    <Priority>integer</Priority>
</UpdateJobPriorityResult>
The content is described in detail as below:
UpdateJobStatusResult
Node Name
Parent Node
Description
Type
JobId
UpdateJobPriorityResult
ID of the job you update; length: 1–64 bytes.
String
Priority
UpdateJobPriorityResult
Current job priority. Value range: 0-2,147,483,647.
Integer

Error Codes

The following describes some frequent special errors that may occur when you make this request.
Error Code
Description
Status Code
API
InvalidRequest
No job priority is provided
400
UpdateJobPriority
NoSuchJob
The specified job does not exist or has already been completed
404
UpdateJobStatus, UpdateJobPriority
For other errors, see ErrorResponse.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

Submit a Ticket
7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon