接口说明
本接口用于批量修改实例规格。
使用须知:
-
修改实例规格会涉及资源计费,建议您提前了解云服务器 ECS 的计费方式。
-
请妥善保管AccessKey,以防通过接口产生不知情订购资费。
注意事项:
-
变更实例前若实例未关闭,可通过authStop授权自动关机,若未授权则无法变更。
-
弹性裸金属不支持修改实例规格。
-
若您想修改宿主机中实例规格,可以通过填写dedicatedHostClusterId修改宿主机集群,但仅支持单台实例修改。
-
authStop仅在修改非宿主机中实例规格时生效。
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
|
否
|
是否授权关机。取值范围:
默认值:false。 |
|
dedicatedHostClusterId
|
string
|
否
|
宿主机集群ID,您可以通过查看专属宿主机集群列表获取信息。 |
|
cpuOptions
|
CpuOptions
|
否
|
CPU自定义参数。 |
|
threadsPerCore
|
integer(int32)
|
否
|
|
|
topologyType
|
string
|
否
|
CPU拓扑,仅部分规格支持,详见支持规格族列表。取值范围:
|
请求示例
POST https://ecloud.10086.cn/api/openapi-instance/v4/batch-modify-flavors
{
"instanceIds":[
"23b82b50-2488-4fe5-a2b8-0855c6348543"
],
"flavorName":"s4.16xlarge.1",
"authStop":true
}
返回参数
|
参数名称
|
类型
|
描述
|
|
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。 |
返回示例
{
"requestId":"reqId-121b6e5efefb41c09afffe816d1fb63c",
"state":"OK",
"body":{
"result":true,
"batchActionResult":null,
"instanceOrderInfo":{
"procedureCode":"POSTPAID",
"orderId":"MOP-O-25101500838426",
"orderExts":[
{
"subOrderId":"MOP-T-25101504811096",
"orderExtType":"vm"
}
]
}
}
}