Scales up a file system.

Description

When you call this operation, note that:

  • A General-purpose NAS file system is automatically scaled up on demand. Therefore, you do not need to call this operation to scale up a General-purpose NAS file system.
  • You can call this operation to scale up an Extreme NAS file system.
  • You cannot call this operation to scale up a Cloud Paralleled File System (CPFS).

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

Parameter Type Required Example Description
Action String Yes UpgradeFileSystem

The operation that you want to perform.

Set the value to UpgradeFileSystem.

Capacity Long Yes 100

The capacity of the file system. Unit: GB.

DryRun Boolean Yes true

Specifies whether to perform a dry run for the current request.

The dry run checks whether the request parameters are valid and whether the requested resources are available. The dry run does not scale up the specified file system or incur fees.

Valid values:

  • true: A dry-run request is sent, and the specified file system is not scaled up. The check items include the request format, service limits, available ECS resources, and whether the required parameters are set. If the check fails, the corresponding error code is returned. If the check succeeds, the 200 HTTP status code is returned, but the return value of the FileSystemId parameter is NULL.
  • false: A normal request is sent, and the specified file system is scaled up after the check succeeds.
FileSystemId String Yes 1ca404****

The ID of the file system.

ClientToken String No 123e4567-e89b-12d3-a456-42665544****

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

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

Note If the token is not specified, the system uses the ID of the API request as the client token. The ID of each request is unique.

Response parameters

Parameter Type Example Description
RequestId String 98696EF0-1607-4E9D-B01D-F20930B68845

The ID of the request.

Examples

Sample requests

GET https://nas.cn-hangzhou.aliyuncs.com/?Action=UpgradeFileSystem
&Capacity=100
&DryRun=true
&FileSystemId=1ca404****
&<Common request parameters>

Sample success responses

XML format

<RequestId>98696EF0-1607-4E9D-B01D-F20930B68845</RequestId>

JSON format

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

Error codes

For a list of error codes, visit the API Error Center.