Updated on 2024-03-07 GMT+08:00

Adding Tags in Batches

Function

This API is used to add tags in batches.

URI

  • URI format

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

  • Example

    https://rds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/tags/action

  • Parameter description
    Table 1 Parameter description

    Name

    Mandatory

    Description

    project_id

    Yes

    Specifies the project ID of a tenant in a region.

    For details about how to obtain the project ID, see Obtaining a Project ID.

    instance_id

    Yes

    Specifies the DB instance ID.

Request

  • Parameter description
    Table 2 Parameter description

    Name

    Mandatory

    Type

    Description

    action

    Yes

    String

    Specifies the operation identifier (case sensitive), which is create during the creation operation.

    tags

    Yes

    Array of objects

    Specifies the tag list. A maximum of 10 tags can be added for each DB instance.

    For details, see Table 3.

    Table 3 tags field data structure description

    Name

    Mandatory

    Type

    Description

    key

    Yes

    String

    Specifies the tag key, which contains a maximum of 36 Unicode characters.

    The key cannot be left blank or an empty string. It can be any of Unicode characters (\u4E00-\u9FFF) or the following character set: A-Z, a-z, 0-9, hyphens (-), and underscores (_).

    value

    Yes

    String

    Specifies the tag value, which contains a maximum of 43 Unicode characters.

    The value can be an empty character string. It can be any of Unicode characters (\u4E00-\u9FFF) or the following character set: A-Z, a-z, 0-9, periods (.), hyphens (-), and underscores (_).

  • Request example
    {
    	"action": "create",
    	"tags": [{
    		"key": "key1",
    		"value": "value1"
    	}, {
    		"key": "key2",
    		"value": "value2"
    	}]
    }

Response

Status Code

For details, see Status Codes.

Error Code

For details, see Error Codes.