GetThingModelTslPublished - IoT Platform - Alibaba Cloud Dokümantasyon Merkezi

Bir ürünün yayımlanmış Nesne Tanımlama Dili (TSL) modelini sorgular.

Saniye Başına Sorgu (QPS) sınırları

Bu işlemi hesap başına saniyede en fazla 20 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ı açısından bu işlemi OpenAPI Explorer'da çağırmanızı öneririz. OpenAPI Explorer farklı SDK'ler için işlemin örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	GetThingModelTslPublished	Gerçekleştirmek istediğiniz işlem. Değeri GetThingModelTslPublished olarak ayarlayın.
ProductKey	String	Evet	a1BwAGV****	Ürünün ProductKey değeri.
IotInstanceId	String	Hayır	iot-cn-0pp1n8t****	Örnek kimliği. IoT Platform konsolunda Overview sayfasında örnek kimliğini görüntüleyebilirsiniz. Ö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 yalnızca kaynak gruplarına göre örnekleri yönetmenize olanak tanır. ResourceGroupId geçerli değildir. Bu parametreyi belirtmeniz gerekmez.
Simple	Boolean	Hayır	true	Basitleştirilmiş bir TSL modelinin döndürülüp döndürülmeyeceğini belirtir. Geçerli değerler: true: basitleştirilmiş bir TSL modeli döndürür. Basitleştirilmiş TSL modeli yalnızca cihaz özelliklerini, hizmetlerini, olaylarını ve giriş ile çıkış parametrelerinin tanımlayıcısını ve veri türünü tanımlar. Cihaz geliştiricileri referans amaçlı basitleştirilmiş TSL modellerini kullanabilir. false (varsayılan): eksiksiz bir TSL modeli döndürür. Eksiksiz TSL modeli cihaz özelliklerini, hizmetlerini, olaylarını ve tüm parametreleri ile değerleri tanımlar. Bulut uygulaması geliştiricileri referans amaçlı eksiksiz TSL modellerini kullanabilir.
ModelVersion	String	Hayır	v1.0.0	TSL modelinin sürüm numarası. Bir ürün için TSL modelinin sürüm numarasını sorgulamak üzere ListThingModelVersion işlemini çağırabilirsiniz. Bu parametreyi belirtmezseniz son yayımlanan TSL model sürümü kullanı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 kullanılır.

