概述
挂载点实例(客户端挂载)是 MountPoint 产品的核心操作对象。它代表一个具体的存储挂载关系——将指定的 COS 存储桶挂载到计算节点的本地路径上。
核心概念
概念 | 说明 |
挂载点实例 | 一个具体的存储挂载实体,将 COS 桶映射为本地目录 |
所属节点 | 挂载点运行所在的计算节点 |
本地挂载路径 | 计算节点上的挂载目录,如 /data/goosefs/mnt-1 |
COS 存储桶 | 被挂载的对象存储桶 |
COS 挂载路径 | 桶内的子路径,默认为 /(挂载整个桶) |
绑定配置 | 关联的挂载点配置模板 |
身份认证 | 访问 COS 的凭证方式 |
状态 | 运行中 / 已停止 / 异常 |
身份认证方式
方式 | 说明 |
永久密钥认证 | 使用 AccessKey + SecretKey |
临时密钥认证 | 使用临时凭证(STS) |
CVM 角色鉴权 | 通过 CVM 实例绑定的角色自动获取权限 |
外部进程维护 | 由外部程序提供和刷新凭证 |
前提条件
已创建 挂载点配置。
操作步骤
创建挂载点
1. 登录 GooseFS MountPoint 控制台,进入目标集群详情页。
2. 在左侧导航栏选择客户端挂载,默认展示挂载管理标签页。
3. 在挂载管理页面,单击新建挂载。
4. 在新建客户端弹窗中按以下信息填写:

参数 | 必填 | 说明 |
挂载节点 | 是 | 从下拉列表选择目标计算节点 |
本地挂载路径 | 是 | 节点上的本地目录路径,如 /data/goosefs/mnt-1 |
COS 存储桶 | 是 | 从下拉列表选择目标存储桶 |
COS 挂载路径 | 否 | 桶内子路径,默认 / 表示挂载整个桶 |
绑定配置 | 是 | 选择已创建的配置模板 |
身份认证 | 是 | 选择认证方式(永久密钥 / 临时密钥 / CVM 角色 / 外部进程) |
AccessKey | 条件必填 | 选择永久密钥认证时需填写 |
SecretKey | 条件必填 | 选择永久密钥认证时需填写 |
5. 单击挂载完成创建并自动启动。挂载成功后状态变为运行中,此时 COS 桶已挂载到本地路径,可通过文件系统接口访问。
查看挂载点列表
1. 在左侧导航栏选择客户端挂载,默认展示挂载管理标签页。
2. 在挂载管理列表页,可查看所有挂载点实例信息。包括所属节点、本地挂载路径、存储(COS 桶 / 路径)、配置信息、状态、操作等。

3. 支持通过关键字搜索,以及通过更多操作进行批量操作。
停止挂载点
注意:
停止挂载点会立即卸载本地目录,正在进行的 I/O 操作将被中断。请评估后,谨慎操作。
1. 在挂载列表中选择运行中的实例。
2. 通过操作列或更多操作选择停止。
3. 系统执行卸载操作,状态变为已停止,即表示挂载点停止成功。
启动挂载点
1. 在挂载列表中选择已停止的实例。
2. 单击操作列的启动。
3. 系统执行挂载操作,状态变为运行中,即表示挂载点启动成功。
删除挂载点
注意:
仅已停止状态的挂载点可删除,运行中的实例需先停止后再操作。
删除挂载点会影响已有业务,请评估后,谨慎操作。
1. 在挂载列表中找到目标实例。
2. 单击操作列的删除。
3. 在确认弹窗中单击确定。
相关接口
接口名称 | 功能 |
CreateMountPointInstance | 批量创建挂载点实例 |
ListMountPointInstances | 查询挂载点实例列表 |
DescribeMountPointInstance | 查询挂载点实例详情 |
UpdateMountPointInstance | 更新挂载点实例信息 |
StartMountPointInstance | 批量启动挂载点 |
SuspendMountPointInstance | 批量停止挂载点 |
RestartMountPointInstance | 批量重启挂载点 |
DeleteMountPointInstance | 删除挂载点实例 |