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.
|
PropertyTimestampFilter | Boolean | Yes | Specifies whether to deduplicate messages based on reporting time of the properties.
|
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>