History
Introduction
API Category
Making API Requests
Region APIs
Instance APIs
Cloud Hosting Cluster APIs
Image APIs
Instance Launch Template APIs
Placement Group APIs
Key APIs
Security Group APIs
Network APIs
Data Types
Error Codes
服务地址/v3/device/tag
参数名 | 类型 | 是否必需 | 参数说明 |
operator_type | Integer | 是 | 操作类型：
1 - 增加单个 tag，对单个 token 而言
2 - 删除单个 tag，对单个 token 而言
3 - 增加多个 tag，对单个 token 而言
4 - 删除多个 tag，对单个 token 而言
5 - 删除所有标签，对单个 token 而言
6 - 标签覆盖接口（支持多个标签或自定义类标签覆盖），对单个 token 而言
（此接口要清除历史标签之后，才开始设置新的标签，所以针对单个相同 token 的调用，需要间隔一段时间（建议大于1s），否则可能造成更新失败）
7 - 添加单个 tag，对多个 token 而言
8 - 删除单个 tag，对多个 token 而言
9 - 批量添加标签（每次调用最多允许设置20对，每个对里面标签在前，token 在后）
10 - 批量删除标签（每次调用最多允许设置20对，每个对里面标签在前，token 在后） |
token_list | Array | 否 | 设备列表： operator_type = 1,2,3,4,5,6,7,8时，必填 operator_type = 1,2,3,4,5,6时如果该参数包含多个 token 只会设置第一个 token 格式 eg：["token1","token2"] 列表最大不能超过500个值 token 字符串长度不能超过36 |
tag_list | Array | 否 | 标签列表： operator_type = 1,2,3,4,6,7,8时，必填，operator_type = 5时忽略 operator_type = 1,2,7,8 时，如果该参数包含多个 tag 时，如果只是对单个 tag 操作，则只会设置第一个 tag 格式 eg：["tag1","tag2"] 列表最大不能超过500个值 tag 字符串长度不能超过50 |
tag_token_list | Array | 否 | 标签、设备对应列表： operator_type =9,10时，必填 格式 eg： [{"tag":"tag123", "token":"token123"}] 每个对里面标签在前，token 在后 列表最大不能超过500个值 tag 字符串长度不能超过50 token 字符串长度不能超过36 |
Tag， 每个设备Token最多可绑定100个自定义Tag，如需提高该限制，请与我们 客服联系，每个自定义Tag可绑定的设备 token 数量无限制。字段名 | 类型 | 是否必填 | 注释 |
ret_code | Integer | 是 | 错误码，详细参照错误码对照表 |
err_msg | String | 否 | 请求出错时的错误信息 |
result | String | 否 | 请求正确时： 若有额外数据要返回，则结果封装在该字段的 json 中 若无额外数据，则可能无此字段 |
{"operator_type": 1,"tag_list": ["tag1"],"token_list": ["token1"]}
{"operator_type": 2,"tag_list": ["tag1"],"token_list": ["token1"]}
{"operator_type": 3,"tag_list": ["tag1","tag2"],"token_list": ["token1"]}
{"operator_type": 4,"tag_list": ["tag1","tag2"],"token_list": ["token1"]}
{"operator_type": 5,"tag_list": ["tag1","tag2"],"token_list": ["token1"]}
{"operator_type": 6,"tag_list": ["test:2","level"],"token_list": ["token1"]}
{"operator_type": 6,"tag_list": ["test:2","level:2"],"token_list": ["token1"]}
{"operator_type": 7,"tag_list": ["tag1"],"token_list": ["token1","token2"]}
{"operator_type": 8,"tag_list": ["tag1"],"token_list": ["token1","token2"]}
{"operator_type": 9,"tag_token_list": [{"tag": "tag1","token": "token1"}]}
{"operator_type": 10,"tag_token_list": [{"tag": "tag1","token": "token1"},{"tag": "tag2","token": "token2"},{"tag": "tag3","token": "token3"}]}
POST /v3/device/tag HTTP/1.1Host: api.tpns.tencent.comContent-Type: application/jsonAuthorization: Basic YTViNWYwNzFmZjc3YTplYTUxMmViNzcwNGQ1ZmI1YTZhOTM3Y2FmYTcwZTc3MQ==Cache-Control: no-cachePostman-Token: 4b82a159-afdd-4f5c-b459-de978d845d2f{"operator_type": 1,"tag_list": ["tag1"],"token_list": ["token1"]}
{"seq": 0,"ret_code": 0}
文档反馈