History
Introduction
API Category
Making API Requests
Region APIs
Instance APIs
Cloud Hosting Cluster APIs
Image APIs
Instance Launch Template APIs
Placement Group APIs
Key APIs
Security Group APIs
Network APIs
Data Types
Error Codes
POST /jobs/<JobId>/status?requestedJobStatus=<RequestedJobStatus>&statusUpdateReason=<StatusUpdateReason> HTTP/1.1x-cos-appid: <appid>
UpdateJobStatus API requires the following parameters:Parameter | Description | Required |
JobId | ID of the batch operation job to be updated. | Yes |
requestedJobStatus | Your desired job status. If you change the job status to Ready, COS will think that you have confirmed the job and will execute it. If you change the job status to Cancelled, COS will cancel the job. Valid values: Ready, Cancelled. | Yes |
statusUpdateReason | Reason for the status update; length: 0–256 bytes. | No |
x-cos-appid | User APPID with a length of 1–64 bytes. | Yes |
HTTP/1.1 200<UpdateJobStatusResult><JobId>string</JobId><Status>string</Status><StatusUpdateReason>string</StatusUpdateReason></UpdateJobStatusResult>
<UpdateJobStatusResult><JobId>string</JobId><Status>string</Status><StatusUpdateReason>string</StatusUpdateReason></UpdateJobStatusResult>
Node Name | Parent Node | Description | Type |
JobId | UpdateJobStatusResult | ID of the job you update; length: 5–36 bytes. | String |
Status | UpdateJobStatusResult | Current job status. Valid values: Active, Cancelled, Cancelling, Complete, Completing, Failed, Failing, New, Paused, Pausing, Preparing, Ready, Suspended. | String |
StatusUpdateReason | UpdateJobStatusResult | Reason for the status update; length: 0–256 bytes. | String |
Error Code | Description | Status Code | API |
InvalidArgument | The value of the requestedJobStatus parameter must be Cancelled or Ready | 400 | UpdateJobStatus |
InvalidRequest | The specified job has already been completed | 400 | UpdateJobStatus |
InvalidRequest | Error with the job status change | 400 | UpdateJobStatus |
NoSuchJob | The specified job does not exist or has already been completed | 404 | UpdateJobStatus, UpdateJobPriority |
フィードバック