变更配置
更新时间:2023-09-06
请求说明
- 本接口用于变更一个redis实例的规格。
- 变更实例需要实名认证,没有通过实名认证的可以前往百度开放云官网控制台中的安全认证下的实名认证中进行认证。
- 变更计费方式为后付费的实例需要账户现金余额+通用代金券大于100;预付费方式的实例则需要账户现金余额大于等于实例费用。
- 变更配置操作只允许对单一实例进行操作,变更过程失败,操作回滚,费用退回。
- 只有实例正常运行状态时才可以进行扩缩容操作,变更接口为异步变更,可通过查询指定实例详情接口查询实例状态。
- 当前版本为v1。
请求结构
PUT /v1/instance/{instanceId}/change?clientToken={clientToken} HTTP/1.1
HOST: redis.{region}.baidubce.com
Authorization: authorization string
{
"billing": {
"paymentTiming": "paymentTiming",
},
"engineVersion":"engineVersion",
"nodeType": "nodeType",
"shardNum":"shardNum"
"diskFlavor": diskFlavor
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数 | 类型 | 是否必须 | 参数位置 | 描述 |
---|---|---|---|---|
instanceId | String | 是 | URL参数 | 实例ID |
clientToken | String | 是 | URL参数 | 幂等性Token,是一个长度不超过64位的ASCII字符串 |
billing | billing | 是 | RequestBody参数 | 计费相关参数。结构及取值参考计费信息 |
engineVersion | String | 是 | RequestBody参数 | 引擎版本。例如redis 3.2/4.0/5.0/6.0 等 |
nodeType | String | 否 | RequestBody参数 | 参见附录中实例规格 |
shardNum | Integer | 否 | RequestBody参数 | 分片个数 |
diskFlavor | Integer | 否 | RequestBody参数 | 存储空间 |
- nodeType和shardNum只能传入其中1个参数,不能同时变更
返回头域
除公共头域外,无其它特殊头域。
请求示例
PUT /v1/instance/scs-bj-ykfiztgpxjny/change HTTP/1.1
HOST: redis.bj.baidubce.com
Content-Type: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-11-21T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"billing": {
"paymentTiming": "paymentTiming",
},
"engineVersion":"engineVersion",
"nodeType": "nodeType",
"diskFlavor": 1
}
返回示例
HTTP/1.1 200 OK
x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
ContentType: application/json