调用FindOsVersions分页获取系统版本列表。
说明 此接口支持多种查询条件,如机型、系统版本号等。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | FindOsVersions |
系统规定参数。取值:FindOsVersions。 |
ProjectId | String | 是 | P0VFCREU |
项目ID |
RegionId | String | 是 | cn-shanghai |
地域ID |
PageIndex | Integer | 是 | 1 |
分页索引,表示要获取第几页的数据,第一页从1开始。 |
PageSize | Integer | 是 | 20 |
每页大小,允许20、50、100三个选择。 |
VersionId | String | 否 | 1205 |
版本ID |
SystemVersion | String | 否 | 2.0.1-R-20180402.1208 |
系统版本号 |
Status | String | 否 | TESTING |
版本状态,如:TESTING,TEST_PASSED,PREPUBLISH,PUBLISHED。 |
DeviceModelId | String | 否 | 123 |
设备型号(机型)ID |
IsMilestone | String | 否 | N |
是否里程碑,Y或N。 |
Remark | String | 否 | 备注 |
版本备注 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 6F25F67C-F411-499F-BCE2-67CA563CB064 |
请求ID |
OsVersionList |
版本列表信息,包括当前页的版本列表以及总共符合条件的版本个数 |
||
Items |
符合条件的当前页的版本列表 |
||
DeviceModelId | String | 123 |
设备型号ID |
DeviceModelName | String | DM1 |
机型名 |
GmtCreate | String | 2018-04-24 12:23:45 |
版本创建时间 |
GmtCreateTimestamp | Long | 16754300000 |
版本创建时间戳 |
GmtModify | String | 2018-04-24 12:23:45 |
版本更新时间 |
GmtModifyTimestamp | Long | 16754300000 |
版本更新时间戳 |
Id | Long | 12004 |
版本ID |
IsForceNightUpgrade | String | N |
是否夜间强制升级 |
IsForceReboot | String | N |
是否强制重启 |
IsForceUpgrade | String | N |
是否强制升级 |
IsMilestone | String | Y |
是否里程碑 |
IsSilentUpgrade | String | N |
是否静默升级 |
Remark | String | 测试 |
版本备注 |
Status | String | PUBLISHED |
版本状态 |
StatusName | String | 已发布 |
状态名 |
SystemVersion | String | 2.0.1-R-20180506.0824 |
系统版本号 |
TotalCount | Integer | 1000 |
符合条件的总记录数,方便调用方计算总页数 |
示例
请求示例
http(s)://iovcc.cn-shanghai.aliyuncs.com/?Action=FindOsVersions
&ProjectId=P0VFCREU
&RegionId=cn-shanghai
&PageIndex=1
&PageSize=20
&<公共请求参数>
正常返回示例
XML
格式
<FindOsVersionsResponse>
<OsVersionList>
<Items>
<DeviceModelId>100</DeviceModelId>
<DeviceModelName>DM1</DeviceModelName>
<GmtCreate>2017-12-06 12:04:08</GmtCreate>
<GmtModify>2017-12-06 13:04:06</GmtModify>
<Id>123</Id>
<IsForceNightUpgrade>Y</IsForceNightUpgrade>
<IsForceReboot>N</IsForceReboot>
<IsForceUpgrade>N</IsForceUpgrade>
<IsMilestone>N</IsMilestone>
<IsSilentUpgrade>N</IsSilentUpgrade>
<Remark>测试</Remark>
<Status>PUBLISHED</Status>
<StatusName>已发布</StatusName>
<SystemVersion>2.0.1-R-20180502.1208</SystemVersion>
</Items>
<TotalCount>1000</TotalCount>
</OsVersionList>
<RequestId>6F25F67C-F411-499F-BCE2-67CA563CB064</RequestId>
</FindOsVersionsResponse>
JSON
格式
{
"RequestId":"6F25F67C-F411-499F-BCE2-67CA563CB064",
"OsVersionList":{
"Items":[
{
"IsForceUpgrade":"N",
"DeviceModelName":"DM1",
"IsSilentUpgrade":"N",
"DeviceModelId":100,
"GmtCreate":"2017-12-06 12:04:08",
"IsMilestone":"N",
"Status":"PUBLISHED",
"IsForceNightUpgrade":"Y",
"SystemVersion":"2.0.1-R-20180502.1208",
"StatusName":"已发布",
"Id":123,
"Remark":"测试",
"GmtModify":"2017-12-06 13:04:06",
"IsForceReboot":"N"
}
],
"TotalCount":1000
}
}
错误码
访问错误中心查看更多错误码。