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

Updated on 2025-07-25 GMT+08:00

CLI Examples

View PDF

Batch Creating Rack Tags

For details, see Calling APIs.

POST https://www.example.com/v1/{project_id}/iracks/{id}/tags/create

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition The project ID. Constraints N/A Range The project ID of the account Default Value N/A
id	Yes	String	Definition Rack resource ID. Constraints N/A Range Rack ID Default Value N/A

**Table 2** Request header parameter
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 Range N/A Default Value N/A

**Table 3** Request body parameter
Parameter	Mandatory	Type	Description
tags	No	Array of Tag objects	Definition Tags. 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 value cannot be empty and cannot start or end with spaces. A maximum of 128 characters are supported. The value can contain letters, digits, and spaces in UTF-8 format. The value can contain the following special characters: _.:=+-@ The value cannot start with sys. Default Value N/A
value	No	String	Definition Tag value. Constraints N/A Range The value can contain a maximum of 255 characters. It can be empty but cannot be the default. The value can be letters, digits, and spaces in UTF-8 format. The value 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 message. 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 message. 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 message. 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 message. 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. User not authorized.
429	Request error due to too frequent requests.
500	Internal server error.