Updated on 2026-02-05 GMT+08:00

Unsubscribing from a Resource

Function

This API is used to cancel subscriptions to SecMaster resources. This API is supported only in pay-per-use scenarios.

Calling Method

For details, see Calling APIs.

URI

DELETE /v1/{project_id}/subscriptions/orders

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Tenant project ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token.

You can call the IAM API to obtain a user token. The value of X-Subject-Token in the response header is the user token.

X-Language

Yes

String

Current language.

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

resource_ids

No

Array of strings

Resource ID list.

Response Parameters

Status code: 204

Unsubscription succeeded.

Status code: 404

Table 4 Response body parameters

Parameter

Type

Description

error_code

String

Definition

Error code.

Range

N/A

error_msg

String

Definition

Error description.

Range

N/A

Example Requests

DELETE https://{endpoint}/v1/{projectId}/subscriptions/orders

{
  "resource_ids" : [ "1f0f5e29-5a92-17a5-2c16-5f37c6dc109c" ]
}

Example Responses

None

Status Codes

Status Code

Description

204

Unsubscription succeeded.

404

Resources are not found.

Error Codes

See Error Codes.