调用FindVersionWhiteDevices分页获取系统版本或应用版本的设备白名单

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	FindVersionWhiteDevices	系统规定参数。取值：FindVersionWhiteDevices。
PageIndex	Integer	是	1	分页索引，从1开始。
PageSize	Integer	是	20	分页大小，支持10、20、50三种。
ProjectId	String	是	P0VFCREU	项目ID
RegionId	String	是	cn-shanghai	地域ID
VersionId	String	是	12345	版本ID
VersionType	String	是	FOTA	版本类型。支持： FOTA：系统升级 APP：应用升级
DeviceId	String	否	AS23DG23SA5D43GA34SD23GW456E	设备ID，支持模糊匹配。
OriginalId	String	否	23452345234523452	源设备ID，支持模糊匹配。

返回数据


名称	类型	示例值	描述
DeviceList			设备列表信息
Items			当前分页的设备数据
DeviceId	String	AS23DG23SA5D43GA34SD23GW456E	设备ID
GmtCreate	String	2018-02-14 14:20:18	添加时间
GmtCreateTimestamp	Long	1868400000	创建时间戳
Id	Long	123	白名单ID
IdType	String	hardware_id	设备ID类型，支持： device_id：硬件ID sn：序列号 vin：车架号 hardware_id：硬件ID
OriginalId	String	23452345234523452	源设备ID
TotalCount	Integer	30	总共符合条件的设备数
RequestId	String	6F25F67C-F411-499F-BCE2-67CA563CB064	请求ID

示例

请求示例


http(s)://iovcc.cn-shanghai.aliyuncs.com/?Action=FindVersionWhiteDevices
&PageIndex=1
&PageSize=20
&ProjectId=P0VFCREU
&RegionId=cn-shanghai
&VersionId=12345
&VersionType=FOTA
&<公共请求参数>

正常返回示例

XML 格式

<FindVersionWhiteDevicesResponse>
	  <RequestId>6F25F67C-F411-499F-BCE2-67CA563CB064</RequestId>
	  <DeviceList>
		    <TotalCount>25</TotalCount>
		    <Items>
			      <Id>1</Id>
			      <DeviceId>AS23DG23SA5D43GA34SD23GW456E</DeviceId>
			      <IdType>hardware_id</IdType>
			      <OriginalId>23452345234523452</OriginalId>
			      <GmtCreate>2018-02-14 14:20:18</GmtCreate>
		    </Items>
	  </DeviceList>
</FindVersionWhiteDevicesResponse>

JSON 格式

{
	"RequestId":"6F25F67C-F411-499F-BCE2-67CA563CB064",
	"DeviceList":{
		"Items":[
			{
				"DeviceId":"AS23DG23SA5D43GA34SD23GW456E",
				"IdType":"hardware_id",
				"OriginalId":"23452345234523452",
				"Id":1,
				"GmtCreate":"2018-02-14 14:20:18"
			}
		],
		"TotalCount":25
	}
}

错误码

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