更新时间:2026-09-30 GMT+08:00
分享

扩容文件系统 - ExpandShare

功能介绍

扩容文件系统。

接口约束

该接口不适用于100MB/s/TiB-智算型、200MB/s/TiB-智算型文件系统。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。

URI

POST /v1/{project_id}/sfs-turbo/shares/{share_id}/action

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID,用于标识资源所属的IAM项目空间,实现项目级资源隔离与权限管控。

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

share_id

是

String

参数解释:

文件系统ID,用于唯一标识SFS Turbo文件系统实例。获取方法请参见1.4 获取文件系统列表 - ListShares。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token,用于鉴权认证。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

Content-Type

是

String

参数解释:

请求消息体MIME类型,用于标识请求正文的数据格式。

约束限制:

不涉及。

取值范围:

application/json

默认取值:

application/json

表3 请求Body参数

参数

是否必选

参数类型

描述

extend

是

Extend object

参数解释:

扩容请求参数对象,包含扩容后的目标容量等配置信息。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表4 Extend

参数

是否必选

参数类型

描述

new_size

是

Integer

参数解释:

扩容后文件系统的新容量,以GiB为单位。

约束限制:

  • 性能型、标准型、性能型-增强版、标准型-增强版等类型的文件系统,扩容步长需大于等于100GiB。

  • 20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB等类型的文件系统,容量必须为1.2TiB的倍数,扩容步长需大于等于1.2TiB,目标容量换算为GiB后需向下取整。例如4.8TiB向下取整为4915GiB,8.4TiB向下取整为8601GiB。

  • HPC缓存型的文件系统,扩容步长为1TiB,目标容量换算为GiB。

取值范围:

  • 500~32768 GiB:性能型、标准型等类型的新容量取值范围。

  • 10240~327680 GiB:性能型-增强版、标准型-增强版等类型的新容量取值范围。

  • 3686~1048576 GiB:20MB/s/TiB类型的新容量取值范围。

  • 1228~1048576 GiB:40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB等类型的新容量取值范围。

  • HPC缓存型:4096~1048576 GiB。

默认取值:

不涉及。

new_bandwidth

否

Long

参数解释:

扩容后文件系统的带宽目标值,单位为Gbps。

约束限制:

仅HPC缓存型支持带宽扩缩。

取值范围:

  • 2:表示带宽为2 Gbps。

  • 4:表示带宽为4 Gbps。

  • 8:表示带宽为8 Gbps。

  • 16:表示带宽为16 Gbps。

  • 24:表示带宽为24 Gbps。

  • 32:表示带宽为32 Gbps。

  • 48:表示带宽为48 Gbps。

默认取值:

不涉及。

bss_param

否

BssInfoExtend object

参数解释:

包周期扩容计费详情,用于指定包周期文件系统扩容时的计费和支付相关参数。

约束限制:

仅包周期计费模式的文件系统扩容时需要填写。

取值范围:

不涉及。

默认取值:

不涉及。

表5 BssInfoExtend

参数

是否必选

参数类型

描述

is_auto_pay

否

Long

参数解释:

是否生成订单后自动扣款。

约束限制:

包周期计费场景下该参数生效。

取值范围:

  • 0:不自动扣款。

  • 1:自动扣款。

默认取值:

0

响应参数

状态码:202

表6 响应Body参数

参数

参数类型

描述

id

String

参数解释:

SFS Turbo文件系统的ID。

取值范围:

不涉及。

name

String

参数解释:

SFS Turbo文件系统的名称。

取值范围:

不涉及。

请求示例

扩容一个文件系统,扩容后的文件系统目标容量是1000GB。

{
  "extend" : {
    "new_size" : 1000
  }
}

响应示例

状态码:202

{
  "id" : "67d4bd5e-7b2f-4c24-9a0b-c0038940c6f8",
  "name" : "sfs-turbo-test"
}

状态码

状态码

描述

202

扩容文件系统请求下发成功返回body

错误码

请参见错误码。

相关文档