调用FindVersionBlackDevices分页获取系统版本或者应用版本的设备黑名单。

调试

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

请求参数

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

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

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 168566700000

创建时间戳
Id Long 123

ID，主键
IdType String hardware_id

设备ID类型，支持：

  • device_id：硬件ID
  • sn：序列号
  • vin：车架号
  • hardware_id：硬件ID
OriginalId String 23452345234523452

源设备ID
TotalCount Integer 25

总共符合条件的设备数
RequestId String 6F25F67C-F411-499F-BCE2-67CA563CB064

请求ID

示例

请求示例


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

正常返回示例

XML 格式 

<FindVersionBlackDevicesResponse>
	  <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>
</FindVersionBlackDevicesResponse>

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
	}
}

错误码

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