Updated on 2026-09-07 GMT+08:00

Deleting a Subscription Task

This API is used to delete a subscription task.

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, no identity policy-based permissions are required for calling this API.

DELETE /v5/{project_id}/subscriptions/{job_id}

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID of a tenant in a region. For details about how to obtain the project ID, see Obtaining a Project ID.
job_id	Yes	String	Task ID.

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
Content-Type	No	String	MIME type of the request body. Use the default value application/json. For APIs used to upload objects or images, the value varies depending on the flow type.
X-Auth-Token	Yes	String	User token obtained from IAM. It is a response to the API for obtaining a user token. This API is the only one that does not require authentication. After a request is processed, the value of X-Subject-Token in the header is the token value.
X-Language	No	String	Request language type Enumerated values: en-us zh-cn

Status code: 200

Status code: 400

**Table 3** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Deleting a subscription task with a specified ID

https://{endpoint}/v5/054ba152d480d55b2f5dc0069e7ddef0/subscriptions/dc6016cf-f3b6-4c2d-b4d7-5084b0fjb20r

Status code: 200

{ }

Status code: 400

Bad Request

{
  "error_code" : "DRS.10020072",
  "error_msg" : "User restricted."
}

Status Code	Description
200	OK
400	Bad Request

For other statuses, see Status Code.

For details, see Error Code.

Parent topic: Task Management