Skip to Content
GPU 接口文档磁盘与云存储云存储Pro挂载云存储Pro
GPU API 接口

挂载云存储Pro

接口说明

将账号在实例所在可用区的云存储Pro（CFS）挂载到 Pod 实例。实际 Action 为 AttachUS3，不是 AttachCFS，请求只需指定 UHostId，无需传入 CfsId。

POSThttps://api.compshare.cnActionAttachUS3

费用和重启提醒： 如果账号在该可用区尚无 CFS，接口会自动购买 50 GiB、按月计费、1 个周期的 CFS。给运行中的实例首次挂载时会自动停止并启动实例，请先保存业务任务。需要自定义容量、计费方式或代金券时，请先调用 CreateCFS。

使用限制与状态行为

  • 本页针对 cpod- 前缀的 Pod 实例；普通 uhost- 实例请使用 US3 对象存储挂载说明。
  • 自动使用同一账号、同一可用区的 CFS，不支持通过 CfsId 选择其他存储或跨可用区挂载。
  • 已挂载同一份 CFS 时，重复调用直接成功，不会再次重启。
实例状态挂载行为
Running保存挂载配置，自动停止并启动实例以应用挂载
Stopped / Stopping只保存挂载配置，不主动开机，下次启动时生效
其他中间状态拒绝操作，等待实例状态稳定后重试

请求参数

名称类型必填描述示例值
ActionString是接口名称，仍为 AttachUS3AttachUS3
RegionString是实例所在地域cn-bj2
ZoneString是实例所在 Pod 可用区cn-bj2-03
ProjectIdString否实例所属项目 ID，不传使用默认项目org-xxx
UHostIdString是要挂载的 Pod 实例 IDcpod-xxxx

响应参数

名称类型描述
ActionString响应名称为 AttachUS3，没有 Response 后缀
RetCodeInteger返回码，0 为成功
MessageString错误信息，无错误时可能省略
request_uuidString请求唯一标识

本接口不返回 CfsId。请通过 DescribeCFS 查询存储和挂载实例，通过 DescribeCompShareInstance 确认实例状态。

请求示例

{
  "Action": "AttachUS3",
  "Region": "cn-bj2",
  "Zone": "cn-bj2-03",
  "UHostId": "cpod-xxxx"
}

响应示例

{
  "Action": "AttachUS3",
  "RetCode": 0,
  "request_uuid": "request-xxxx"
}
Last updated on
查询云存储Pro卸载云存储Pro