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

限制说明

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

请求参数

名称 类型 是否必需 描述
Action String 要执行的操作。取值CreateProductTags
ProductKey String 产品Key,物联网平台为产品颁发的唯一标识。
ProductTags List<ProductTag> 要创建的标签。标签包括TagKey和TagValue,分别对应标签的key和value。请参见下表ProductTag。
说明 新增标签的TagKey不能重复,也不能和已有标签的key重复。
公共参数 - 请参见公共参数
表 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=a1h7knJdld1
&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>