Scales up an Extreme NAS file system.

Description

  • 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 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 scaled-up capacity of the file system.

The scaled-up capacity of the file system must be larger than the original capacity of the file system. Unit: GiB.

DryRun Boolean Yes true

Specifies whether to perform a dry run for the 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 a file system or incur fees.

Default value: false. Valid values:

  • true: A dry-run request is sent and the file system is not scaled up. The check items include the request format, service limits, available NAS resources, and whether the required parameters are set. If the check fails, the corresponding error is returned. If the check succeeds, the HTTP status code 200 is returned, but no FileSystemId is returned.
  • false: A normal request is sent, and the 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 you do not specify this parameter, the system automatically uses the request ID as the client token. The ID of each request is unique.

Response parameters

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

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/? Action=UpgradeFileSystem
&Capacity=100
&DryRun=true
&FileSystemId=1ca404****
&<Common request parameters>

Sample success responses

XML format

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

JSON format

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

Error codes

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