Adding or Deleting Resource Tags in Batches

Description

This API is used to add or delete tags of the specified instance in batches.

Restrictions

• A maximum of 10 tags can be added to a DB instance. The tag key must be unique.
  • If the request body contains duplicated keys, an error message will be reported when the API is called.
  • If the key in the request body is the same as an existing key in the specified instance, the value of the value parameter that corresponds to the existing key is overwritten.
• If tags to be deleted do not exist, the operation is considered to be successful by default. The character set of the tags will not be checked. The tag structure in the request body cannot be missing, and the key cannot be left blank or an empty string.

URI

• URI format

  POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/tags/action

Request Parameters

• Request example

  Add tags.

  {
    "action": "create",
    "tags": [
      {
        "key": "key1",
        "value": "value1"
      },
      {
        "key": "key",
        "value": "value3"
      }
    ]
  }

  Delete tags.

  {
    "action": "delete",
    "tags": [
      {
        "key": "key1"
      },
      {
        "key": "key2",
        "value": "value3"
      }
    ]
  }

Response Parameters

{}

Status Code

For details, see Status Code.

Error Code

For details, see Error Code.