调用DiagnosisVersion诊断某特定设备查询不到某特定版本的原因。
通过指定测试的设备和期望设备查询到的升级版本,可以诊断出该版本无法被查询到的原因,如:机型不匹配,版本号较低,不符合版本黑名单规则等。
说明 要求设备已接入CMNS并且已联网。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DiagnosisVersion |
系统规定参数。取值:DiagnosisVersion。 |
DiagnoseStyle | String | 是 | 1 |
诊断类型 |
EndTime | String | 是 | 2019-09-18 14:44 |
待诊断的请求查询时间段结束时间点 |
ProjectId | String | 是 | P0VFCREU |
所属项目ID |
RegionId | String | 是 | cn-shanghai |
地域ID |
VersionType | String | 是 | FOTA |
版本类型,取值有:
|
VersionId | String | 是 | 1 |
版本ID |
IdType | String | 是 | device_id |
用于判断的OriginalId的类型,取值有:device_id, sn, vin, hardware_id, uuid 。 |
OriginalId | String | 是 | b8fe2e24ff2b48e0a3aa4e49809fc1b3 |
对应ID类型的ID值 |
StartTime | String | 否 | 2019-09-18 10:44 |
待诊断的请求查询时间段开始时间点 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 6F25F67C-F411-499F-BCE2-67CA563CB064 |
请求ID |
DiagnosisResult | String | 无效的机型 |
诊断结果 |
示例
请求示例
http(s)://iovcc.cn-shanghai.aliyuncs.com/?Action=DiagnosisVersion
&ProjectId=P0VFCREU
&RegionId=cn-shanghai
&VersionType=FOTA
&VersionId=1
&IdType=device_id
&OriginalId=b8fe2e24ff2b48e0a3aa4e49809fc1b3
&<公共请求参数>
正常返回示例
XML
格式
<DiagnosisVersionResponse>
<RequestId>6F25F67C-F411-499F-BCE2-67CA563CB064</RequestId>
<DiagnosisResult>无效的机型</DiagnosisResult>
</DiagnosisVersionResponse>
JSON
格式
{
"RequestId":"6F25F67C-F411-499F-BCE2-67CA563CB064",
"DiagnosisResult":"无效的机型"
}
错误码
访问错误中心查看更多错误码。