Help Center/ ModelArts/ API Reference/ Resource Management/ Tag Management/ Deleting Tags of a Resource Pool
Updated on 2024-06-13 GMT+08:00
View PDF

Deleting Tags of a Resource Pool

Function

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

URI

DELETE /v1/{project_id}/pools/{resource_id}/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.

resource_id

Yes

String

Resource ID, which is the name of the resource pool

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 parameter.

401

Authentication failed.

403

Insufficient permission.

404

The resource does not exist.

Error Codes

See Error Codes.

Parent topic: Tag Management