Imports a TSL model to a specified product.
Limits
Each Alibaba Cloud account can run a maximum of 5 queries per second (QPS).
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | ImportThingModelTsl |
The operation that you want to perform. Set the value to ImportThingModelTsl. |
ProductKey | String | Yes | a1BwAGV**** |
The ProductKey of the product. You can view the ProductKey on the Product Details page of the IoT Platform console. You can also obtain the ProductKey by calling the QueryProductList operation. |
IotInstanceId | String | No | iot_instc_pu****_c*-v64******** |
The ID of the instance. This parameter is not required for public instances. However, the parameter is required for the instances that you have purchased. |
ResourceGroupId | String | No | rg-acfm4l5tcwd**** |
The ID of the resource group. Note You cannot specify this parameter.
|
TslStr | String | No | {"schema":"https://iotx-tsl.oss-ap-southeast-1.aliyuncs.com/schema.json","profile":{"productKey":"a14TeW****"},"properties":[]} |
The TSL model to be edited. The value is a JSON string. The TSL model defines the properties, services, and events of the product. The value of the TslStr parameter must follow the standard TSL data format. For more information, see TSL data format. Note To import a TSL model, you must specify the TslStr parameter.
|
TslUrl | String | No | https://iotx-pop-dsl.oss-cn-shanghai.aliyuncs.com/thing/a14TeWI****/model.json?Expires=1581947119... |
The URI that is used to store the TSL data in Object Storage Service (OSS). Note This parameter does not take effect. To import a TSL model, you must specify the TslStr parameter.
|
In addition to the preceding operation-specific request parameters, you must specify common request parameters when you call this operation. For information about common request parameters, see Common parameters.
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
Code | String | iot.system.SystemException |
The error code returned if the call fails. For more information, see Error codes. |
ErrorMessage | String | A system exception occurred. |
The error message returned if the call fails. |
RequestId | String | E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 |
The ID of the request. |
Success | Boolean | true |
Indicates whether the call was successful.
|
Examples
Sample requests
https://iot.cn-shanghai.aliyuncs.com/?Action=ImportThingModelTsl
&ProductKey=a1lWSUw****
&TslStr={\"profile\":{\"productKey\": \"a1bPo9p****\"},\"services\":[],\"properties\":[],\"events\":[]}
&<Common request parameters>
Sample success responses
XML
format
<ImportThingModelTslResponse>
<RequestId>9E76053E-26ED-4AB4-AE58-8AFC3F1E7E8E</RequestId>
<Success>true</Success>
</ImportThingModelTslResponse>
JSON
format
{
"RequestId": "9E76053E-26ED-4AB4-AE58-8AFC3F1E7E8E",
"Success": true
}
Error codes
For a list of error codes, visit the API Error Center.