5.2 预定义标签操作
5.2.1 创建删除预定义标签
功能介绍
用于创建或删除预定义标签。用户创建预定义标签后，可以使用预定义标签来给资源 创建标签。 该接口支持幂等特性和处理批量数据。
调试
您可以在API Explorer中调试该接口。
URI
POST /v1.0/predefine_tags/action
请求参数
表5-54 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。说明：由于TMS是 全局服务，因此调用IAM服务获
action 是 String 操作标识（区分大小写）：
create（创建）
表5-56 PredefineTagRequest
参数 是否必选 参数类型 描述
key 是 String 键。最大长度36个字符。字符
集：A-Z，a-z ， 0-9，‘-’，
‘_’，UNICODE字符
参数 是否必选 参数类型 描述
value 是 String 值。每个值最大长度43个字
符，可以为空字符串。字符集：
AZ，a-z ， 0-9，‘.’，
‘-’，‘_’，UNICODE字符
（\u4E00-\u9FFF）。
响应参数
状态码： 400
表5-57 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-58 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 401
表5-59 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-60 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 403
表5-61 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-62 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 404
表5-63 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-64 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 405
表5-65 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-66 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 406
表5-67 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-68 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 409
表5-69 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-70 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 410
表5-71 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-72 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 412
表5-73 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-74 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 429
表5-75 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-76 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 500
表5-77 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-78 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 501
表5-79 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-80 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 503
表5-81 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-82 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
请求示例
● 创建预定义标签
POST https://{Endpoint}/v1.0/predefine_tags/action { "action" : "create",
"tags" : [ {
POST https://{Endpoint}/v1.0/predefine_tags/action { "action" : "delete",
"tags" : [ {
204 No Content
状态码 描述
401 Unauthorized 403 Forbidden 404 Not Found
405 Method Not Allowed 406 Not Acceptable 409 Conflict
410 Gone
412 Precondition Failed 429 Too Many Requests 500 Internal Server Error 501 Not Implemented 503 Service Unavailable
错误码
请参见错误码。