调用CreateOsVersion创建系统升级版本_自动驾驶云开发平台(ACDP)-阿里云帮助中心

说明当用户需要进行FOTA升级（即系统升级）时，需要首先调用此接口创建一个系统版本，然后进行后续的版本测试、灰度、发布。

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	CreateOsVersion	系统规定参数。取值：CreateOsVersion。
RegionId	String	是	cn-shanghai	地域ID
DeviceModelId	String	是	12	设备型号ID
IsForceNightUpgrade	String	是	N	是否强制夜间升级，取值：Y \| N。与强制升级不能同时选择是（Y）。
IsForceUpgrade	String	是	N	是否强制升级，取值：Y \| N。
IsMilestone	String	是	N	是否里程碑，取值：Y \| N。
NightUpgradeDownloadType	String	是	1	夜间升级下载类型。1表示WIFI下下载，2表示任全网下载。
NightUpgradeIsAllowedCancel	String	是	N	夜间升级是否允许取消，取值：Y \| N。
NightUpgradeIsShowTip	String	是	N	夜间升级时是否给出提示框，取值：Y \| N。
ProjectId	String	是	P0VFCREU	项目ID
RomList	String	是	0\|http://www.oss-server.com/file1.zip,2.0.1\|http://www.oss-server.com/file2.zip	升级包列表，包括全量包和增量包，格式为`baseVersion\|romUrl,baseVersion\|romUrl`。其中，baseVersion为基准版本，如果是全量包，则基准版本为0。如果是增量包，则基准版本为基准的系统版本号。
SystemVersion	String	是	2.0.1-R-20180501.1208	系统版本号
EnableMobileDownload	String	是	Y	是否允许移动网络下载升级包，取值：Y \| N。
MaxClientVersion	String	否	1200	允许的OTA SDK的最大版本versioncode
MinClientVersion	String	否	1100	允许的OTA SDK的最小版本versioncode
ReleaseNote	String	否	改用UI用户体验，提升系统稳定性	版本发布说明
Remark	String	否	版本备注信息，终端设备不可见	备注
BlackVersionList	String	否	2.0.1-R-20180501.1208,2.0.1-R-20180501.1209	系统版本黑名单列表，英文逗号隔开。
WhiteVersionList	String	否	2.0.1-R-20180501.1208,2.0.1-R-20180501.1209	系统版本白名单，英文逗号隔开。
MobileDownloadMaxSize	String	否	10	允许移动网络下载的包的最大限制，单位为M，在允许移动网络下载包的情况下，大于该限制的包也不会自动下载。

返回数据


名称	类型	示例值	描述
RequestId	String	6F25F67C-F411-499F-BCE2-67CA563CB064	请求ID
VersionId	String	12345	返回创建的版本的ID

示例

请求示例


http(s)://iovcc.cn-shanghai.aliyuncs.com/?Action=CreateOsVersion
&RegionId=cn-shanghai
&DeviceModelId=12
&IsForceNightUpgrade=N
&IsForceUpgrade=N
&IsMilestone=N
&NightUpgradeDownloadType=1
&NightUpgradeIsAllowedCancel=N
&NightUpgradeIsShowTip=N
&ProjectId=P0VFCREU
&RomList=0|http://www.oss-server.com/file1.zip,2.0.1|http://www.oss-server.com/file2.zip
&SystemVersion=2.0.1-R-20180501.1208
&EnableMobileDownload=Y
&<公共请求参数>

正常返回示例

XML 格式

<CreateOsVersionResponse>
	  <RequestId>6F25F67C-F411-499F-BCE2-67CA563CB064</RequestId>
	  <VersionId>1003</VersionId>
</CreateOsVersionResponse>

JSON 格式

{
	"RequestId":"6F25F67C-F411-499F-BCE2-67CA563CB064",
	"VersionId":1003
}

错误码

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