实例扩缩容

更新时间：2022-11-17

为指定云数据库 RDS 所用资源扩缩容，目前支持对主实例或只读实例的内存、磁盘、cpu数进行扩缩容操作，支持对代理实例的节点数做扩缩容操作。

说明

实例计费方式采用后付费时，可弹性扩缩容；采用预付费方式，不能进行缩容操作。
只有实例available状态时才可以进行扩缩容操作。
实例扩缩容之后会重启一次。
异步接口，可通过查询实例详情接口查看instanceStatus是否恢复。

请求结构

PUT /v{version}/instance/{instanceId}?resize HTTP/1.1
HOST: rds.bj.baidubce.com
Authorization: authorization string

{
    "cpuCount" 	          : cpuCount,
    "memoryCapacity"      : memoryCapacity,
    "volumeCapacity"      : volumeCapacity,
    "nodeAmount"          : nodeAmount,
    "isDirectPay"         : isDirectPay
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必须	参数位置	描述
version	string	是	URL参数	API 版本号
instanceId	string	是	URL参数	指定实例Id
cpuCount	Int	否	RequestBody参数	cpu核数。取值参考。主实例或只读实例变配时至少填写cpuCount、memoryCapacity、volumeCapacity其中的一个。
memoryCapacity	Int	否	RequestBody参数	内存大小，单位GB。取值参考。主实例或只读实例变配时至少填写cpuCount、memoryCapacity、volumeCapacity其中的一个。
volumeCapacity	Int	否	RequestBody参数	磁盘大小，单位GB，每5G递增。取值参考。主实例或只读实例变配时至少填写cpuCount、memoryCapacity、volumeCapacity其中的一个。
nodeAmount	Int	否	RequestBody参数	代理实例节点数。取值参考。代理实例变配时此项必填。
isDirectPay	Boolean	否	RequestBody参数	是否进行直接支付，默认false，设置为直接支付的变配订单会直接扣款，不需要在走支付逻辑

返回头域

除公共头域，无其它特殊头域。

返回参数

无特殊返回参数

请求示例

PUT /v1/instance/r-mdjei8sh?resize HTTP/1.1
HOST: rds.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-11-21T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
    "cpuCount"	          : 4,
    "memoryCapacity"      : 8,
    "volumeCapacity"      : 40
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
Content-Type: application/json
Content-Length: 0