更新时间:2025-07-25 GMT+08:00

批量创建机柜标签

功能介绍

批量创建机柜标签

调用方法

请参见如何调用API

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID

约束限制

不涉及

取值范围

账号的项目ID

默认取值

不涉及

id

String

参数解释

机柜资源ID

约束限制

不涉及

取值范围

机柜ID

默认取值

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释

调用接口的认证方式分为Token,如果您使用的Token方式,此参数为必填,请填写Token的值

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

tags

Array of Tag objects

参数解释

标签信息

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表4 Tag

参数

是否必选

参数类型

描述

key

String

参数解释

标签key值

约束限制

不涉及

取值范围

  • 不能为空且首尾不能包含空格,最多支持128个字符

  • 可用UTF-8格式表示的任意语种字母、数字和空格

  • 支持部分特殊字符:_.:=+-@

  • 不能以"sys"开头

默认取值

不涉及

value

String

参数解释

标签value值

约束限制

不涉及

取值范围

  • 可以为空但不能缺省,最多支持255个字符

  • 可用UTF-8格式表示的汉字、字母、数字和空格

  • 支持部分特殊字符:_.:/=+-@

默认取值

不涉及

响应参数

状态码:204

请求成功

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释

错误描述

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

error_code

String

参数解释

错误码

约束限制

不涉及

取值范围

不涉及

状态码:401

表6 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释

错误描述

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

error_code

String

参数解释

错误码

约束限制

不涉及

取值范围

不涉及

状态码:429

表7 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释

错误描述

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

error_code

String

参数解释

错误码

约束限制

不涉及

取值范围

不涉及

状态码:500

表8 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释

错误描述

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

error_code

String

参数解释

错误码

约束限制

不涉及

取值范围

不涉及

请求示例

响应示例

状态码

状态码

描述

204

请求成功

400

请求参数错误,请求失败

401

请求错误,用户未授权

429

请求错误,请求频率过高

500

服务端内部错误

错误码

请参见错误码