すべてのプロダクト
Search
ドキュメントセンター

IoT Platform:UpdateThingScript

最終更新日:Apr 17, 2025

指定されたプロダクトのデータ解析スクリプトを変更します。

使用方法

  • データ解析スクリプトは、デバイスからデータが送信された後、カスタム形式のデータを JSON データに変換するために使用されます。 JavaScript、Python 2.7、および PHP 7.2 でスクリプトを作成できます。 詳細については、「データ解析用のスクリプトを送信する」をご参照ください。
  • 各 Alibaba Cloud アカウントは、最大 10 クエリ/秒 (QPS) を実行できます。
    説明 Alibaba Cloud アカウントの RAM ユーザーは、アカウントのクォータを共有します。

デバッグ

Alibaba Cloud は、API の使用を簡素化するために OpenAPI Explorer を提供しています。 OpenAPI Explorer は、署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK 用の操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメータータイプ必須説明
ActionStringはいUpdateThingScript

実行する操作。値を UpdateThingScript に設定します。

ProductKeyStringはいa1Q5XoY****

プロダクトの ProductKey

ProductKey は、IoT Platform コンソールの [プロダクトの詳細] ページで確認できます。 QueryProductList 操作を呼び出すことによっても ProductKey を取得できます。

ScriptContentStringはい"function protocolToRawData(jsonObj) {return rawdata; }function rawDataToProtocol(rawData) {return jsonObj; }"

スクリプトの内容。このパラメーターを指定する必要があります。

スクリプトの例については、「データ解析とは」をご参照ください。

ScriptTypeStringはいJavaScript

スクリプトのタイプ。有効な値:

  • JavaScript
  • Python_27: Python 2.7
  • PHP_72: PHP 7.2
IotInstanceIdStringいいえiot-cn-0pp1n8t****

インスタンスの ID。インスタンス ID は、IoT Platform コンソールの 概要 ページで確認できます。

重要
  • インスタンスに ID がある場合は、このパラメーターを設定する必要があります。このパラメーターを設定しないと、呼び出しは失敗します。
  • インスタンスに 概要 ページまたは ID がない場合は、このパラメーターを設定する必要はありません。

詳細については、「概要」をご参照ください。

上記の操作固有のリクエストパラメーターに加えて、この操作を呼び出すときは、共通のリクエストパラメーターを指定する必要があります。 詳細については、「共通リクエストパラメーター」をご参照ください。

レスポンスパラメーター

パラメータータイプ説明
CodeStringiot.system.SystemException

呼び出しが失敗した場合に返されるエラーコード。 詳細については、「エラーコード」をご参照ください。

ErrorMessageStringシステム例外が発生しました。

呼び出しが失敗した場合に返されるエラーメッセージ。

RequestIdStringBB71E443-4447-4024-A000-EDE09922891E

リクエストの ID。

SuccessBooleantrue

呼び出しが成功したかどうかを示します。

  • true: 呼び出しは成功しました。
  • false: 呼び出しは失敗しました。

リクエストの例

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=UpdateThingScript
&ProductKey=a1Q5XoY****
&ScriptContent="function protocolToRawData(jsonObj) {return rawdata; }function rawDataToProtocol(rawData) {return jsonObj; }"
&ScriptType=JavaScript
&<共通リクエストパラメーター>

成功レスポンスの例

XML 形式

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

JSON 形式

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

エラーコード

エラーコードのリストについては、API エラーセンター をご覧ください。