标准版升级集群版API
更新时间：2024-11-12
请求说明
通过调用API接口来将标准版实例升级为集群版。
- 不支持跨版本架构升级，例如，Redis 4.0 标准架构不支持升级至 Redis 5.0 集群架构。
- 不支持带了只读实例组的标准版实例升级到集群版，如需要升级需要先删除只读实例组才能升级。
- 热活或多活实例组中的实例不支持升级。
- 不支持单副本标准版升级架构。
- 升级后的总内存容量需要大于等于标准版总内存容量。
- 有维护时间内的任务未完成时不支持升级。
- 非运行中实例不支持升级。
- Redis7.0标准版不支持升级。
请求结构
Plain Text
1PUT /v1/instance/{instanceId}/clusterTypeChange HTTP/1.1
2HOST: redis.{region}.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 参数类型 | 参数位置 | 是否必须 | 描述 |
|---|---|---|---|---|
| instanceId | String | Path | 是 | 集群ID |
| isDefer | Boolean | Body | 否 | 是否维护时间内执行。默认false。true：维护时间内执行；false：立即执行。 |
| nodeType | String | Body | 否 | 节点规格。 |
| shardNum | Integer | Body | 否 | 分片数量。 |
| replicationInfo | List<ReplicationItem> | Body | 否 | 副本信息。 |
ReplicationItem
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| availabilityZone | String | 可通过调用获取可用区列表接口查询可用区列表。zoneName命名规范是“国家-region-可用区序列"，小写，例如北京可用区A为"cn-bj-a" |
| subnetId | String | 子网Id |
| isMaster | Integer | 是否是主节点 1代表主 0代表从。主节点有且仅有一个。 |
返回头域
除公共头部，无其它特殊头部。
返回参数
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| orderId | String | 订单ID。 |
请求示例
Plain Text
1PUT /v1/instance/scs-bj-ozgdsbsqqnxi/clusterTypeChange HTTP/1.1
2Host: redis.{region}.baidubce.com
3Authorization: authorization string
4{
5 "nodeType": "cache.n1.small",
6 "shardNum": 2,
7 "replicationInfo": [
8 {
9 "availabilityZone": "cn-bj-a",
10 "subnetId": "sbn-t94a1xpb4tw4",
11 "isMaster": 1
12 },
13 {
14 "availabilityZone": "cn-bj-a",
15 "subnetId": "sbn-t94a1xpb4tw4",
16 "isMaster": 0
17 }
18 ],
19 "isDefer": false
20}返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
3Content-Type: application/json
4{
5 "orderId": "xxx"
6}