All Products
Search
Document Center

Apsara File Storage NAS:UpgradeFileSystem

Last Updated:Mar 14, 2024

Scales up an Extreme NAS file system or a Cloud Parallel File Storage (CPFS) file system.

Operation description

  • Only Extreme NAS file systems and 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.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
FileSystemIdstringYes

The ID of the file system.

  • The IDs of Extreme NAS file systems must start with extreme-, for example, extreme-0015****.
  • The IDs of CPFS file systems must start with cpfs-, for example, cpfs-125487****.
Note CPFS file systems are available only on the China site (aliyun.com).
1ca404****
CapacitylongYes

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.

100
DryRunbooleanYes

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.
true
ClientTokenstringNo

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 request ID may be different for each request.
123e4567-e89b-12d3-a456-42665544****

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The request ID.

98696EF0-1607-4E9D-B01D-F20930B6****

Examples

Sample success responses

JSONformat

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

Error codes

For a list of error codes, visit the Service error codes.