Expanding the Capacity of a File System

Function

This API is used to expand the capacity of an SFS Turbo file system. Capacity expansion is an asynchronous operation. You can check whether the expansion is successful by checking field sub_status returned by Querying Details About a Single File System. If the value of the sub-status is 221, the expansion is successful.

URI

• URI format

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

• Parameter description

  Parameter	Mandatory	Type	Description
  project_id	Yes	String	Specifies the project ID. For details about how to obtain the project ID, see Obtaining a Project ID.
  share_id	Yes	String	Specifies the ID of the SFS Turbo file system.

Request Header

The operation message header is the same as that of a common request. For details, see Table 3.

Request

• Parameter description

  Parameter	Mandatory	Type	Description
  extend	Yes	Object	Specifies the extend object. For details, see the parameter in the extend field.

• Parameter in the extend field

  Parameter	Mandatory	Type	Description
  new_size	Yes	Int	New capacity (GiB) of the file system. For a previous-generation Standard or Performance file system, the capacity ranges from 500 to 32768 (in GiB), and the 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 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, specify 4915 GiB for a 4.8 TiB file system and 8601 GiB for an 8.4 TiB file system. The 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, specify 4915 GiB for a 4.8 TiB file system and 8601 GiB for an 8.4 TiB file system. The expansion increment is 1.2 TiB. The capacity range and expansion increment of 250 MB/s/TiB and 125 MB/s/TiB file systems are the same as those of 40 MB/s/TiB file systems.

• Example request

  {
      "extend": { 
         "new_size": 500    
      }
  }

Response

• Parameter description

  Parameter	Type	Description
  id	String	Specifies the ID of the SFS Turbo file system.
  name	String	Specifies the name of the SFS Turbo file system.

• Example response

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

Status Codes

• Normal

202

• Abnormal

For details, see Status Codes.