Deleting Resource Pool Tags in Batches¶

Function¶

This API is used to delete tags of a specified resource. Batch deletion is supported.

URI¶

DELETE /v1/{project_id}/pools/{pool_name}/tags/delete

**Table 1** Path Parameters¶
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID and Name.
pool_name	Yes	String	Resource pool name. The value is the name value in the metadata field of the resource pool details.

Request Parameters¶

**Table 2** Request body parameters¶
Parameter	Mandatory	Type	Description
tags	Yes	Array of tags objects	Tags to be deleted

**Table 3** tags¶
Parameter	Mandatory	Type	Description
key	Yes	String	Tag key Minimum: 1 Maximum: 128
value	No	String	Tag value. This parameter is optional. If this parameter is left blank, the tag that matches the key is deleted. Minimum: 0 Maximum: 255

Response Parameters¶

Status code: 204

**Table 4** Response body parameters¶
Parameter	Type	Description
tags	Tag object	Resource tag list

**Table 5** Tag¶
Parameter	Type	Description
key	String	Tag key Minimum: 1 Maximum: 128
value	String	Tag value Minimum: 0 Maximum: 255

Status code: 400

**Table 6** Response body parameters¶
Parameter	Type	Description
error_code	String	Error codes of ModelArts
error_msg	String	Error message

Status code: 401

**Table 7** Response body parameters¶
Parameter	Type	Description
error_code	String	Error codes of ModelArts
error_msg	String	Error message

Status code: 403

**Table 8** Response body parameters¶
Parameter	Type	Description
error_code	String	Error codes of ModelArts
error_msg	String	Error message

Status code: 404

**Table 9** Response body parameters¶
Parameter	Type	Description
error_code	String	Error codes of ModelArts
error_msg	String	Error message

Example Requests¶

https://{endpoint}/v1/{project_id}/pools/a55eba18-1ebf-4e9a-8229-d2d3b593a3dc/tags/delete

{
  "tags" : [ {
    "key" : "dev",
    "value" : "dev1"
  } ]
}

Example Responses¶

Status code: 204

Tags deleted successfully.

{
  "tags" : [ {
    "key" : "dev",
    "value" : "dev1"
  } ]
}

Status Codes¶

Status Code	Description
204	Tags deleted successfully.
400	Invalid parameters.
401	Authentication failed.
403	Insufficient permission.
404	Resource not found.

Error Codes¶

See Error Codes.

last updated: 2025-02-14 13:31 UTC - commit: b9dfcea0f4de207ab46ae186e9fafba6d70e5908