Tüm Ürünler
Search
Belge Merkezi

IoT Platform:QueryThingModelPublished

Son Güncelleme:Oct 03, 2026

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.

Not

Bir Alibaba Cloud hesabının Resource Access Management (RAM) kullanıcıları, hesabın kotasını paylaşır.

Hata ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması için bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlem örnek kodunu dinamik olarak oluşturur.

İ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
  • Örneğinizin bir ID'si varsa bu parametreyi belirtmeniz gerekir. Aksi takdirde istek başarısız olur.

  • IoT Platform konsolunda Overview sayfası veya örnek kimliği görüntülenmiyorsa bu parametreyi belirtmeniz gerekmez.

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:

  • true

  • false

Ö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ı.