更新时间:2025-09-18 GMT+08:00

查询磁盘扩容范围

功能介绍

此接口可用于查看磁盘扩容操作时支持的扩容范围。

约束限制

磁盘扩容功能仅8.1.1.203及以上版本支持,并且创建集群规格需要为云数仓SSD云盘或实时数仓类型。

按需+折扣套餐包消费模式下,存储扩容后超出折扣套餐包部分将按需收费。

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/clusters/{cluster_id}/storage-expand-range

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

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

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

cluster_id

String

参数解释

集群ID。获取方法请参见获取集群ID

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

min_size

Integer

参数解释

扩容后单节点磁盘最小值(单位GB)。

取值范围

不涉及。

max_size

Integer

参数解释

扩容后单节点磁盘最大值(单位GB)。

取值范围

不涉及。

current_size

Integer

参数解释

磁盘当前值(单位GB)。

取值范围

不涉及。

step

Integer

参数解释

磁盘步长大小(单位GB)。比如当前单节点磁盘20GB,步长为20,则扩容后单节点磁盘大小至少为40GB。

取值范围

大于等于10。

请求示例

查询当前集群磁盘扩容支持的范围信息。

get https://{Endpoint}/v1/89cd04f168b84af6be287f71730fdb4b/clusters/b5c45780-1006-49e3-b2d5-b3229975bbc7/storage-expand-range

响应示例

状态码:200

磁盘扩容请求下发成功。

{
  "min_size" : 20,
  "max_size" : 2000,
  "current_size" : 20,
  "step" : 10
}

状态码

状态码

描述

200

磁盘扩容请求下发成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。