【GaussDB】CN横向扩容

CN横向扩容

功能介绍

数据库CN横向扩容。

须知：

该接口计划于2025-03-31下线，建议及时切换到新接口CN横向扩容/DN分片扩容/磁盘扩容。

• 调用接口前，您需要了解API 认证鉴权。
• 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

接口约束

• CN横向扩容步长1~9。
• CN横向扩容后最大到256。
• 若创建实例时指定的可用区为1个，CN横向扩容需选择同一可用区。
• 扩容后，实例中CN节点的数量必须小于或等于两倍的分片数量。

URI

POST https://{

Endpoint

}/gaussdb/v3/{

project_id

}/instances/{

instance_id

}/action

表1 参数说明

名称

是否必选

说明

project_id

是

参数解释：

租户在某一Region下的项目ID。

获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

instance_id

是

实例ID。

请求参数

表2 请求参数

名称

是否必选

参数类型

说明

expand_cluster

是

Object

请参见表3

表3 expand_cluster字段数据结构说明

名称

是否必选

参数类型

说明

coordinators

是

Array

请参见表4

isAutoPay

否

int

包周期用户需要填写该字段。

• 0：表示不自动支付扩容订单费用
• 1：表示自动支付扩容订单费用

不填写则保持默认。默认值：0

表4 azCode字段数据结构说明

名称

是否必选

参数类型

说明

az_code

是

String

新增CN横向扩容每个节点的可用区

响应参数

表5 响应参数

名称

参数类型

说明

job_id

String

任务ID

请求示例

• 扩单CN。

  https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/opengauss/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action
  {
  	"expand_cluster": {
                  "coordinators": [
                          {
                                 "az_code":"az1xahz"
                          }
                  ]，
                 "isAutoPay":0
  	}
  }
  

• 扩多CN。

  https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/opengauss/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action
  {
  	"expand_cluster": {
                  "coordinators": [
                          {
                                 "az_code":"az1xahz"
                          },
                          {
                                 "az_code":"az2xahz"
                          },
                          {
                                 "az_code":"az3xahz"
                          }
                  ]
  	}
  }
  

响应示例

• 非包租期用户响应消息样例：

  {
  	"job_id": "2b414788a6004883a02390e2eb0ea227"
  }
  

• 包租期用户响应消息样例：

  {
          "payInfo": {
              "payModel": null,
              "orderId": "CS2105061116HNTVI",
              "period": null,
              "periodType": 5,
              "isAutoRenew": 0,
              "isAutoPay": 1
          },
  	"job_id": null
  }
  

状态码

• 正常

  202

• 异常

  请参见状态码。

错误码

请参见错误码。