调用该接口为指定产品创建标签。

限制说明

  • 单次调用该接口最多能为指定产品创建10个标签。
  • 单个产品的标签总数不超过100个。

请求参数

名称 类型 是否必需 描述
Action String 是 要执行的操作。取值CreateProductTags。
ProductKey String 是 产品Key，物联网平台为产品颁发的唯一标识。
ProductTags List<ProductTag> 是 要创建的标签。标签包括TagKey和TagValue，分别对应标签的key和value。请参见下表ProductTag。
说明 新增标签的TagKey不能重复，也不能和已有标签的key重复。
IotInstanceId String 否 公共实例不传此参数；仅独享实例需传入实例ID。
公共请求参数 - 是 请参见公共参数。
表 1. ProductTag
名称 类型 是否必需 描述
TagKey String 是 产品标签键（key）。可包含英文大小写字母，数字和点号（.），长度不可超过30个字符。
TagValue String 是 产品标签值（value）。可包含中文、英文字母、数字、下划线（_）和连接号（-）。长度不可超过128字符。一个中文汉字算2字符。

返回参数

名称 类型 描述
RequestId String 阿里云为该请求生成的唯一标识符。
Success Boolean 表示是否调用成功。true表示调用成功，false表示调用失败。
ErrorMessage String 调用失败时，返回的出错信息。
Code String 调用失败时，返回的错误码。错误码详情，请参见错误码。
InvalidProductTags List<ProductTag> 调用失败时，返回不合法的产品标签列表。

示例

请求示例

https://iot.cn-shanghai.aliyuncs.com/&Action=CreateProductTags
&ProductKey=a1h7knJ****
&ProductTag.1.TagKey=first
&ProductTag.1.TagValue=value1
&ProductTag.2.TagKey=second
&ProductTag.2.TagValue=value2
&公共请求参数

返回示例

  • JSON格式

    {
  "RequestId": "354A4F9B-6B01-4498-8084-867F59720BA5",
  "Success": true
}

  • XML格式

    <CreateProductTagsResponse>
    <RequestId>57b144cf-09fc-4916-a272-a62902d5b207</RequestId>
    <Success>true</Success>
</CreateProductTagsResponse>