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

外部データレコードを IoT Platform にインポートします。AddDataForApiSource 操作を呼び出すことによって IoT Platform にインポートされたデータは、API データソースのデータと呼ばれます。オンプレミスサーバーまたは他のプラットフォームから IoT Platform にデータをインポートして、データ分析と処理を行うことができます。

QPS 制限

この API 操作は、アカウントごとに 1 秒あたり最大 5 回呼び出すことができます。

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

デバッグ

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

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
Action	String	Yes	AddDataForApiSource	実行する操作。値を AddDataForApiSource に設定します。
ApiId	String	Yes	cxatswiniekxw***	API データソースの ID。
Content	String	Yes	{"key":"value","ts":16376582*****}	IoT Platform にインポートするデータレコードの詳細。値は JSON オブジェクトです。オブジェクトには、データレコードが生成された時刻を指定する ts フィールドを含める必要があります。値はミリ秒単位の精度の UNIX タイムスタンプです。
IotInstanceId	String	Yes	iot-0pp1n*****	インスタンスの ID。インスタンスの ID は、IoT Platform コンソールの概要ページで確認できます。重要インスタンスに ID がある場合は、このパラメーターに ID を指定する必要があります。指定しないと、呼び出しは失敗します。インスタンスに概要ページまたは ID が生成されていない場合は、このパラメーターを設定する必要はありません。詳細については、「概要」をご参照ください。

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

レスポンスパラメーター

パラメーター	タイプ	例	説明
Code	String	200	状態コード 200 は、リクエストが成功したことを示します。その他のコード：呼び出しが失敗しました。エラーコードの詳細については、「エラーコード」をご参照ください。
Data	Long	1234567890	データの ID。
ErrorMessage	String	A system exception occurred.	呼び出しが失敗した場合に返されるエラーメッセージ。
RequestId	String	BB71E443-4447-4024-A000-EDE09934561E	リクエストの ID。
Success	Boolean	true	呼び出しが成功したかどうかを示します。有効な値： true：呼び出しは成功しました。 false：呼び出しは失敗しました。

例

リクエストの例

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=AddDataForApiSource
&ApiId=cxatswiniekxw***
&Content={"key":"value","ts":16376582*****}
&IotInstanceId=iot-0pp1n*****
&<共通リクエストパラメーター>

成功レスポンスの例

XML 形式

<AddDataForApiSourceResponse>
  <RequestId>BB71E443-4447-4024-A000-EDE09934561E</RequestId>
  <Data>1234567890</Data>
  <Code>200</Code>
  <Success>true</Success>
</AddDataForApiSourceResponse>

JSON 形式

{
    "RequestId": "BB71E443-4447-4024-A000-EDE09934561E",
    "Data": 1234567890,
    "Code": 200,
    "Success": true
}

エラーコード

エラーコードのリストについては、「サービスエラーコード」をご参照ください。