Scales up a file system.

Usage notes

  • Only Extreme NAS file systems and Cloud Parallel File Storage (CPFS) file systems can be scaled up. CPFS file systems are available only on the China site (aliyun.com).
  • A General-purpose NAS file system is automatically scaled up. You do not need to call this operation to scale up a General-purpose NAS file system.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

ParameterTypeRequiredExampleDescription
ActionStringYesUpgradeFileSystem

The operation that you want to perform.

Set the value to UpgradeFileSystem.

FileSystemIdStringYesextreme-0015****

The ID of the file system.

  • The IDs of Extreme NAS file systems must start with extreme-. Example: extreme-0015****.
  • The IDs of CPFS file systems must start with cpfs-. Example: cpfs-125487****.
    Note CPFS file systems are available only on the China site (aliyun.com).
CapacityLongYes100

The desired capacity of the file system.

The desired capacity of the file system must be greater than the original capacity of the file system. Unit: GiB.

DryRunBooleanYestrue

Specifies whether to perform a dry run.

During the dry run, the system checks whether the request parameters are valid and whether the requested resources are available. During the dry run, no file system is created and no fee is incurred.

Valid values:

  • true: performs a dry run. The system checks the required parameters, request syntax, limits, and available NAS resources. If the request fails the dry run, an error message is returned. If the request passes the dry run, the HTTP status code 200 is returned. No value is returned for the FileSystemId parameter.
  • false (default): performs a dry run and sends the request. If the request passes the dry run, a file system is created.
ClientTokenStringNo123e4567-e89b-12d3-a456-42665544****

The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests.

The token can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How do I ensure the idempotence?

Note If you do not specify this parameter, the system automatically uses the request ID as the client token. The value of RequestId may be different for each API request.

Response parameters

ParameterTypeExampleDescription
RequestIdString98696EF0-1607-4E9D-B01D-F20930B6****

The request ID.

Examples

Sample requests

http(s)://[Endpoint]/?Action=UpgradeFileSystem
&FileSystemId=extreme-0015****
&Capacity=100
&DryRun=true
&ClientToken=123e4567-e89b-12d3-a456-42665544****
<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<UpgradeFileSystemResponse>
    <RequestId>98696EF0-1607-4E9D-B01D-F20930B6****</RequestId>
</UpgradeFileSystemResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "98696EF0-1607-4E9D-B01D-F20930B6****"
}

Error codes

For a list of error codes, see Service error codes.