变配实例

更新时间：2023-08-22

接口说明

变配实例，针对PG的主实例且存在只读实例，则要求主实例磁盘小于等于只读磁盘，而PG双机主实例存储降配时，目标存储size必须小于等于集群内的只读实例存储size。

请求结构

PUT /v{version}/instance/{instanceId}?resize HTTP/1.1
HOST: rds.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-11-21T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
    "cpuCount": cpuCount,
    "memoryCapacity": memoryCapacity,
    "volumeCapacity": volumeCapacity,
    "allocatedMemoryInMB":allocatedMemoryInMB
    "nodeAmount": nodeAmount,
    "isDirectPay": false,
    "isEnhanced": false,
    "effectiveTime": "immediate",
    "masterAzone": "masterAzone",
    "backupAzone": "backupAzone",
    "diskIoType": "cloud_enha",
    "subnetId":null,
    "edgeSubnetId":edgeSubnetId,
    "subnets" : [
        {
            "zoneName" : zoneName,
            "subnetId" : subnetId
        },
        {
            "zoneName" : zoneName,
            "subnetId" : subnetId
        }
    ]
    
}

请求头域

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

请求参数

参数名称	参数类型	是否必选	参数位置	描述
version	Integer	是	URL参数	API版本号
instanceId	String	是	URL参数	实例ID
cpuCount	Integer	是	RequestBody参数	CPU核数，最小值是1
memoryCapacity	Integer	是	RequestBody参数	内存大小，单位GB。最小值为1
volumeCapacity	Integer	是	RequestBody参数	存储大小，单位GB。最小值为1，如果磁盘类型为diskIoType为cloud_enha，则volumeCapacity必须大于50
allocatedMemoryInMB	Integer	否	RequestBody参数	内存大小，单位MB。最小值为1
nodeAmount	Integer	否	RequestBody参数	代理实例节点数，如果变配类型非代理节点，则可以不用传递这个参数，如果是变配代理节点数必须是(2, 4, 6, 8, 16）之一
isDirectPay	Boolean	否	RequestBody参数	是否进行直接支付，默认为否，设置为直接支付的变配订单会直接扣款，不需要在走支付逻辑
isEnhanced	Boolean	否	RequestBody参数	是否为增强版RDS
effectiveTime	String	否	RequestBody参数	操作执行方式，有两种取值：timewindow、immediate。其中timewindow表示在时间窗口内执行，immediate表示立即执行。默认为immediate。实例默认的时间窗口为05:00~06:00，具体可参考实例详情内容
masterAzone	String	否	RequestBody参数	变配时需要变更主库可用区，此参数需要传值，如：cn-bj-a。不传默认取当前主库az
backupAzone	String	否	RequestBody参数	变配时需要变更备库可用区，此参数需要传值，如：cn-bj-a。不传默认取当前备库az
diskIoType	String	否	RequestBody参数	存储磁盘包括本地SSD磁盘（取值为：normal_io）、增强型SSD云磁盘（取值为：cloud_enha）、高性能云磁盘（取值为：cloud_high）、cloud_nor（取值为: 通用型SSD）四种，支持本地盘变更为增强型SSD云盘类型，即取消disable限制。反之，云盘不允许变更为本地盘。限制本地转云盘条件： 1）当实例是应用是mysql且版本是5.5或5.6 2）参数是非本地SSD磁盘（normal_io）且此参数不为空字符
subnetId	String	否	RequestBody参数	子网ID，默认为空
edgeSubnetId	String	否	RequestBody参数	边缘子网ID
subnets	List<SubnetMap>	否	RequestBody参数	变配时如果主库或备库需要变更可用区，此参数需要传值

SubnetMap字段数据结构说明

参数名称	类型	描述
zoneName	String	可用区
subnetId	String	子网Id

返回头域

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

返回参数

参数名称	参数类型	描述
orderId	String	当前操作生成的变配订单Id

请求示例

PUT /v1/instance/rds-DQKfeKDd?resize
HOST: rds.bj.baidubce.com
Content-Type: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-11-21T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
    "cpuCount": 1,
    "memoryCapacity": 1,
    "volumeCapacity": 3,
    "nodeAmount": 1,
    "isDirectPay": false,
    "isEnhanced": false
}

返回示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
    "orderId": "245687654323456788765223"
}

释放实例

更新实例公网访问状态

云数据库 RDS

云数据库 RDS

变配实例