tencent cloud

Canceling Task
Download PDF
Last updated: 2025-09-09 20:46:30
Canceling Task
Last updated: 2025-09-09 20:46:30
Download PDF

Feature Description

Cancel a task. Only unexecuted tasks can be canceled.

Authorization Description

When used by a sub-account, the ci:CancelMediaJob permission is required. For details, see Cloud Infinite action.

Activating a Service

To use this feature, you need to enable Cloud Infinite in advance and bind a bucket. For details, see Binding a Bucket.

Use Limits

When using this API, please first confirm the relevant restriction conditions. For details, see Usage Limits.


Request

Request sample

PUT /jobs/<jobId>?cancel HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>

Note:
Authorization: Auth String. For details, see Request Signature document.

Request header

This API only uses common request headers. For details, see Common Request Headers documentation.

Request body

This request has no request body.

Response

Response Headers

This API only returns the public response header. For details, see Common Response Headers documentation.

Response Body

This request has no response body.

Error Codes

This request returns common error responses and error codes. For more information, see Error Codes.

Examples

Request

PUT /jobs/jb57da17e29c111eda218713081fe2b05?cancel HTTP/1.1
Authorization: q-sign-algorithm=sha1&q-ak=***************************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=************************************************
Host: test-1234567890.ci.ap-chongqing.myqcloud.com


Response

HTTP/1.1 200 OK
Content-Length: 0
Connection: keep-alive
Date: Mon, 28 Jun 2022 15:23:12 GMT
Server: tencent-ci
x-ci-request-id: NjMxMDJhYTNfMThhYTk0MGFfYmU1OV8zZjY=


Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback