更新时间：2026-08-18 GMT+08:00

批量添加密钥对标签 - BatchCreateTags

批量添加密钥对标签

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

POST /v3/{project_id}/keypairs/{resource_id}/tags/create

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID。可参考获取项目ID获取。约束限制：不涉及取值范围：以IAM服务接口返回值为准，字符长度32-32 默认取值：不涉及
resource_id	是	String	参数解释：资源ID 约束限制：不涉及取值范围：不涉及默认取值：不涉及

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。通过调用IAM服务查询用户Token接口获取（响应消息头中X-Subject-Token的值）约束限制：不涉及取值范围： IAM服务查询用户Token接口为准默认取值：不涉及

表3 请求Body参数
参数	是否必选	参数类型	描述
tags	是	Array of TagItem objects	参数解释：标签列表，key和value键值对的集合约束限制：不涉及取值范围：不涉及默认取值：不涉及
sys_tags	否	Array of TagItem objects	参数解释：标签列表，key和value键值对的集合约束限制：不涉及取值范围：不涉及默认取值：不涉及

表4 TagItem
参数	是否必选	参数类型	描述
key	是	String	参数解释：标签的名称约束限制：同一个密钥对，一个标签键只能对应一个标签值；不同的密钥对可以使用相同的标签键用户最多可以给单个密钥对添加20个标签取值范围：取值范围为1到128个字符，满足正则匹配"^((?!\s)(?!sys)[\p{L}\p{Z}\p{N}_.:=+\-@])(?<!\s)$" 默认取值：* 不涉及
value	否	String	参数解释：标签的值约束限制：不涉及取值范围：取值范围不超过255个字符，满足正则匹配"^([\p{L}\p{Z}\p{N}_.:\/=+\-@])$" 默认取值：* 不涉及

状态码：204

无

{
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value2"
  } ]
}

无

请参见错误码。