Tüm Ürünler
Search
Belge Merkezi

IoT Platform:UpdateThingScript

Son Güncelleme:Oct 03, 2026

Belirtilen ürün için veri ayrıştırma betiğini değiştirir.

Kullanım notları

  • Cihazlar veri gönderdikten sonra özel biçimli verileri JSON formatına dönüştürmek için veri ayrıştırma betiği kullanılır. JavaScript, Python 2.7 ve PHP 7.2 dillerinde betik yazabilirsiniz. Daha fazla bilgi için bkz. Veri ayrıştırma için betik gönderme.

  • Her Alibaba Cloud hesabı, saniyede en fazla 10 sorgu (QPS) gerçekleştirebilir.

    Not

    Bir Alibaba Cloud hesabının RAM kullanıcıları, hesabın kotasını paylaşır.

Hata ayıklama

Alibaba Cloud, API kullanımını basitleştirmek için OpenAPI Explorer sunar. OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'ler için örnek kodları dinamik olarak oluşturur.

İstek parametreleri

ParametreTürGerekliÖrnekAçıklama
ActionStringEvetUpdateThingScript

Gerçekleştirmek istediğiniz işlem. Değeri UpdateThingScript olarak ayarlayın.

ProductKeyStringEveta1Q5XoY****

Ürünün ProductKey değeri.

ProductKey değerini IoT Platform konsolundaki Ürün Ayrıntıları sayfasında görüntüleyebilirsiniz. Ayrıca QueryProductList işlemini çağırarak ProductKey değerini alabilirsiniz.

ScriptContentStringEvet"function protocolToRawData(jsonObj) {return rawdata; }function rawDataToProtocol(rawData) {return jsonObj; }"

Betiğin içeriği. Bu parametreyi belirtmeniz gerekir.

Betik örnekleri hakkında daha fazla bilgi için bkz. Veri ayrıştırma nedir.

ScriptTypeStringEvetJavaScript

Betiğin türü. Geçerli değerler:

  • JavaScript
  • Python_27: Python 2.7
  • PHP_72: PHP 7.2
IotInstanceIdStringHayıriot-cn-0pp1n8t****

Örneğin ID değeri. Örnek ID değerini IoT Platform konsolundaki Overview sayfasında görüntüleyebilirsiniz.

Önemli
  • Örneğinizin bir ID'si varsa bu parametreyi yapılandırmanız gerekir. Bu parametreyi ayarlamazsanız çağrı başarısız olur.
  • Örneğinizin Overview sayfası veya ID'si yoksa bu parametreyi ayarlamanız gerekmez.

Daha fazla bilgi için bkz. Overview.

Yukarıdaki iş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 istek parametreleri.

Yanıt parametreleri

ParametreTürÖrnekAçıklama
CodeStringiot.system.SystemException

Çağrı başarısız olursa döndürülen hata kodu. Daha fazla bilgi için bkz. Hata kodları.

ErrorMessageStringA system exception occurred.

Çağrı başarısız olursa döndürülen hata mesajı.

RequestIdStringBB71E443-4447-4024-A000-EDE09922891E

İsteğin ID değeri.

SuccessBooleantrue

Çağrının başarılı olup olmadığını gösterir.

  • true: Çağrı başarılı oldu.
  • false: Çağrı başarısız oldu.

Örnekler

Örnek istekler

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=UpdateThingScript
&ProductKey=a1Q5XoY****
&ScriptContent="function protocolToRawData(jsonObj) {return rawdata; }function rawDataToProtocol(rawData) {return jsonObj; }"
&ScriptType=JavaScript
&<Common request parameters>

Başarılı yanıt örnekleri

XML formatı

<UpdateThingScriptResponse>
    <RequestId>BB71E443-4447-4024-A000-EDE09922891E</RequestId>
    <Success>true</Success>
</UpdateThingScriptResponse>

JSON formatı

{
      "RequestId":"BB71E443-4447-4024-A000-EDE09922891E",
      "Success":true
  }

Hata kodları

Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.