Updated on 2023-09-27 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

Project ID

share_id

Yes

String

File system ID

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Account token

Content-Type

Yes

String

MIME type

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

extend

Yes

Extend object

Object of extend

Table 4 Extend

Parameter

Mandatory

Type

Description

new_size

Yes

Integer

New capacity of the file system, in GiB

For a General (standard or performance) file system, the capacity ranges from 500 to 32768 (in GiB), and the expansion increment is 100 GiB.

For a General (standard enhanced or performance enhanced) file system, the capacity ranges from 10240 to 327680 (in GiB), and the expansion increment is 100 GiB.

For an HPC file system, the capacity must be a multiple of 1.2 TiB. The value ranges from 3686 to 1048576 in GiB. The 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 a 8.4 TiB file system.

For an HPC Cache file system, the capacity ranges from 4096 to 1048576 (in GiB) and must be converted to GiB. The expansion increment is 1 TiB.

Minimum: 500

Maximum: 1048576

new_bandwidth

No

Long

New bandwidth, in GB. Only HPC Cache file systems support bandwidth change. The following bandwidths are supported: 2G, 4G, 8G, 16G, 24G, 32G and 48G.

bss_param

No

BssInfoExtend object

Expansion billing details of yearly/monthly resources

Table 5 BssInfoExtend

Parameter

Mandatory

Type

Description

is_auto_pay

No

Long

Whether to enable automatic payment

Enumeration values:

  • 0

  • 1

Response Parameters

Status code: 202

Table 6 Response body parameters

Parameter

Type

Description

id

String

ID of the SFS Turbo file system

name

String

Name of the SFS Turbo file system

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.