Help Center/ Scalable File Service Turbo/ API Reference/ API/ Lifecycle Management/ Expanding the Capacity of a File System
Updated on 2025-11-14 GMT+08:00

Expanding the Capacity of a File System

Function

This API is used to expand the capacity of a file system.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

URI

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

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

The project ID.

share_id

Yes

String

The file system ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

The account token.

Content-Type

Yes

String

The MIME type.

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

extend

Yes

Extend object

The extend object.

Table 4 Extend

Parameter

Mandatory

Type

Description

new_size

Yes

Integer

The new capacity of the file system, in GiB.

For a previous-generation Standard or Performance file system, the capacity ranges from 500 to 32768 (in GiB), and the minimum expansion increment is 100 GiB.

For a previous-generation Standard-Enhanced or Performance-Enhanced file system, the capacity ranges from 10240 to 327680 (in GiB), and the minimum expansion increment is 100 GiB.

For a 20 MB/s/TiB file system, the capacity ranges from 3686 to 1048576 (in GiB) and must be a multiple of 1.2 TiB. The desired capacity must be converted to GiB and rounded down to the nearest integer. For example, use 4915 GiB for a 4.8 TiB file system and 8601 GiB for an 8.4 TiB file system. The minimum expansion increment is 1.2 TiB.

For a 40 MB/s/TiB file system, the capacity ranges from 1228 to 1048576 (in GiB) and must be a multiple of 1.2 TiB. The desired capacity must be converted to GiB and rounded down to the nearest integer. For example, use 4915 GiB for a 4.8 TiB file system and 8601 GiB for an 8.4 TiB file system. The minimum expansion increment is 1.2 TiB.

The capacity range and minimum expansion increment of 1,000 MB/s/TiB, 500 MB/s/TiB, 250 MB/s/TiB and 125 MB/s/TiB file systems are the same as those of 40 MB/s/TiB file systems.

bss_param

No

BssInfoExtend object

The billing parameter of expanding a yearly/monthly file system.

Table 5 BssInfoExtend

Parameter

Mandatory

Type

Description

is_auto_pay

No

Long

Whether to enable auto payment.

Enumeration values:

  • 0

  • 1

Response Parameters

Status code: 202

Table 6 Response body parameters

Parameter

Type

Description

id

String

The SFS Turbo file system ID.

name

String

The SFS Turbo file system name.

Example Requests

Expanding the capacity of a file system to 1,000 GB

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

Example Responses

Status code: 202

Response body for expanding the capacity of a file system

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

Status Codes

Status Code

Description

202

Response body for expanding the capacity of a file system

Error Codes

See Error Codes.