Help Center/ Cloud Data Center / API Reference/ API/ Tag Management/ Batch Creating Resource Tags

Updated on 2025-12-12 GMT+08:00

CLI Examples

View PDF

Batch Creating Resource Tags

This API is used to batch create resource tags.

For details, see Calling APIs.

POST /v1/{project_id}/iracks/{id}/tags/create

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition: Project ID. Constraints: N/A Value range: Project IDs of the account Default value: N/A
id	Yes	String	Definition Rack ID. Constraints N/A Range Rack ID. Default Value N/A

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition: Requests for calling an API can be authenticated using a token. If token-based authentication is used, this parameter is mandatory and must be set to a user token. Constraints: N/A Value range: N/A Default value: N/A

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
tags	No	Array of Tag objects	Definition Tag information. Constraints N/A Range N/A Default Value N/A

**Table 4** Tag
Parameter	Mandatory	Type	Description
key	Yes	String	Definition Tag key. Constraints N/A Range The tag key: Cannot be empty and cannot start or end with spaces. Maximum length: 128 characters. Can contain letters, digits, and spaces in UTF-8 format. Can contain the following special characters: _.:=+-@ Cannot start with _sys_. The tag key cannot be empty when you delete a tag. Default Value N/A
value	No	String	Definition Tag value. Constraints N/A Range Can be null but not the default. Max characters: 255. Can contain letters, digits, and spaces in UTF-8 format. Can contain the following special characters: _.:/=+-@ Default Value N/A

Status code: 204

Request succeeded.

Status code: 400

**Table 5** Response body parameters
Parameter	Type	Description
error_msg	String	Definition Error description. Constraints N/A Range N/A Default Value N/A
error_code	String	Definition Error code. Constraints N/A Range N/A

Status code: 401

**Table 6** Response body parameters
Parameter	Type	Description
error_msg	String	Definition Error description. Constraints N/A Range N/A Default Value N/A
error_code	String	Definition Error code. Constraints N/A Range N/A

Status code: 429

**Table 7** Response body parameters
Parameter	Type	Description
error_msg	String	Definition Error description. Constraints N/A Range N/A Default Value N/A
error_code	String	Definition Error code. Constraints N/A Range N/A

Status code: 500

**Table 8** Response body parameters
Parameter	Type	Description
error_msg	String	Definition Error description. Constraints N/A Range N/A Default Value N/A
error_code	String	Definition Error code. Constraints N/A Range N/A

None

None

Status Code	Description
204	Request succeeded.
400	Invalid request parameter.
401	Request error due to user authorization not granted.
429	Request error due to too frequent requests.
500	Internal server error.