Updated on 2025-09-16 GMT+08:00

Batch Deleting Templates

Function

This API is used to delete templates with specified IDs in batches.

Calling Method

For details, see Calling APIs.

URI

POST /v3/vm/templates/delete

Request

Table 1 Request header parameter

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

X-Auth-Token

The user token.

The token can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token.

Minimum length: 1 character

Maximum length: 16,384 characters

Table 2 Request body parameter

Parameter

Mandatory

Type

Description

ids

No

Array of strings

The IDs of the templates to be deleted.

Minimum length: 0 characters

Maximum length: 255 characters

Array length: 0 to 65,535

Response

Status code: 200

OK

None

Example Request

This example deletes templates whose IDs are 3db302e8-95de-478c-a892-8a083f2d269b and 708847ae-f013-4b1a-8ea8-6cfa1e94237d.

POST https://{endpoint}/v3/vm/templates/delete

{
  "ids" : [ "3db302e8-95de-478c-a892-8a083f2d269b", "708847ae-f013-4b1a-8ea8-6cfa1e94237d" ]
}

Example Response

None

Status Codes

Status Code

Description

200

OK

Error Codes

For details, see Error Codes.