变配实例
更新时间：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"
}