更新时间:2025-11-18 GMT+08:00
添加资源标签 - CreateTag
功能介绍
该API用于为资源添加标签。
一个资源上最多有20个标签。
此接口为幂等接口,创建时,如果创建的标签已经存在(key相同),则覆盖。
URI
POST /v2/{project_id}/{resource_type}/{resource_id}/tags
| 名称 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
| project_id | 是 | String | 项目ID,获取方法请参见获取项目ID。 |
| resource_type | 是 | String | 资源类型
|
| resource_id | 是 | String | 资源id |
请求消息
请求参数
| 参数 | 是否必选 | 类型 | 描述 |
|---|---|---|---|
| Content-Type | 是 | String | 消息体的类型(格式) 推荐您使用默认值application/json。 |
| X-Auth-Token | 是 | String | 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
| ief-instance-id | 否 | String | 企业版实例ID,专业版实例为空值 |
| 名称 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
| tag | 是 | tag object | 包含标签 |
| 名称 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
| key | 是 | String | 键。最大长度36个unicode字符。 不能为空,只能包含大小写字母、数字、中划线-、下划线_。 |
| value | 是 | String | 值。每个值最大长度43个unicode字符。 不能为空,只能包含大小写字母、数字、中划线-、下划线_。 |
请求示例
{
"tag": {
"key": "key0",
"value": "ief-tag-test"
}
} 错误码
请参见错误码。
父主题: 标签管理