GPU API 接口

删除云存储Pro

接口说明

删除指定云存储Pro（CFS），释放底层存储资源并处理对应账单。操作前可使用 GetCompShareCFSRefundPrice 预览退费金额。

POSThttps://api.compshare.cnActionDeleteCFS

删除前请备份数据，并确认所有依赖该存储的任务已经停止。 Recycle=true 不是移入回收站，也不代表可以恢复数据；它表示先尝试卸载挂载实例，再继续删除存储。

挂载检查

Recycle	行为
不传或 false	仍有未删除实例保留挂载关系时拒绝删除，即使实例已停止。请先逐个调用 DetachCFS
true	检测到运行中的挂载实例时拒绝删除，并返回 RunningUHostIds；否则尝试卸载所有挂载实例，全部卸载成功后继续删除

本接口仅支持 Pod 可用区。Recycle=true 不是强制删除：实例处于不允许卸载的中间状态，或任一卸载失败时，也不会继续执行删除。多实例卸载可能部分成功，重试前请重新查询挂载关系。

请求参数

名称	类型	必填	描述	示例值
Action	String	是	接口名称	`DeleteCFS`
Region	String	是	云存储所在地域	`cn-bj2`
Zone	String	是	云存储所在 Pod 可用区	`cn-bj2-03`
ProjectId	String	否	云存储所属项目 ID，不传使用默认项目	`org-xxx`
CfsId	String	是	要删除的云存储 ID	`cfs-xxxx`
Recycle	Boolean	否	是否先尝试卸载所有挂载实例再删除，默认 false；检测到运行中的挂载实例时仍会拒绝	`false`

响应参数

名称	类型	描述
Action	String	响应名称：`DeleteCFSResponse`
RetCode	Integer	返回码，0 为成功；必须检查该字段，不能只看 HTTP 状态
Message	String	错误信息，无错误时可能省略
request_uuid	String	请求唯一标识
CfsId	String	云存储 ID
DeletedPVC	Boolean	底层存储声明（PVC）的删除结果
DeletedPV	Boolean	底层存储卷（PV）的删除结果
DeleteTime	Integer	删除记录时间，Unix 秒级时间戳；未完成删除时可能省略
RunningUHostIds	Array of String	Recycle=true 时检测到的运行中挂载实例；出现时本次删除被拒绝

请求示例

所有实例已卸载后删除：


{
  "Action": "DeleteCFS",
  "Region": "cn-bj2",
  "Zone": "cn-bj2-03",
  "CfsId": "cfs-xxxx"
}

所有相关实例已停止，先卸载再删除：


{
  "Action": "DeleteCFS",
  "Region": "cn-bj2",
  "Zone": "cn-bj2-03",
  "CfsId": "cfs-xxxx",
  "Recycle": true
}

响应示例

删除成功


{
  "Action": "DeleteCFSResponse",
  "RetCode": 0,
  "request_uuid": "request-xxxx",
  "CfsId": "cfs-xxxx",
  "DeletedPVC": true,
  "DeletedPV": true,
  "DeleteTime": 1789610400
}

仍有运行中的实例，拒绝删除

Recycle=true 时可能返回以下结果。先停止相应实例并等待状态稳定，或在接受自动重启影响的前提下逐个调用 DetachCFS，再重试删除。


{
  "Action": "DeleteCFSResponse",
  "RetCode": 226618,
  "Message": "cfs exists in the mounted pod",
  "request_uuid": "request-xxxx",
  "CfsId": "cfs-xxxx",
  "DeletedPVC": false,
  "DeletedPV": false,
  "RunningUHostIds": ["cpod-xxxx"]
}