Adding Resource Tags

Function

Add tags to a specified resource.

The API is idempotent.

If a to-be-created tag has the same key as an existing tag, the tag will be created and overwrite the existing one.

URI

POST /v2/{project_id}/{resource_type}/{resource_id}/tags

Request

• Parameter description

  Table 2 Parameter in the request

  Parameter	Mandatory	Type	Description
  tag	Yes	Object	Tag For details, see Table 3.

  Table 3 Parameters in the tag list

  Parameter	Mandatory	Type	Description
  key	Yes	String	Tag key A key can contain up to 36 Unicode characters. key must be specified. Equal signs (=), asterisks (*), left angle brackets (<), right angle brackets (>), backslashes (\), commas (,), vertical bars (|), and slashes (/) are not allowed. The first and last characters cannot be spaces.
  value	No	String	Tag value Each value can contain a maximum of 43 Unicode characters and can be an empty string. Equal signs (=), asterisks (*), left angle brackets (<), right angle brackets (>), backslashes (\), commas (,), vertical bars (|), and slashes (/) are not allowed. The first and last characters cannot be spaces.

• Example request
  Add tags for the private zone whose ID is ff8080825b8fc86c015b94bc6f8712c3:

  POST https://{DNS_Endpoint}/v2/{project_id}/DNS-private_zone/ff8080825b8fc86c015b94bc6f8712c3/tags

  {
      "tag": {
          "key": "key1", 
          "value": "value1"
      }
  }

Response

None

Returned Value

If a 2xx status code is returned, for example, 200, 202, or 204, the request is successful.

For details, see Status Code.