调用UpgradeFileSystem扩容极速型NAS文件系统或CPFS文件系统的存储容量。

接口说明

  • 仅中国站支持CPFS文件系统扩容。
  • 通用型NAS按需自动扩容,无须使用本API。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String UpgradeFileSystem

接口名称。

固定取值:UpgradeFileSystem。

FileSystemId String 1ca404****

文件系统ID。

  • 通用型NAS:31a8e4****。
  • 极速型NAS:必须以extreme-开头,例如extreme-0015****。
  • CPFS:必须以cpfs-开头,例如cpfs-125487****。仅中国站支持CPFS文件系统。
Capacity Long 100

扩容后的文件系统的容量。

扩容后容量需大于文件系统原容量,单位:GiB。

DryRun Boolean true

是否对此次创建请求执行预检。

预检操作会帮助您检查参数有效性、校验库存等,并不会实际创建实例,也不会产生费用。

取值:

  • true:发送检查请求,不会创建实例。检查项包括是否填写了必需参数、请求格式、业务限制和NAS库存。如果检查不通过,则返回对应错误。如果检查通过,则返回200 HttpCode,但FileSystemId为空。
  • false(默认):发送正常请求,通过检查后直接创建实例。
ClientToken String 123e4567-e89b-12d3-a456-42665544****

保证请求幂等性,从您的客户端生成一个参数值,确保不同请求间该参数值唯一。

ClientToken只支持ASCII字符,且不能超过64个字符。更多信息,请参见如何保证幂等性

说明 若用户未指定,则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。

返回数据

名称 类型 示例值 描述
RequestId String 98696EF0-1607-4E9D-B01D-F20930B6****

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=UpgradeFileSystem
&FileSystemId=1ca404****
&Capacity=100
&DryRun=true
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&公共请求参数

正常返回示例

XML格式

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

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

JSON格式

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

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

错误码

访问错误中心查看更多错误码。