Yukarıdaki işleme özel istek parametrelerine ek olarak bu işlemi çağırırken ortak istek parametrelerini de belirtmeniz gerekir. Ortak istek parametreleri hakkında 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.
TslStr	String	{\"schema\":\"https://iotx-tsl.oss-ap-southeast-1.aliyuncs.com/schema.json\",\"profile\":{\"productKey\":\"a14TeWI****\"},\"properties\":[{\"identifier\":\"Humidity\"}]}	TSL modelinin dizesi.
TslUri	String	https://iotx-pop-dsl.oss-cn-shanghai.aliyuncs.com/thing/a14T/model.json?Expires=1581947119&OSSAccessKeyId=LTAI&Signature=5i38	Object Storage Service (OSS) içinde depolanan TSL verilerinin tek tip kaynak tanımlayıcısı (URI). URI'nin geçerlilik süresi 60 dakikadır.
ErrorMessage	String	A system exception occurred.	İstek başarısız olursa döndürülen hata mesajı.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	İ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=GetThingModelTslPublished
&ProductKey=a1BwAGV****
&<Common request parameters>

Örnek başarılı yanıt

XML biçimi

<GetThingModelTslPublishedResponse>
    <Data>
            <TslUri>https://iotx-pop-dsl.oss-cn-shanghai.aliyuncs.com/thing/a14T******/model.json?Expires=1581947119&OSSAccessKeyId=LTAI****************&Signature=5i38******</TslUri>
            <TslStr>{"schema":"https://iotx-tsl.oss-ap-southeast-1.aliyuncs.com/schema.json","profile":{"productKey":"a14TeWI****"},"properties":[{"identifier":"Humidity","name":"Humidity","accessMode":"rw","required":false,"dataType":{"type":"int","specs":{"min":"55","max":"60","unit":"%","step":"1"}}},{"identifier":"Temperature","name":"Temperature","accessMode":"rw","required":false,"dataType":{"type":"float","specs":{"min":"26","max":"28","unit":"°C","step":"0.01"}}}],"events":[{"identifier":"post","name":"post","type":"info","required":true,"desc":"Submit properties","method":"thing.event.property.post","outputData":[{"identifier":"Humidity","name":"Humidity","dataType":{"type":"int","specs":{"min":"55","max":"60","unit":"%","step":"1"}}},{"identifier":"Temperature","name":"Temperature","dataType":{"type":"float","specs":{"min":"26","max":"28","unit":"°C","step":"0.01"}}}]}],"services":[{"identifier":"set","name":"set","required":true,"callType":"async","desc":"Set properties","method":"thing.service.property.set","inputData":[{"identifier":"Humidity","name":"Humidity","dataType":{"type":"int","specs":{"min":"55","max":"60","unit":"%","step":"1"}}},{"identifier":"Temperature","name":"Temperature","dataType":{"type":"float","specs":{"min":"26","max":"28","unit":"°C","step":"0.01"}}}],"outputData":[]},{"identifier":"get","name":"get","required":true,"callType":"async","desc":"Query properties","method":"thing.service.property.get","inputData":["Humidity","Temperature"],"outputData":[{"identifier":"Humidity","name":"Humidity","dataType":{"type":"int","specs":{"min":"55","max":"60","unit":"%","step":"1"}}},{"identifier":"Temperature","name":"Temperature","dataType":{"type":"float","specs":{"min":"26","max":"28","unit":"°C","step":"0.01"}}}]}]}</TslStr>
    </Data>
    <RequestId>C4371E68-F6DB-4D7B-8AD0-D38336E1DF94</RequestId>
    <Success>true</Success>
</GetThingModelTslPublishedResponse>

JSON biçimi

{
    "Data": {
        "TslUri": "https://iotx-pop-dsl.oss-cn-shanghai.aliyuncs.com/thing/a14T******/model.json?Expires=1581947119&OSSAccessKeyId=LTAI****************&Signature=5i38******",
        "TslStr": "{\"schema\":\"https://iotx-tsl.oss-ap-southeast-1.aliyuncs.com/schema.json\",\"profile\":{\"productKey\":\"a14TeWI****\"},\"properties\":[{\"identifier\":\"Humidity\",\"name\":\"Humidity\",\"accessMode\":\"rw\",\"required\":false,\"dataType\":{\"type\":\"int\",\"specs\":{\"min\":\"55\",\"max\":\"60\",\"unit\":\"%\",\"step\":\"1\"}}},{\"identifier\":\"Temperature\",\"name\":\"Temperature\",\"accessMode\":\"rw\",\"required\":false,\"dataType\":{\"type\":\"float\",\"specs\":{\"min\":\"26\",\"max\":\"28\",\"unit\":\"°C\",\"step\":\"0.01\"}}}],\"events\":[{\"identifier\":\"post\",\"name\":\"post\",\"type\":\"info\",\"required\":true,\"desc\":\"Submit properties\",\"method\":\"thing.event.property.post\",\"outputData\":[{\"identifier\":\"Humidity\",\"name\":\"Humidity\",\"dataType\":{\"type\":\"int\",\"specs\":{\"min\":\"55\",\"max\":\"60\",\"unit\":\"%\",\"step\":\"1\"}}},{\"identifier\":\"Temperature\",\"name\":\"Temperature\",\"dataType\":{\"type\":\"float\",\"specs\":{\"min\":\"26\",\"max\":\"28\",\"unit\":\"°C\",\"step\":\"0.01\"}}}]}],\"services\":[{\"identifier\":\"set\",\"name\":\"set\",\"required\":true,\"callType\":\"async\",\"desc\":\"Set properties\",\"method\":\"thing.service.property.set\",\"inputData\":[{\"identifier\":\"Humidity\",\"name\":\"Humidity\",\"dataType\":{\"type\":\"int\",\"specs\":{\"min\":\"55\",\"max\":\"60\",\"unit\":\"%\",\"step\":\"1\"}}},{\"identifier\":\"Temperature\",\"name\":\"Temperature\",\"dataType\":{\"type\":\"float\",\"specs\":{\"min\":\"26\",\"max\":\"28\",\"unit\":\"°C\",\"step\":\"0.01\"}}}],\"outputData\":[]},{\"identifier\":\"get\",\"name\":\"get\",\"required\":true,\"callType\":\"async\",\"desc\":\"Query properties\",\"method\":\"thing.service.property.get\",\"inputData\":[\"Humidity\",\"Temperature\"],\"outputData\":[{\"identifier\":\"Humidity\",\"name\":\"Humidity\",\"dataType\":{\"type\":\"int\",\"specs\":{\"min\":\"55\",\"max\":\"60\",\"unit\":\"%\",\"step\":\"1\"}}},{\"identifier\":\"Temperature\",\"name\":\"Temperature\",\"dataType\":{\"type\":\"float\",\"specs\":{\"min\":\"26\",\"max\":\"28\",\"unit\":\"°C\",\"step\":\"0.01\"}}}]}]}"
    },
    "RequestId": "C4371E68-F6DB-4D7B-8AD0-D38336E1DF94",
    "Success": true
}

Hata kodları

Hata kodlarının listesi için bkz. Hizmet hata kodları.