CreateProductTags - IoT Platform

使用說明

單次調用該介面最多能為指定產品建立10個標籤。
單個產品的標籤總數不超過100個。

重要調用本介面時，必須傳入標籤的TagKey和TagValue，否則調用會失敗。參數值請參見本文請求參數表中描述。

QPS限制

單個阿里雲帳號調用該介面的每秒請求數（QPS）最大限制為500。

說明 RAM使用者共用阿里雲帳號配額。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱	類型	是否必選	樣本值	描述
Action	String	是	CreateProductTags	系統規定參數。取值：CreateProductTags。
ProductKey	String	是	a1BwAGV****	產品的ProductKey。ProductKey是物聯網平台為建立產品頒發的通用唯一識別碼。您可以在物聯網平台控制台或調用介面QueryProductList介面，查看當前帳號下所有產品的資訊。
IotInstanceId	String	否	iot_instc_pu***_c-v64********	執行個體ID。您可在物聯網平台控制台的執行個體概覽頁面，查看當前執行個體的ID。重要若有ID值，必須傳入該ID值，否則調用會失敗。若無執行個體概覽頁面或ID值，則無需傳入。執行個體的更多資訊，請參見執行個體概述。
ProductTag.N.TagKey	String	否	room	產品標籤鍵（Key）。長度不可超過30個字元，可包含英文大小寫字母，數字和半形句號（.）。重要 `abc`為物聯網平台系統保留的標籤Key，即標籤Key不能設定為`abc`。若設定`Key=abc`，使用標籤檢索時會直接被過濾。
ProductTag.N.TagValue	String	否	TagValue	產品標籤值（Value）。長度不可超過128字元，可包含中文、英文字母、數字、底線（_）和短劃線（-）。一個中文漢字算2個字元。

調用API時，除了本文介紹的該API的特有請求參數，還需傳入公用請求參數。公用請求參數說明，請參見公用參數文檔。

返回資料

名稱	類型	樣本值	描述
Code	String	iot.system.SystemException	調用失敗時，返回的錯誤碼。更多資訊，請參見錯誤碼。
ErrorMessage	String	系統異常	調用失敗時，返回的出錯資訊。
InvalidProductTags	Array of ProductTag		調用失敗時，返回不合法的產品標籤列表。
ProductTag
TagKey	String	room	標籤鍵。
TagValue	String	123$	標籤值。
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	阿里雲為該請求產生的唯一識別碼。
Success	Boolean	true	表示是否調用成功。 true：調用成功，表示產品綁定標籤成功。 false：調用失敗，表示產品綁定標籤失敗。

樣本

請求樣本

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
&<公用請求參數>

正常返回樣本

XML格式

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

JSON格式

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。