Belirtilen bir ürünün yayınlanan Nesne Tanımlama Dili (TSL) modelindeki özellik tanımlarını sorgular.
QPS sınırları
Bu işlemi hesap başına saniyede en fazla 10 kez çağırabilirsiniz.
Bir Alibaba Cloud hesabının Resource Access Management (RAM) kullanıcıları, hesabın kotasını paylaşır.
Hata ayıklama
İstek parametreleri
|
Parametre |
Tür |
Zorunlu |
Örnek |
Açıklama |
|
Action |
String |
Evet |
QueryThingModelPublished |
Gerçekleştirmek istediğiniz işlem. Değeri QueryThingModelPublished olarak ayarlayın. |
|
ProductKey |
String |
Evet |
a1BwAGV**** |
Ürünün ProductKey değeri. |
|
IotInstanceId |
String |
Hayır |
iot-cn-0pp1n8t**** |
Örnek kimliği. Örnek kimliğini IoT Platform konsolundaki Overview sayfasında bulabilirsiniz. Önemli
Daha fazla bilgi için bkz. Overview. |
|
ResourceGroupId |
String |
Hayır |
rg-acfm4l5tcwd*** |
Kaynak grubu kimliği. Önemli
IoT Platform, kaynak yönetimini yalnızca örnek düzeyinde destekler. Bu istekte ResourceGroupId etkili değildir. Bu parametreyi belirtmeniz gerekmez. |
|
ModelVersion |
String |
Hayır |
v1.0.0 |
TSL modelinin sürüm numarası. Bir ürünün TSL modelinin sürüm numarasını görüntülemek için ListThingModelVersion işlemini çağırabilirsiniz. Bu parametreyi belirtmezseniz TSL modelinin en son yayınlanan sürümü döndürülür. |
|
FunctionBlockId |
String |
Hayır |
BatteryModule |
Özel TSL modülünün tanımlayıcısı. Her tanımlayıcı bir ürün içinde benzersizdir. Bu parametreyi belirtmezseniz varsayılan modül sorgulanır. |
İşleme özel istek parametrelerine ek olarak bu işlemi çağırırken ortak istek parametrelerini de belirtmeniz gerekir. Daha fazla bilgi için bkz. Ortak parametreler.
Yanıt parametreleri
|
Parametre |
Tür |
Örnek |
Açıklama |
|
Code |
String |
iot.system.SystemException |
İstek başarısız olursa döndürülen hata kodu. Daha fazla bilgi için bkz. Hata kodları. |
|
Data |
Struct |
Döndürülen veriler. |
|
|
ThingModelJson |
String |
{\"_ppk\":{\"version\":\"1594253010934\"},\"events\":[],\"productKey\":\"a1BwAGV****\",\"properties\":[{\"configCode\":\"8C03F0EEC63D4897BF2637F89AE36B011594227294067\",\"custom\":true,\"customFlag\":true,\"dataSpecs\":{\"custom\":true,\"dataType\":\"INT\",\"max\":\"1\",\"min\":\"0\",\"step\":\"1\",\"unit\":\"ppb\"},\"dataType\":\"INT\",\"description\":\"1\",\"extendConfig\":\"{\\\"originalDataType\\\":{\\\"specs\\\":{\\\"registerCount\\\":1,\\\"reverseRegister\\\":0,\\\"swap16\\\":0},\\\"type\\\":\\\"bool\\\"},\\\"identifier\\\":\\\"WakeUpData\\\",\\\"registerAddress\\\":\\\"0x04\\\",\\\"scaling\\\":1,\\\"writeFunctionCode\\\":0,\\\"operateType\\\":\\\"inputStatus\\\",\\\"pollingTime\\\":1000,\\\"trigger\\\":1}\",\"identifier\":\"WakeUpData\",\"name\":\"WakeUp_Data\",\"productKey\":\"a114xeJGj2p\",\"required\":false,\"rwFlag\":\"READ_ONLY\",\"std\":false}],\"services\":[]} |
TSL modelindeki özellik tanımları. ThingModelJson veri biçimi hakkında daha fazla bilgi için bkz. ThingModelJson veri yapısı. |
|
ErrorMessage |
String |
A system exception occurred. |
İstek başarısız olursa döndürülen hata iletisi. |
|
ProductKey |
String |
a1BwAGV**** |
Ürünün ProductKey değeri. |
|
RequestId |
String |
E4C0FF92-2A86-41DB-92D3-73B60310D25E |
İstek kimliği. |
|
Success |
Boolean |
true |
İsteğin başarılı olup olmadığını gösterir. Geçerli değerler:
|
Örnekler
Örnek istekler
https://iot.cn-shanghai.aliyuncs.com/?Action=QueryThingModelPublished
&ProductKey=a1BwAGV****
&<Common request parameters>
Başarılı yanıt örnekleri
XML biçimi
<QueryThingModelPublishedResponse>
<RequestId>1F9041A2-ED5B-4A5A-9C44-598E28C0B434</RequestId>
<Data>
<ThingModelJson>{"_ppk":{"version":"1594253010934"},"events":[],"productKey":"a1BwAGV****","properties":[{"configCode":"8C03F0EEC63D4897BF2637F89AE36B011594227294067","custom":true,"customFlag":true,"dataSpecs":{"custom":true,"dataType":"INT","max":"1","min":"0","step":"1","unit":"ppb"},"dataType":"INT","description":"1","extendConfig":"{\"originalDataType\":{\"specs\":{\"registerCount\":1,\"reverseRegister\":0,\"swap16\":0},\"type\":\"bool\"},\"identifier\":\"WakeUpData\",\"registerAddress\":\"0x04\",\"scaling\":1,\"writeFunctionCode\":0,\"operateType\":\"inputStatus\",\"pollingTime\":1000,\"trigger\":1}","identifier":"WakeUpData","name":"WakeUp_Data","productKey":"a114xeJ****","required":false,"rwFlag":"READ_ONLY","std":false}],"services":[]}</ThingModelJson>
</Data>
<Success>true</Success>
</QueryThingModelPublishedResponse>
JSON biçimi
{
"RequestId": "1F9041A2-ED5B-4A5A-9C44-598E28C0B434",
"Data": {
"ThingModelJson": "{\"_ppk\":{\"version\":\"1594253010934\"},\"events\":[],\"productKey\":\"a1BwAGV****\",\"properties\":[{\"configCode\":\"8C03F0EEC63D4897BF2637F89AE36B011594227294067\",\"custom\":true,\"customFlag\":true,\"dataSpecs\":{\"custom\":true,\"dataType\":\"INT\",\"max\":\"1\",\"min\":\"0\",\"step\":\"1\",\"unit\":\"ppb\"},\"dataType\":\"INT\",\"description\":\"1\",\"extendConfig\":\"{\\\"originalDataType\\\":{\\\"specs\\\":{\\\"registerCount\\\":1,\\\"reverseRegister\\\":0,\\\"swap16\\\":0},\\\"type\\\":\\\"bool\\\"},\\\"identifier\\\":\\\"WakeUpData\\\",\\\"registerAddress\\\":\\\"0x04\\\",\\\"scaling\\\":1,\\\"writeFunctionCode\\\":0,\\\"operateType\\\":\\\"inputStatus\\\",\\\"pollingTime\\\":1000,\\\"trigger\\\":1}\",\"identifier\":\"WakeUpData\",\"name\":\"WakeUp_Data\",\"productKey\":\"a114xeJGj2p\",\"required\":false,\"rwFlag\":\"READ_ONLY\",\"std\":false}],\"services\":[]}"
},
"Success": true
}
Hata kodları
Hata kodlarının listesi için bkz. Hizmet hata kodları.