You can call this operation to update the deduplication rule for property messages that are reported by devices of a specified product. If the call is successful, the new rule are immediately applied to all devices of the product.

Message deduplication rules

Based on the rules you set, IoT Platform determines whether to use the rule engine to forward data from devices to a specified destination.

The triggering conditions of a rule are related by the logic AND relation. For example, if you set PropertyValueFilter=true and PropertyTimestampFilter=true, the rule to remove duplicate messages is triggered only when both of the conditions are met.

Limits

The maximum number of queries per second (QPS) for a single Alibaba Cloud account to call this operation is 5. The quota is shared between the Alibaba Cloud account and RAM users.

Request parameters

Parameter Type Required Description
Action String Yes The operation that you want to perform. Set the value to UpdateProductFilterConfig.
ProductKey String Yes The key of the product to which the devices belong. It is a unique identifier that is allocated by IoT Platform for the product.
PropertyValueFilter Boolean Yes Specifies whether to deduplicate messages based on property values.
  • true: deduplicates messages reported by the device with the same property values.
  • false: does not deduplicate messages based on property values.
PropertyTimestampFilter Boolean Yes Specifies whether to deduplicate messages based on reporting time of the properties.
  • true: deduplicate property messages with the same timestamps.
  • false: does not deduplicate messages based on timestamps.
IotInstanceId String No The ID of the instance. This parameter is not required for public instances. However, the parameter is required for the instances that you have purchased.
Common request parameters N/A Yes For information about common request parameters, see Common parameters.

Response parameters

Parameter Type Description
RequestId String The globally unique ID that is generated by Alibaba Cloud for the request.
Success Boolean Indicates whether the call was successful. true indicates that the call was successful. false indicates that the call failed.
ErrorMessage String The error message returned if the call fails.
Code String The error code returned if the call fails. For more information about error codes, see Error codes.

Examples

Sample requests

https://iot.cn-shanghai.aliyuncs.com/?Action=UpdateProductFilterConfig
&ProductKey=a1duisa****
&PropertyValueFilter=true
&PropertyTimestampFilter=true
&Common request parameters

Sample success responses

  • JSON format 
    {
  "RequestId": "2E19BDAF-0FD0-4608-9F41-82D230CFEE38",
  "Success": true
}
  • XML format 
    <? xml version="1.0" encoding="UTF-8"? >
<UpdateProductFilterConfigResponse>
      <RequestId>C4FDA54C-4201-487F-92E9-022F42387458</RequestId>
      <Success>true</Success>
</UpdateProductFilterConfigResponse>