CreateThingScript - IoT Platform - Alibaba Cloud ドキュメントセンター

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

使用方法

データ解析スクリプトは、デバイスから送信されたデータを 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 エラーセンターをご覧ください。