修改实例规格

接口说明


本接口用于批量修改实例规格。

使用须知:

  1. 修改实例规格会涉及资源计费,建议您提前了解云服务器 ECS 的计费方式。

  2. 请妥善保管AccessKey,以防通过接口产生不知情订购资费。

注意事项:

  1. 变更实例前若实例未关闭,可通过authStop授权自动关机,若未授权则无法变更。

  2. 弹性裸金属不支持修改实例规格。

  3. 若您想修改宿主机中实例规格,可以通过填写dedicatedHostClusterId修改宿主机集群,但仅支持单台实例修改。

  4. authStop仅在修改非宿主机中实例规格时生效。


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

POST https://ecloud.10086.cn/api/openapi-instance/v4/batch-modify-flavors

请求参数

Body

参数名称
类型
必填
描述
instanceModifyFlavorBatchReq
InstanceModifyFlavorBatchReq
是

instanceModifyFlavorBatchReq

instanceIds
<string> array
是

实例ID。可通过查询实例状态列表接口获取。

flavorName
string
是

规格名称。您可以通过查询实例支持变更的规格列表查看可变更规格。

authStop
boolean
否

是否授权关机。取值范围:

  • true:授权。
  • false:未授权。

默认值:false。

dedicatedHostClusterId
string
否

宿主机集群ID,您可以通过查看专属宿主机集群列表获取信息。

cpuOptions
CpuOptions
否

CPU自定义参数。

threadsPerCore
integer(int32)
否

CPU 线程数,仅部分规格支持,详见支持规格族列表。取值范围:

  • 1: 关闭超线程。
  • 2: 开启超线程。

默认值:2。

topologyType
string
否

CPU拓扑,仅部分规格支持,详见支持规格族列表。取值范围:

  • ContinuousCoreToHTMapping:HT连续模式。
  • DiscreteCoreToHTMapping:HT离散模式,仅当threadsPerCore为2时生效。

请求示例

POST https://ecloud.10086.cn/api/openapi-instance/v4/batch-modify-flavors
{
	"instanceIds":[
		"23b82b50-2488-4fe5-a2b8-0855c6348543"
	],
	"flavorName":"s4.16xlarge.1",
	"authStop":true
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
InstanceFlavorBatchResp«InstanceBatchResult»

请求成功时返回的数据。

batchActionResult
<InstanceBatchResult> array

实例批量操作结果集。

instanceId
string

实例ID。

message
string

操作结果信息,失败时返回错误信息,成功时返回空字符串。

result
boolean

操作是否下发成功。

instanceOrderInfo
InstanceOrderInfo

实例订单信息。

instanceIds
<string> array

主机实例ID集合。

orderExts
<OrderExt> array

订单项ID。

orderExtType
string

订单类型。vm(实例),highPerformance(高性能型系统盘),performanceOptimization(性能优化型系统盘)。

subOrderId
string

订单项ID。

orderId
string

订单ID。

paymentInfo
PaymentInfo

支付信息。

ActivityCode
string

交易代码。

BusiType
string

业务类型。

BusinessChannels
string

移动云全网渠道编码。

CerID
string

证书标识串。

ChargeMoney
string

充值金额。

CustomParam
string

商户自定义参数。

CustomerNumber
string

客户编码。

HomeProv
string

归属省份。

IDType
string

中国移动用户标识类型。

IDValue
string

中国移动用户号码。

NotifyURL
string

订单结果通知URL。

OrderMoney
string

订单总金额。

OrderNo
string

订单号。

Payment
string

用户支付金额。

ProductDesc
string

产品描述。

ProductID
string

产品编号。

ProductName
string

产品名称。

ProductURL
string

商品展示网址。

ReqChannel
string

请求方渠道编码。

ReturnURL
string

支付成功跳转返回页面URL。

SignValue
string

签名值。

TimeoutExpress
string

该笔订单允许的最晚付款时间。

WeiXinAppId
string

微信公众号ID/应用ID。

payLink
string

支付链接,paymentInfo节点下的所有以大写字母开头的参数,即序号为5.3~5.24的参数,用post+form表单的形式跳转到此链接。

procedureCode
enum(PREPAID,INTERNALAPPROVAL,POSTPAID)

付费类型。

resourceRemind
string

资源波动提示。

result
boolean

实例批量操作校验结果,true表示校验通过,实例订单信息在instanceOrderInfo中返回;false表示校验失败,失败原因在batchActionResult中返回。

errorCode
string

统一错误码。

errorMessage
string

页面国际化错误提示。

errorParams
<string> array

统一错误码的自定义参数。

requestId
string

每个请求的序列号。

state
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)

返回状态码。返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN。

返回示例

返回码:200
OK
{
	"requestId":"reqId-121b6e5efefb41c09afffe816d1fb63c",
	"state":"OK",
	"body":{
		"result":true,
		"batchActionResult":null,
		"instanceOrderInfo":{
			"procedureCode":"POSTPAID",
			"orderId":"MOP-O-25101500838426",
			"orderExts":[
				{
					"subOrderId":"MOP-T-25101504811096",
					"orderExtType":"vm"
				}
			]
		}
	}
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。