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

IoT Platform:CreateThingScript

最終更新日:Apr 17, 2025

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

使用方法

データ解析スクリプトは、デバイスから送信されたデータを JSON 形式に変換するために使用されます。デバイスから送信されるデータはカスタム形式です。 JavaScript、Python 2.7、および PHP 7.2 でスクリプトを作成できます。詳細については、「データ解析用のスクリプトを送信する」をご参照ください。

重要 データ形式が Alink JSON の場合、CreateThingScript 操作はサポートされていません。 Alink JSON は、IoT Connectivity Alliance (ICA)で定義されている標準データ形式です。

QPS 制限

各 Alibaba Cloud アカウントは、最大 10 クエリ/秒(QPS)を実行できます。

説明 Alibaba Cloud アカウントの Resource Access Management (RAM)ユーザーは、アカウントのクォータを共有します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

リクエストパラメータ

パラメータ タイプ 必須 例 説明
Action String Yes CreateThingScript

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

ProductKey String Yes a1Q5XoY****

プロダクトの ProductKey。

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

ScriptContent String Yes "function protocolToRawData(jsonObj) {return rawdata; }function rawDataToProtocol(rawData) {return jsonObj; }"

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

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

ScriptType String Yes JavaScript

スクリプトの言語。有効な値:

  • JavaScript
  • Python_27: Python 2.7
  • PHP_72: PHP 7.2
IotInstanceId String No iot-cn-0pp1n8t****

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

重要
  • インスタンスに ID がある場合は、このパラメータを指定する必要があります。指定しない場合、呼び出しは失敗します。
  • コンソールに [概要] ページが表示されない場合、またはインスタンスの ID が生成されない場合は、このパラメータを指定する必要はありません。

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

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

レスポンスパラメータ

パラメータ タイプ 例 説明
Code String iot.system.SystemException

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

ErrorMessage String A system exception occurred.

リクエストが失敗した場合に返されるエラーメッセージ。

RequestId String BB71E443-4447-4024-A000-EDE09922891E

リクエストの ID。この ID は、このリクエストを一意に識別します。

Success Boolean true

リクエストが成功したかどうかを示します。

  • true: リクエストは成功しました。
  • false: リクエストは失敗しました。

例

リクエストの例

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

成功レスポンスの例

XML 形式

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

JSON 形式

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

エラーコード

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