Help Center > > API Reference> API v3 (Recommended)> Tag Management> Adding Tags in Batches

Adding Tags in Batches

Updated at: Apr 22, 2020 GMT+08:00

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.ap-southeast-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.

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

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

Did you find this page helpful?

Submit successfully!

Thank you for your feedback. Your feedback helps make our documentation better.

Failed to submit the feedback. Please try again later.

Which of the following issues have you encountered?







Please complete at least one feedback item.

Content most length 200 character

Content is empty.

OK Cancel