文档首页/ 全球加速 GA/ API参考/ API/ 标签/ 创建资源标签 - CreateTags
更新时间：2025-10-27 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建资源标签 - CreateTags

功能介绍

创建资源标签。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v1/{resource_type}/{resource_id}/tags/create

表1 路径参数

参数

是否必选

参数类型

描述

resource_type

是

Object

资源类型。

resource_id

是

String

资源ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
表3 请求Body参数

参数

是否必选

参数类型

描述

tags

是

Array of ResourceTag objects

标签列表。
表4 ResourceTag

参数

是否必选

参数类型

描述

key

是

String

标签键，规则：

  • 1.key不能为空，长度1~128个字符（中文也可以输入128个字符）。

  • 2.可用 UTF-8 格式表示的字母（包含中文）、数字和空格，以及以下字符_ . : = + - @。

  • 3._sys_开头属于系统标签，租户不能输入。

value

是

String

标签值，规则：

  • 1.长度0~255个字符（中文也可以输入255个字符）。

  • 2.可用 UTF-8 格式表示的字母（包含中文）、数字和空格，以及以下字符_ . : / = + - @。

  • 3.资源标签值可以为空（empty or null）。

响应参数

状态码：204

表5 响应Body参数

参数

参数类型

描述

request_id

String

请求ID。

请求示例

创建资源标签

POST https://{ga_endpoint}/v1/{resource_type}/{resource_id}/tags/create

{
  "tags" : [ {
    "key" : "tagKey",
    "value" : "tagValue"
  } ]
}

响应示例

状态码：204

操作成功

{
  "request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9"
}

状态码

状态码

描述

204

操作成功

错误码

请参见错误码。

父主题： 标签