すべてのプロダクト
Search

このプロダクト

    IoT Platform:UpdateProductFilterConfig

    ドキュメントセンター

    IoT Platform:UpdateProductFilterConfig

    最終更新日:Apr 17, 2025

    プロダクトのデバイスから送信されたプロパティメッセージの重複排除ルールを更新します。呼び出しが成功すると、新しいルールがプロダクトのすべてのデバイスに適用されます。

    メッセージの重複排除ルール

    設定したルールに基づいて、IoT Platform はルールエンジンまたはサーバー側サブスクリプションを使用して、デバイスから送信されたプロパティデータを指定された宛先に転送するかどうかを決定します。

    ルールのトリガー条件は、論理 AND 関係で関連付けられています。たとえば、PropertyValueFilter=true および PropertyTimestampFilter=true 条件を設定した場合、重複メッセージを削除するルールは、両方の条件が満たされた場合にのみトリガーされます。

    制限

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

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

    デバッグ

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

    リクエストパラメーター

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

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

    ProductKeyStringはいa1BwAGV****

    プロダクトの ProductKey。ProductKey は、IoT Platform がプロダクトに発行する GUID です。

    IoT Platform [コンソール] を使用するか、QueryProductList 操作を呼び出して、現在のアカウント内のすべてのプロダクトに関する情報を表示できます。

    PropertyTimestampFilterブール値はいfalse

    各プロパティの送信時刻に基づいてメッセージを重複排除するかどうかを指定します。有効な値：

    • true: タイムスタンプが同じプロパティメッセージを重複排除します。
    • false: タイムスタンプに基づいてメッセージを重複排除しません。
    PropertyValueFilterブール値はいtrue

    各プロパティの値に基づいてメッセージを重複排除するかどうかを指定します。有効な値：

    • true: 同じプロパティ値を持つプロパティメッセージを重複排除します。
    • false: プロパティ値に基づいてメッセージを重複排除しません。
    IotInstanceIdStringいいえiot-cn-0pp1n8t****

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

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

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

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

    レスポンスパラメーター

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

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

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

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

    RequestIdStringE55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

    リクエストの ID。

    Successブール値true

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

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

    例

    リクエストの例

    https://iot.cn-shanghai.aliyuncs.com/?Action=UpdateProductFilterConfig
&ProductKey=a1duisa****
&PropertyValueFilter=true
&PropertyTimestampFilter=true
&<共通リクエストパラメーター>

    成功レスポンスの例

    XML 形式

    <UpdateProductFilterConfigResponse>
  <RequestId>2E19BDAF-0FD0-4608-9F41-82D230CFEE38</RequestId>
  <Success>true</Success>
</UpdateProductFilterConfigResponse>

    JSON 形式

    {
  "RequestId": "2E19BDAF-0FD0-4608-9F41-82D230CFEE38",
  "Success": true
}

    エラーコード

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