GPU API 接口

扩容云存储Pro

接口说明

扩容已有云存储Pro（CFS）的容量配额。Size 是扩容后的总容量，不是本次增加的容量。扩容会进行变配计费，建议先通过 GetCompShareCFSUpgradePrice 查询费用。

POSThttps://api.compshare.cnActionResizeCFS

使用限制

仅支持 Pod 可用区，CFS 必须属于当前账号、项目且未删除。
目标容量必须严格大于当前容量，且在 50～2048 GiB 范围内。不支持缩容，也不接受与当前容量相同的值。
接口更新存储容量配额，不执行实例停止、启动或重新挂载操作。

请求参数

名称	类型	必填	描述	示例值
Action	String	是	接口名称	`ResizeCFS`
Region	String	是	云存储所在地域	`cn-bj2`
Zone	String	是	云存储所在 Pod 可用区	`cn-bj2-03`
ProjectId	String	否	云存储所属项目 ID，不传使用默认项目	`org-xxx`
CfsId	String	是	云存储 ID	`cfs-xxxx`
Size	Integer	是	扩容后的总容量，单位 GiB，必须大于当前容量且不超过 2048	`200`
TotalFiles	Integer	否	已弃用的文件数配额参数，底层采用固定配置，不建议传入	—
CouponId	String	否	变配时使用的代金券 ID	`coupon-xxx`

响应参数

名称	类型	描述
Action	String	响应名称：`ResizeCFSResponse`
RetCode	Integer	返回码，0 为成功
Message	String	错误信息，无错误时可能省略
request_uuid	String	请求唯一标识
CfsId	String	云存储 ID
OldSize	Integer	扩容前容量，单位 GiB；未取得时可能省略
NewSize	Integer	扩容后容量，单位 GiB
UpdateTime	Integer	更新时间，Unix 秒级时间戳

请求示例

将一份 100 GiB 的 CFS 扩容到 200 GiB：


{
  "Action": "ResizeCFS",
  "Region": "cn-bj2",
  "Zone": "cn-bj2-03",
  "CfsId": "cfs-xxxx",
  "Size": 200
}

响应示例


{
  "Action": "ResizeCFSResponse",
  "RetCode": 0,
  "request_uuid": "request-xxxx",
  "CfsId": "cfs-xxxx",
  "OldSize": 100,
  "NewSize": 200,
  "UpdateTime": 1789606800
}

如调用超时或结果不明确，请先通过 DescribeCFS 确认当前容量，再决定是否重试；扩容成功后再次提交相同 Size 会因目标容量不大于当前容量而失败。