Updated on 2025-11-03 GMT+08:00

Expanding the Capacity of a File System

Function

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

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.

Response Parameters

Status code: 202

Table 5 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.