将TAG绑定到指定的目标（设备、账号或别名），TAG绑定在10分钟内生效。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
mpush:BindTag |
update |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| AppKey |
integer |
是 |
AppKey 信息。 |
23267207 |
| ClientKey |
string |
是 |
设备或 account 或 alias，多个 key 用逗号分隔，最多支持 1000 个。 |
e2ba19de97604f55b16557673**** |
| KeyType |
string |
是 |
ClientKey 的类型。可取值：
|
DEVICE |
| TagName |
string |
是 |
绑定的标签，多个标签用英文逗号（,）分隔，单次最多绑定 10 个标签。 标签名称不超过 128 个字符（中文计 1 个字符），每个应用最多创建 10,000 个标签，单个设备可绑定多个标签。 重要
不建议单个标签绑定超过 10 万台设备，否则推送处理时间会延长，影响响应速度。 如需对大量设备推送，建议采用以下方式：
说明
|
test_tag,test_tag2 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
82FD0A09-5BB8-40FB-8221-9A11FE92D620 |
示例
正常返回示例
JSON格式
{
"RequestId": "82FD0A09-5BB8-40FB-8221-9A11FE92D620"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | AccountDisabled | Your account is not enabled. | 功能未启用。 |
| 400 | Invalid%s.Format | The specified %s format is invalid. | 参数格式错误。 |
| 400 | Invalid%s.NotFound | The specified %s is not found. | |
| 500 | InternalError | The request processing has failed due to some unknown error. Please try again. If the error still exists, submit a ticket. | 服务端错误，建议重试，仍然失败则提工单 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。