功能介绍
变更云服务器规格。
本接口为异步接口，当前变更弹性云服务器规格请求下发成功后会返回ｊｏｂ＿ｉｄ，此时变更弹性云服务器规格并没有立即完成，需要通过调用查询任务的执行状态查询ｊｏｂ状态，当Ｊｏｂ状态为 ＳＵＣＣＥＳＳ 时代表云服务器规格变更成功。
Ｖ１．１版本变更云服务器规格的接口兼容了Ｖ１版本变更云服务器规格（按需）的功能，同时合入新功能，支持包年／包月的弹性云服务器。
调试
您可以在ＡＰＩ Ｅｘｐｌｏｒｅｒ中调试该接口。
ＵＲＩ
ＰＯＳＴ ／ｖ１．１／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｃｌｏｕｄｓｅｒｖｅｒｓ／｛ｓｅｒｖｅｒ＿ｉｄ｝／ｒｅｓｉｚｅ
表１ 参数说明
参数
是否必选
描述
ｐｒｏｊｅｃｔ＿ｉｄ
是
项目ＩＤ。
获取方法请参见获取项目ＩＤ。
ｓｅｒｖｅｒ＿ｉｄ
是
云服务器ＩＤ。
云服务器的ＩＤ可以从控制台或者参考“查询云服务器列表”的章节获取。
请求消息
表２ 参数说明
名称
是否必选
参数类型
描述
ｒｅｓｉｚｅ
是
Ｏｂｊｅｃｔ
标记为云服务器变更规格操作，详情参见 表３。
ｄｒｙ＿ｒｕｎ
否
Ｂｏｏｌｅａｎ
是否只预检此次请求。
ｔｒｕｅ：发送检查请求，不会变更云服务器规格。检查项包括是否填写了必需参数、请求格式等。
如果检查不通过，则返回对应错误。
如果检查通过，则返回２０２状态码。
ｆａｌｓｅ：发送正常请求，通过检查后并且执行变更云服务器规格请求。
表３ ｒｅｓｉｚｅ数据结构说明
名称
是否必选
参数类型
描述
ｆｌａｖｏｒＲｅｆ
是
Ｓｔｒｉｎｇ
变更后的云服务器规格ＩＤ。
可以通过 查询云服务器规格变更支持列表 接口查询允许变更的规格列表。
说明：
不支持变更至同一规格。
ｄｅｄｉｃａｔｅｄ＿ｈｏｓｔ＿ｉｄ
否
Ｓｔｒｉｎｇ
新专属主机ＩＤ。
仅对于部署在专属主机上的弹性云服务器，该参数必选。
ｅｘｔｅｎｄｐａｒａｍ
否
Ｏｂｊｅｃｔ
变更云服务器扩展信息，详情参见 表４。
ｍｏｄｅ
否
Ｓｔｒｉｎｇ
取值为ｗｉｔｈＳｔｏｐＳｅｒｖｅｒ ，支持开机状态下变更规格。
ｍｏｄｅ取值为ｗｉｔｈＳｔｏｐＳｅｒｖｅｒ时，对开机状态的云服务器执行变更规格操作，系统自动对云服务器先执行关机，再变更规格，变更成功后再执行开机。
ｃｐｕ＿ｏｐｔｉｏｎｓ
否
Ｏｂｊｅｃｔ
自定义ＣＰＵ选项。
详情请参见表５。
表４ ｅｘｔｅｎｄｐａｒａｍ数据结构说明
名称
是否必选
参数类型
描述
ｉｓＡｕｔｏＰａｙ
否
Ｓｔｒｉｎｇ
下单订购后，是否自动从客户的账户中支付，而不需要客户手动去进行支付。
“ｔｒｕｅ”：是（自动支付）
“ｆａｌｓｅ”：否（需要客户手动支付）
说明：
当弹性云服务器是按包年包月计费时生效，该值为空时默认为客户手动支付。
表５ ｃｐｕ＿ｏｐｔｉｏｎｓ数据结构说明
参数
是否必选
参数类型
描述
ｈｗ：ｃｐｕ＿ｔｈｒｅａｄｓ
否
ｉｎｔｅｇｅｒ
用于控制ＣＰＵ是否开启超线程。
取值范围：１，２。
１： 关闭超线程。
２： 打开超线程。
需要同时满足如下条件，才能设置为“关闭超线程”：
只能在实例创建或者ｒｅｓｉｚｅ时指定。
只有目标ｆｌａｖｏｒ的ｅｘｔｒａ＿ｓｐｅｃｓ参数：
存在“ｈｗ：ｃｐｕ＿ｐｏｌｉｃｙ”并取值为“ｄｅｄｉｃａｔｅｄ”。
存在“ｈｗ：ｃｐｕ＿ｔｈｒｅａｄｓ”并取值为“２”。
响应消息
表６ 参数说明
参数
是否必选
参数类型
描述
ｊｏｂ＿ｉｄ
否
Ｓｔｒｉｎｇ
任务ＩＤ，变更按需的弹性云服务器规格时返回该参数。
查询ｊｏｂ状态请参见查询任务的执行状态。
ｏｒｄｅｒ＿ｉｄ
否
Ｓｔｒｉｎｇ
订单号，变更包年包月的弹性云服务器规格时返回该参数。
请求示例
变更专属主机上的云服务器的规格为“ｓ３．ｌａｒｇｅ．２”，自动支付且支持开机状态下变更规格。
ＰＯＳＴ ｈｔｔｐｓ：／／｛ｅｎｄｐｏｉｎｔ｝／ｖ１．１／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｃｌｏｕｄｓｅｒｖｅｒｓ／｛ｓｅｒｖｅｒ＿ｉｄ｝／ｒｅｓｉｚｅ
｛
＂ｒｅｓｉｚｅ＂： ｛
＂ｆｌａｖｏｒＲｅｆ＂： ＂ｓ３．ｌａｒｇｅ．２＂，
＂ｄｅｄｉｃａｔｅｄ＿ｈｏｓｔ＿ｉｄ＂： ＂４５９ａ２ｂ９ｄ－８０４ａ－４７４５－ａｂ１９－ａ１１３ｂｂ１ｂ４ｄｄｃ＂，
＂ｅｘｔｅｎｄｐａｒａｍ＂：｛
＂ｉｓＡｕｔｏＰａｙ＂： ＂ｔｒｕｅ＂
｝，
＂ｍｏｄｅ＂： ＂ｗｉｔｈＳｔｏｐＳｅｒｖｅｒ＂
｝
｝
响应示例
｛
＂ｊｏｂ＿ｉｄ＂： ＂ｆｆ８０８０８２８８ｄ４１ｅ１ｂ０１８９９０２６０９５５６８６ａ＂
｝
或
｛
＂ｏｒｄｅｒ＿ｉｄ＂： ＂ＣＳ１７１１１５２２５７Ｃ６０ＴＬ＂，
＂ｊｏｂ＿ｉｄ＂： ＂ｆｆ８０８０８２８８ｄ４１ｅ１ｂ０１８９９０２６０９５５６８６ａ＂
｝
或
｛
＂ｅｒｒｏｒ＂： ｛
＂ｍｅｓｓａｇｅ＂： ＂ＸＸＸＸ＂，
＂ｃｏｄｅ＂： ＂ＸＸＸ＂
｝
｝
返回值
请参考通用请求返回值。
错误码
请参考错误码。
华为云共建智能世界云底座[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]
