功能介绍
切换弹性云服务器操作系统。支持弹性云服务器数据盘不变的情况下，使用新镜像重装系统盘。
本接口为异步接口，当前切换弹性云服务器操作系统请求下发成功后会返回ｊｏｂ＿ｉｄ，此时切换弹性云服务器操作系统并没有立即完成，需要通过调用查询任务的执行状态查询ｊｏｂ状态，当Ｊｏｂ状态为 ＳＵＣＣＥＳＳ 时代表云服务器操作系统切换成功。
调用该接口后，系统将卸载系统盘，然后使用新镜像重新创建系统盘，并挂载至弹性云服务器，实现切换操作系统功能。
接口约束
该接口仅支持安装了Ｃｌｏｕｄ－ｉｎｉｔ或Ｃｌｏｕｄｂａｓｅ－ｉｎｉｔ的镜像。如果镜像未安装Ｃｌｏｕｄ－ｉｎｉｔ或者Ｃｌｏｕｄｂａｓｅ－ｉｎｉｔ，请使用 切换弹性云服务器操作系统（未安装Ｃｌｏｕｄ－ｉｎｉｔ）接口。
不包含系统盘的弹性云服务器不能切换操作系统。
执行切换操作系统任务时，请勿并行执行其他任务，否则可能会引起切换操作系统失败。
调试
您可以在ＡＰＩ Ｅｘｐｌｏｒｅｒ中调试该接口。
ＵＲＩ
ＰＯＳＴ ／ｖ２／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｃｌｏｕｄｓｅｒｖｅｒｓ／｛ｓｅｒｖｅｒ＿ｉｄ｝／ｃｈａｎｇｅｏｓ
参数说明请参见表１。
表１ 参数说明
参数
是否必选
描述
ｐｒｏｊｅｃｔ＿ｉｄ
是
项目ＩＤ。
获取方法请参见获取项目ＩＤ。
ｓｅｒｖｅｒ＿ｉｄ
是
弹性云服务器ＩＤ。
请求消息
请求参数如表２所示。
表２ 请求参数
参数
是否必选
参数类型
描述
ｏｓ－ｃｈａｎｇｅ
是
Ｏｂｊｅｃｔ
切换弹性云服务器操作系统，详情参见表３。
表３ ｏｓ－ｃｈａｎｇｅ字段数据结构说明
参数
是否必选
参数类型
描述
ａｄｍｉｎｐａｓｓ
否
Ｓｔｒｉｎｇ
云服务器管理员账户的初始登录密码。
其中，Ｗｉｎｄｏｗｓ管理员账户的用户名为Ａｄｍｉｎｉｓｔｒａｔｏｒ，Ｌｉｎｕｘ管理员账户的用户名为ｒｏｏｔ。
建议密码复杂度如下：
长度为８－２６位。
密码至少必须包含大写字母、小写字母、数字和特殊字符（！＠＄％＾－＿＝＋［｛｝］：，．／？～＃＊）中的三种。
说明：
Ｗｉｎｄｏｗｓ云服务器的密码，不能包含用户名或用户名的逆序，不能包含用户名中超过两个连续字符的部分。
对于Ｌｉｎｕｘ弹性云服务器也可使用ｕｓｅｒ＿ｄａｔａ字段实现密码注入，此时ａｄｍｉｎｐａｓｓ字段无效。
ａｄｍｉｎｐａｓｓ和ｋｅｙｎａｍｅ不能同时有值。
ａｄｍｉｎｐａｓｓ和ｋｅｙｎａｍｅ如果同时为空，此时，ｌｉｎｕｘ可使用ｍｅｔａｄａｔａ中的ｕｓｅｒ＿ｄａｔａ。
仅在使用私有镜像密码或切换后设置密码的场景，ａｄｍｉｎｐａｓｓ、ｋｅｙｎａｍｅ和ｍｅｔａｄａｔａ中的ｕｓｅｒ＿ｄａｔａ属性值可以同时为空，且有以下约束条件：
Ｗｉｎｄｏｗｓ操作系统不支持使用私有镜像密码。
如需在切换后设置密码，需确保镜像＿＿ｏｓ＿ｆｅａｔｕｒｅ＿ｌｉｓｔ字段必须含有｛＂ｏｎｅｋｅｙ＿ｒｅｓｅｔｐａｓｓｗｄ＂： ＂ｔｒｕｅ＂｝，请在切换后重置云服务器密码。
对于已安装Ｃｌｏｕｄ－ｉｎｉｔ的云服务器，使用ａｄｍｉｎｐａｓｓ字段切换操作系统时，系统如果提示您使用ｋｅｙｐａｉｒ方式切换操作系统，表示当前区域暂不支持使用密码方式。
ｋｅｙｎａｍｅ
否
Ｓｔｒｉｎｇ
密钥名称。
密钥可以通过密钥创建接口进行创建 创建和导入ＳＳＨ密钥（请参见），或使用ＳＳＨ密钥查询接口查询已有的密钥（请参见查询ＳＳＨ密钥列表 ）。
ｕｓｅｒｉｄ
否
Ｓｔｒｉｎｇ
用户ＩＤ。当传入ｋｅｙｎａｍｅ参数时，优先使用本参数设置的ｕｓｅｒｉｄ，若ｕｓｅｒｉｄ为空，默认使用当前ｔｏｋｅｎ中的ｕｓｅｒｉｄ。
查看用户ＩＤ方法：
登录管理控制台。
单击用户名，在下拉列表中单击“我的凭证”。在该页面查看ＩＡＭ用户ＩＤ。
ｉｍａｇｅｉｄ
是
Ｓｔｒｉｎｇ
切换系统所使用的新镜像的ＩＤ，格式为ＵＵＩＤ。
镜像的ＩＤ可以从控制台或者参考《镜像服务ＡＰＩ参考》的“查询镜像列表”的章节获取。
ｉｓＡｕｔｏＰａｙ
否
Ｓｔｒｉｎｇ
下单订购后，是否自动从客户的账户中支付，而不需要客户手动去进行支付。
“ｔｒｕｅ”：是（自动支付）
“ｆａｌｓｅ”：否（需要客户手动支付）
说明：
适用于包年／包月虚拟机费用发生变化时，不传该字段时默认为客户手动支付。
ｍｅｔａｄａｔａ
否
Ｏｂｊｅｃｔ
切换云服务器的元数据。
更多信息，请参见表４。
ｍｏｄｅ
否
Ｓｔｒｉｎｇ
取值为ｗｉｔｈＳｔｏｐＳｅｒｖｅｒ ，支持开机状态下切换弹性云服务器操作系统。
ｍｏｄｅ取值为ｗｉｔｈＳｔｏｐＳｅｒｖｅｒ时，对开机状态的弹性云服务器执行切换操作系统操作，系统自动对云服务器先执行关机，再切换操作系统。
表４ ｍｅｔａｄａｔａ字段数据结构说明
参数
是否必选
参数类型
描述
ｕｓｅｒ＿ｄａｔａ
否
Ｓｔｒｉｎｇ
创建云服务器过程中待注入实例自定义数据。支持注入文本、文本文件。
说明：
ｕｓｅｒ＿ｄａｔａ的值为ｂａｓｅ６４编码之后的内容。
注入内容（编码之前的内容）更大长度为３２Ｋ。
了解更多实例自定义数据注入请参考用户数据注入。
示例：
ｂａｓｅ６４编码前：
Ｌｉｎｕｘ服务器：
＃！／ｂｉｎ／ｂａｓｈ
ｅｃｈｏ ｕｓｅｒ＿ｔｅｓｔ ＞ ／ｈｏｍｅ／ｕｓｅｒ．ｔｘｔ
Ｗｉｎｄｏｗｓ服务器：
ｒｅｍ ｃｍｄ
ｅｃｈｏ １１１ ＞ ｃ：＼ａａａ．ｔｘｔ
ｂａｓｅ６４编码后：
Ｌｉｎｕｘ服务器：
ＩｙＥｖＹｍｌｕＬ２Ｊｈｃ２ｇＫＺＷＮｏｂｙＢ１ｃ２ＶｙＸ３Ｒｌｃ３ＱｇＰｉＡｖａＧ９ｔＺＳ９１ｃ２ＶｙＬｎＲ４ｄＡ＝＝
Ｗｉｎｄｏｗｓ服务器：
ｃｍＶｔＩＧＮｔＺＡｐｌＹ２ｈｖＩＤＥｘＭＳＡ＋ＩＧＭ６ＸＧＦｈＹＳ５０ｅＨＱ＝
＿＿ｓｙｓｔｅｍ＿＿ｅｎｃｒｙｐｔｅｄ
否
Ｓｔｒｉｎｇ
ｍｅｔａｄａｔａ中的表示加密功能的字段，０代表不加密，１代表加密。
该字段不存在时，系统盘默认为不加密。
＿＿ｓｙｓｔｅｍ＿＿ｃｍｋｉｄ
否
Ｓｔｒｉｎｇ
用户主密钥ＩＤ，是ｍｅｔａｄａｔａ中的表示加密功能的字段，与＿＿ｓｙｓｔｅｍ＿＿ｅｎｃｒｙｐｔｅｄ配合使用。
说明：
请参考查询密钥列表，通过ＨＴＴＰＳ请求获取密钥ＩＤ。
响应消息
请参考响应（任务类）。
请求示例
切换云服务器操作系统，切换后采用密码方式登录鉴权，建议将密码在配置文件或者环境变量中密文存放，使用时解密，确保安全。
ＰＯＳＴ ｈｔｔｐｓ：／／｛ｅｎｄｐｏｉｎｔ｝／ｖ２／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｃｌｏｕｄｓｅｒｖｅｒｓ／｛ｓｅｒｖｅｒ＿ｉｄ｝／ｃｈａｎｇｅｏｓ
｛
＂ｏｓ－ｃｈａｎｇｅ＂： ｛
＂ａｄｍｉｎｐａｓｓ＂： ＂＄ＡＤＭＩＮ＿ＰＡＳＳ＂，
＂ｕｓｅｒｉｄ＂： ＂７ｅ２５ｂ１ｄａ３８９ｆ４６９７ａ７９ｄｆ３ａ０ｅ５ｂｄ４９４ｅ＂，
＂ｉｍａｇｅｉｄ＂： ＂ｅ２１５５８０ｆ－７３ａｄ－４２９ｄ－ｂ６ｆ２－５４３３９４７４３３ｂ０＂，
＂ｍｏｄｅ＂： ＂ｗｉｔｈＳｔｏｐＳｅｒｖｅｒ＂
｝
｝
切换云服务器操作系统，切换后采用密钥方式登录鉴权。
ＰＯＳＴ ｈｔｔｐｓ：／／｛ｅｎｄｐｏｉｎｔ｝／ｖ２／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｃｌｏｕｄｓｅｒｖｅｒｓ／｛ｓｅｒｖｅｒ＿ｉｄ｝／ｃｈａｎｇｅｏｓ
｛
＂ｏｓ－ｃｈａｎｇｅ＂： ｛
＂ｋｅｙｎａｍｅ＂： ＂ＫｅｙＰａｉｒ－３５０ｂ＂，
＂ｕｓｅｒｉｄ＂： ＂７ｅ２５ｂ１ｄａ３８９ｆ４６９７ａ７９ｄｆ３ａ０ｅ５ｂｄ４９４ｅ＂，
＂ｉｍａｇｅｉｄ＂： ＂ｅ２１５５８０ｆ－７３ａｄ－４２９ｄ－ｂ６ｆ２－５４３３９４７４３３ｂ０＂
｝
｝
使用系统盘加密的整机镜像切换云服务器的操作系统，切换后使用密码方式登录鉴权，建议将密码在配置文件或者环境变量中密文存放，使用时解密，确保安全。
ＰＯＳＴ ｈｔｔｐｓ：／／｛ｅｎｄｐｏｉｎｔ｝／ｖ２／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｃｌｏｕｄｓｅｒｖｅｒｓ／｛ｓｅｒｖｅｒ＿ｉｄ｝／ｃｈａｎｇｅｏｓ
｛
＂ｏｓ－ｃｈａｎｇｅ＂： ｛
＂ａｄｍｉｎｐａｓｓ＂： ＂＄ＡＤＭＩＮ＿ＰＡＳＳ＂，
＂ｕｓｅｒｉｄ＂： ＂７ｅ２５ｂ１ｄａ３８９ｆ４６９７ａ７９ｄｆ３ａ０ｅ５ｂｄ４９４ｅ＂，
＂ｉｍａｇｅｉｄ＂： ＂ｅ２１５５８０ｆ－７３ａｄ－４２９ｄ－ｂ６ｆ２－５４３３９４７４３３ｂ０＂，
＂ｍｅｔａｄａｔａ＂： ｛
＂＿＿ｓｙｓｔｅｍ＿＿ｅｎｃｒｙｐｔｅｄ＂： ＂１＂，
＂＿＿ｓｙｓｔｅｍ＿＿ｃｍｋｉｄ＂： ＂８３ｃｄｂ５２ｄ－９ｅｂｆ－４４６９－９ｃｆａ－ｅ７ｂ５ｂ８０ｄａ８４６＂
｝
｝
｝
响应示例
请参考响应（任务类）。
｛
＂ｊｏｂ＿ｉｄ＂： ＂ｆｆ８０８０８２８８ｄ４１ｅ１ｂ０１８９９０２６０９５５６８６ａ＂
｝
返回值
请参考通用请求返回值。
错误码
请参考错误码。
华为云共建智能世界云底座[52] 华为公有云专属云主机DeH服务[51] 华为云场景化解决方案[49] 华为公有云产品[44] 华为云云主机[43] 华为云产品服务[43] 华为云服务器应用[43] 华为弹性云服务器[39] 华为公有云架构解决方案[38] 华为云提供的服务[37] 华为虚拟私有云vpc[37] 华为公有云介绍[32] 华为公有云提供哪些计算服务[30] 华为云漏洞扫描[27] 华为云软件开发服务[27] 华为公有云和私有云区别[27] 华为云域名注册[26] 华为云官网登陆[26] 华为公有云解决方案[26] 华为私有云产品有哪些[26] 华为私有云服务[25] 华为云数据库[23] 华为云安全[22] 华为公有云官网[22] 华为私有云的搭建方案[22] 华为云弹性云服务器应用[21] 华为公有云平台[20] 华为公有云行业解决方案[20] 华为私有云解决方案服务定制领导者[20] [19] 华为私有云服务器[19] 华为私有云网格结构[19] 华为公有云视讯解决方案[18] 华为云官网[17] 华为云速建站[17] 华为私有云架构[17] 华为云优势[16] 华为云服务器[16] 华为私有云部署架构[16] 华为云企业邮箱服务 (SAAS[15] 华为云邮箱[15] 华为公有云是什么[15] 华为公有云架构[15] 华为云迁移解决方案[14] 华为公有云解决方案服务定制领导者[14] 华为私有云解决方案[14] 云邮箱）[13] 华为云园区解决方案[13] 华为云服务总代理[13] 华为云速智能客服[13] 华为公有云服务[13] 华为私有云搭建方案[13] 云与计算咨询服务[12] 云与计算培训服务[11] 华为云备份[11] 华为云服务器配置[11] 华为云服务服务中心[11] 华为云服务核心分销商[11] 华为公有云[11] 华为私有云搭建[11] 云迁移与运营支撑服务[10] 公有云私有云混合云[10] 华为云服务器ECS[10] 华为云服务器成功案例[10] 华为云解决方案[10] 华为公有云通用解决方案[9] 华为智慧云课堂解决方案[9] 华为云数据解决方案[8] 华为云是什么[8] 华为私有云平台[8] 云与计算客户支持与运维使能服务[7] 华为云官网网站[7] 华为云智慧教育解决方案[7] 华为云智慧校园解决方案[7] 华为云桌面系统集成商[7] 华为云经销商[7] 华为代理公司有哪些[7] 华为私有云方案[7] 智慧教育云平台解决方案[7] 华为云服务器试用[6] 华为云网站建设服务器[6] 华为手机代理加盟[6] 华为私有云[6] 大数据使能服务[6] 智慧教育云计算解决方案[6] 华为云云主机 [5] 华为云智慧***解决方案[5] 华为云桌面总代理商[5] 云与计算客户支持服务[4] 华为云产品介绍[4] 华为云智慧制造解决方案[4] 华为云场景化解决方案[3] 华为公有云官网[3] 华为公有云通用解决方案[3] 华为弹性云服务器[3] 华为公有云产品 [3] 华为云产品服务[2] 华为云域名注册[2] 华为云数据库[2] 华为云智慧校园解决方案[2] 华为云服务器应用[2] 华为云服务器成功案例[2] 华为云软件开发服务[2] 华为公有云产品[2] 华为公有云介绍[2] 华为公有云和私有云区别[2] 华为公有云服务[2] 华为公有云架构[2] 华为公有云架构解决方案[2] 华为公有云视讯解决方案[2] 华为公有云解决方案[2] 华为私有云产品有哪些[2] 华为私有云服务[2] 华为私有云架构[2] 智慧教育云计算解决方案[2] 云规划设计与实施服务[2] 云邮箱[2] 华为云产品报价[2] 华为公有云通用解决方案 [2] 华为云服务器成功案例[1] 华为云桌面系统集成商[1] 云与计算客户支持与运维使能服务[1] 云迁移与运营支撑服务[1] 云迁移与运营支撑服务 [1] 华为云共建智能世界云底座[1] 华为云备份[1] 华为云安全[1] 华为云官网登陆[1] 华为云弹性云服务器应用[1] 华为云提供的服务[1] 华为云数据解决方案[1] 华为云智慧制造解决方案[1] 华为云服务器[1] 华为云服务核心分销商 [1] 华为云漏洞扫描[1] 华为云迁移解决方案 [1] 华为云速智能客服[1] 华为云邮箱[1] 华为公有云专属云主机DeH服务[1] 华为公有云是什么[1] 华为公有云行业解决方案[1] 华为私有云搭建[1] 华为私有云方案[1] 华为私有云服务.华为公有云专属云主机DeH服务.华为云产品报价[1] 华为私有云的搭建方案[1] 华为私有云网格结构[1] 华为私有云解决方案[1] 华为私有云部署架构[1] 为云产品服务[1] 云与计算咨询服务 [1] 云与计算客户支持与运维使能服务 [1] 云与计算客户支持与运维使能服务 云与计算客户支持服务[1] 华为云是什么 [1] 华为云软件开发服[1] 华为云速智能客服 [1] 华为代理加盟[1] 华为公有云架构解决方案 [1] 华为公有云解决方案服务定制领导者 [1] 华为弹性云[1] 华为弹性云服务器 华为云域名注册 华为云服务器应用[1] 华为私有云搭建 [1] 华为私有云搭建方案 [1] 华为私有云部署架构 [1] 大数据使能服务 [1] 撒[1]
