【GaussDB】DN分片扩容

DN分片扩容

功能介绍

数据库DN分片扩容。

须知：

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

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

说明：

DN分片扩容期间会有闪断，请谨慎操作。

接口约束

• DN分片扩容单次步长限制1~9。
• DN分片扩容后最大到256。

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字段数据结构说明

名称

是否必选

参数类型

说明

shard

是

Object

请参见表4

isAutoPay

否

int

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

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

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

表4 count字段数据结构说明

名称

是否必选

参数类型

说明

count

是

Integer

新增的DN分片扩容数大小

响应参数

表5 响应参数

名称

参数类型

说明

job_id

String

任务ID

请求示例

https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/opengauss/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action
{
	"expand_cluster": {
                "shard":{
                       "count":1
                },
                "isAutoPay":0
	}
}

响应示例

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

  {
  	"job_id": "2b414788a6004883a02390e2eb0ea227"
  }
  

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

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

状态码

• 正常

  202

• 异常

  请参见状态码。

错误码

请参见错误码。