Files

Reviewed-by: Muller, Martin <martin.muller@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>

2025-04-14 12:20:07 +00:00

13 KiB

Raw Blame History

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 after expansion, in GiB. The value ranges from 500 GiB to 32768 GiB, and the capacity expansion step is greater than or equal to 100 GiB. Specifications of the previous-generation SFS Turbo file system: Standard Enhanced and Performance Enhanced. The capacity ranges from 10240 GiB to 327680 GiB. The capacity expansion step is greater than or equal to 100 GiB. 20 MB/s/TiB. The capacity ranges from 3686 GiB to 1048576 GiB. The capacity must be a multiple of 1.2 TiB, and the capacity expansion step must be greater than or equal to 1.2 TiB. The target capacity must be converted to GiB and then rounded down. For example, 4.8 TiB->4915 GiB, 8.4 TiB->8601 GiB. 40 MB/s/TiB. The capacity ranges from 1228 GiB to 1048576 GiB. The capacity must be a multiple of 1.2 TiB, and the capacity expansion step must be greater than or equal to 1.2 TiB. The target capacity must be converted to GiB and then rounded down. For example, 4.8 TiB->4915 GiB, 8.4 TiB->8601 GiB. 125 MB/s/TiB, 250 MB/s/TiB and 40 MB/s/TiB, the expansion steps are the same.

Response Parameters

Status code: 202

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

Parent topic: Lifecycle Management

13 KiB Raw Blame History