調(diào)用該接口觸發(fā)孿生體的數(shù)據(jù)映射配置，實(shí)現(xiàn)數(shù)據(jù)到孿生節(jié)點(diǎn)的映射。

使用說(shuō)明

已在孿生空間配置API數(shù)據(jù)源映射。具體操作，請(qǐng)參見配置數(shù)據(jù)源。

QPS限制

單個(gè)阿里云賬號(hào)調(diào)用該接口的每秒請(qǐng)求數(shù)（QPS）最大限制為200。

說(shuō)明 RAM用戶共享阿里云賬號(hào)配額。

調(diào)試

您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。

請(qǐng)求參數(shù)

名稱 類型 是否必選 示例值 描述
Action String 是 ImportDTData

系統(tǒng)規(guī)定參數(shù)。取值：ImportDTData。
DTInstanceId String 是 123*********

孿生空間的ID。
Items.N.DeviceName String 是 Device1

設(shè)備名稱。單次調(diào)用接口下，最多傳入5個(gè)。
Items.N.Params String 是 {"key1":12,"key2":56}

設(shè)備數(shù)據(jù)源，格式為Key:Value的JSON字符串。

單次調(diào)用本接口，最多傳入300個(gè)鍵值對(duì)。
ProductKey String 是 dgb9****

設(shè)備所屬產(chǎn)品的ProductKey。
IotInstanceId String 否 iot-****001

實(shí)例ID。您可在物聯(lián)網(wǎng)平臺(tái)控制臺(tái)的實(shí)例概覽頁(yè)面，查看當(dāng)前實(shí)例的ID。

重要
  • 若有ID值，必須傳入該ID值，否則調(diào)用會(huì)失敗。
  • 若無(wú)實(shí)例概覽頁(yè)面或ID值，則無(wú)需傳入。

實(shí)例的更多信息，請(qǐng)參見實(shí)例概述。

調(diào)用API時(shí)，除了本文介紹的該API的特有請(qǐng)求參數(shù)，還需傳入公共請(qǐng)求參數(shù)。公共請(qǐng)求參數(shù)說(shuō)明，請(qǐng)參見公共參數(shù)文檔。

返回?cái)?shù)據(jù)

名稱 類型 示例值 描述
Code String iot.system.SystemException

調(diào)用失敗時(shí)，返回的錯(cuò)誤碼。更多信息，請(qǐng)參見錯(cuò)誤碼。
ErrorMessage String 系統(tǒng)異常

調(diào)用失敗時(shí)，返回的出錯(cuò)信息。
RequestId String E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

阿里云為該請(qǐng)求生成的唯一標(biāo)識(shí)符。
Success Boolean true

表示是否調(diào)用成功。

  • true：調(diào)用成功。
  • false：調(diào)用失敗。

示例

請(qǐng)求示例

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=ImportDTData
&DTInstanceId=123********
&Items.1.DeviceName=Device1
&Items.1.Params={"key1":12,"key2":56}
&ProductKey=dgb9****
&<公共請(qǐng)求參數(shù)>

正常返回示例

XML格式

<ImportDTDataResponse>
  <RequestId>E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565</RequestId>
  <Success>true</Success>
</ImportDTDataResponse>

JSON格式

{
    "RequestId": "E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565",
    "Success": true
}