变更计算增强型云电脑规格v3
更新时间 2025-12-29 10:26:31
最近更新时间: 2025-12-29 10:26:31
接口功能介绍
- 适用于计费方式为单独付费云电脑、资源包的计算增强型云电脑（单独付费云电脑每次最多同时变更1个）。- 每次变更，云电脑的系统类型、规格类型、处理器类型（XC型）必须相同。- 新旧规格适用的系统类型、规格类型、处理器类型（XC型）必须相同。- GPU云电脑、XC云电脑每次最多同时变更1个。- 计算增强型云电脑功能请联系客户经理开通。
接口约束
无
URI
POST /v3/ecs/batch/modifySpec
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池ID。 | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| desktopOidList | 是 | Array of Strings | 云电脑列表，可设置一个或多个，最多 10 个（单独付费云电脑仅可设置一个）。 | ||
| templateOid | 是 | String | 规格模板ID | ||
| autoPay | 否 | Boolean | 是否自动支付（仅创建单独付费云电脑有效），默认false。取值范围： - true:是。（仅订购类型为包周期类型有效，需账号有足够金额） - false:否。（仅订购类型为包周期类型有效） |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 状态码。可能值： - 800：请求成功。 - 900：请求失败。 | 800 | |
| error | String | 错误码。 | ECPC_1000 | |
| message | String | 提示信息。 | OK. | |
| returnObj | Object | 返回数据结构体。 | returnObj | |
| 表 returnObj |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| newOrderNo | String | 订单号（仅创建单独付费云电脑有效）。 | ||
| newOrderId | String | 订单id（仅创建单独付费云电脑有效）。 | ||
| totalPrice | String | 总价格（仅创建单独付费云电脑有效）。 |
枚举参数
无
请求示例
请求url
https://{host}?regionId=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
请求头header
无
请求体body
{
"desktopOidList":["XXXXXXXXXXXXX6925"],
"templateOid":"dft-xxx",
"autoPay":true
}
响应示例
{
"statusCode":800,
"message":"OK.",
"returnObj":{
"newOrderNo":20250718141255003733,
"newOrderId":"29471d1d08694681ad87ebf95e29e71a",
"totalPrice":95.1
}
}
状态码
请参考 状态码
错误码
请参考 错误码
