调用CreateCustomizedFilter给指定版本添加自定义过滤条件，可以通过自定义的方式扩展版本的查询筛选能力。

说明 自定义过滤条件会在设备发起升级查询请求时，根据请求中增加的自定义的参数，按照设定的规则判断设备是否可以查询到该升级版本。设备请求的自定义参数名需和版本配置的自定义过滤条件名一致。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreateCustomizedFilter

系统规定参数。取值：CreateCustomizedFilter。

ProjectId String 是 P0VFCREU

所属项目ID
RegionId String 是 cn-shanghai

地域ID
VersionId String 是 1

所属版本ID
VersionType String 是 FOTA

版本类型。取值：

  • FOTA：系统版本
  • APP：应用版本
Name String 是 AnotherFilter

过滤条件名
ValueType String 是 WRITE

过滤条件值类型。

目前仅支持WRITE，表示手写输入。

ValueCompareType String 是 NUMBER

值的比较类型。取值：

  • NUMBER：按数字比较
  • STRING：按字符串比较
BlackWhiteType String 是 BLACK

比较的黑白名单类型：

  • BLACK：黑名单
  • WHITE：白名单
Value String 是 1,2,3

过滤条件值

返回数据

名称 类型 示例值 描述
RequestId String 6F25F67C-F411-499F-BCE2-67CA563CB064

请求ID
CustomizedFilterId String 1

自定义过滤条件ID

示例

请求示例


http(s)://iovcc.cn-shanghai.aliyuncs.com/?Action=CreateCustomizedFilter
&ProjectId=P0VFCREU
&RegionId=cn-shanghai
&VersionId=1
&VersionType=FOTA
&Name=AnotherFilter
&ValueType=WRITE
&ValueCompareType=NUMBER
&BlackWhiteType=BLACK
&Value=1,2,3
&<公共请求参数>

正常返回示例

XML 格式 

<CreateCustomizedFilterResponse>
	  <CustomizedFilterId>1</CustomizedFilterId>
	  <RequestId>6F25F67C-F411-499F-BCE2-67CA563CB064</RequestId>
</CreateCustomizedFilterResponse>

JSON 格式 

{
	"CustomizedFilterId":"1",
	"RequestId":"6F25F67C-F411-499F-BCE2-67CA563CB064"
}

错误码

访问错误中心查看更多错误码。