Updated on 2022-09-19 GMT+08:00

Batch Adding or Deleting Tags

Function

This API is used to add or delete tags in batches for a DCS instance.

URI

POST /v2/{project_id}/dcs/{instance_id}/tags/action

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID.

instance_id

Yes

String

Instance ID.

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

action

Yes

String

Operation to be performed. The value can be create or delete.

tags

No

Array of ResourceTag objects

Tag list.

Table 3 ResourceTag

Parameter

Mandatory

Type

Description

key

Yes

String

Tag key.

  • This field cannot be left blank.
  • The key value of a resource must be unique.
  • The tag key can contain a maximum of 36 characters.
  • The tag key must be unique and cannot be empty.

value

No

String

Tag value.

  • This parameter is mandatory when action is set to create and is optional when action is set to delete.
  • The tag value can contain a maximum of 43 characters.

Response Parameters

None

Example Requests

POST https://{dcs_endpoint}/v2/7dddae81f0e34f62adb9618bc8c8b1fe/dcs/01928d55-7020-4500-9c29-774caabe4bc4/tags/action

Example Responses

None

Status Codes

Status Code

Description

204

Tags added or deleted successfully.

Error Codes

See Error Codes.