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

IoT Platform:GetThingScript

最終更新日: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はいGetThingScript

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

ProductKeyStringはいa1Q5XoY****

プロダクトの ProductKey

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

IotInstanceIdStringいいえiot-cn-0pp1n8t****

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

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

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

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

レスポンスパラメーター

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

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

DataStruct

呼び出しが成功した場合に返されるデータ。

ScriptTypeStringJavaScript

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

  • JavaScript
  • Python_27: Python 2.7
  • PHP_72: PHP 7.2
ScriptUrlStringhttp://***

スクリプトペイロードの URL。

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

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

RequestIdStringBB71E443-4447-4024-A000-EDE09922891E

リクエストの ID。

SuccessBooleantrue

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

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

リクエストの例

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=GetThingScript
&ProductKey=a1Q5XoY****
&<共通リクエストパラメーター>

成功レスポンスの例

XML 形式

<GetThingScriptResponse>
  <Data>
        <ScriptType>JavaScript</ScriptType>
        <ScriptUrl>http://***</ScriptUrl>
  </Data>
  <RequestId>6DDF9D04-24C3-40D8-B490-2A528E59EA67</RequestId>
  <Success>true</Success>
</GetThingScriptResponse>

JSON 形式

{
   "Data": {
        "ScriptType": "JavaScript",
        "ScriptUrl":"http://***"
    },
   "RequestId": "6DDF9D04-24C3-40D8-B490-2A528E59EA67",
   "Success": true
}

エラーコード

エラーコードの一覧については、API エラーセンター をご参照ください。