调用GetDeviceSystemUpdateFunnelEvents获取设备系统升级的进度信息。

例如:是否查询到版本,版本下载是否成功,签名校验是否成功,安装是否成功等。

调试

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

请求参数

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

系统规定参数。取值:GetDeviceSystemUpdateFunnelEvents

ProjectId String P0VFCREU

项目ID

RegionId String cn-shanghai

地域ID

IdType String hardware_id

设备ID类型,支持:

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

源设备ID

TargetVersion String 2.0.1-R-20180412.0824

目标系统版本号

返回数据

名称 类型 示例值 描述
EventList

升级进度事件列表信息

DeviceId String AS23DG23SA5D43GA34SD23GW456E

云设备ID

Event String os_download_succ

事件名称

ReportTime String 2018-02-14 14:20:18

事件上报时间

ReportTimestamp Long 167845600000

上报时间戳

TargetVersion String 2.0.1-R-20180412.0824

升级的目标系统版本号

TenantId String P0VFCREU

项目ID

RequestId String 6F25F67C-F411-499F-BCE2-67CA563CB064

请求ID

示例

请求示例


http(s)://iovcc.cn-shanghai.aliyuncs.com/?Action=GetDeviceSystemUpdateFunnelEvents
&ProjectId=P0VFCREU
&RegionId=cn-shanghai
&<公共请求参数>

正常返回示例

XML 格式

<GetDeviceSystemUpdateFunnelEventsResponse>
	  <RequestId>6F25F67C-F411-499F-BCE2-67CA563CB064</RequestId>
	  <EventList>
		    <TotalCount>25</TotalCount>
		    <Items>
			      <TenantId>P0VFCREU</TenantId>
			      <DeviceId>AS23DG23SA5D43GA34SD23GW456E</DeviceId>
			      <TargetVersion>2.0.1-R-20180412.0824</TargetVersion>
			      <Event>os_download_succ</Event>
			      <ReportTime>2018-02-14 14:20:18</ReportTime>
		    </Items>
	  </EventList>
</GetDeviceSystemUpdateFunnelEventsResponse>

JSON 格式

{
	"EventList":{
		"Items":[
			{
				"DeviceId":"AS23DG23SA5D43GA34SD23GW456E",
				"TenantId":"P0VFCREU",
				"Event":"os_download_succ",
				"TargetVersion":"2.0.1-R-20180412.0824",
				"ReportTime":"2018-02-14 14:20:18"
			}
		],
		"TotalCount":25
	},
	"RequestId":"6F25F67C-F411-499F-BCE2-67CA563CB064"
}

错误码

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