概述

软链接功能用于快速访问对象存储空间内的常用文件。设置软链接后，您可以通过软链接文件快速打开源文件，类似于 Windows 系统中的快捷方式。

注意事项

• 软链接文件和源文件可以位于相同region内的不同bucket。
• 目前支持对标准存储、低频存储、冷存储和归档存储类型的源文件设置软链接文件，但软链接文件不支持设置为归档存储类型。
• 创建软链接文件时，BOS 不会检查源文件是否存在，以及创建者是否有权限访问目标文件。创建完成后读取软链接文件时，BOS 会检查软链接文件和源文件是否存在，并检查您对文件的读取权限。
• 创建软链接文件需要有相应写权限。
• 如果不指定"x-bce-forbid-overwrite" Header，且存在与软链接文件同名的文件时，软链接操作时会默认覆盖同名文件，请您仔细确认。
• 不支持为已创建的软链接文件继续创建软链接文件（二级软链）。

设置软链接文件

1. 登录 BOS 管理控制台，进入全局概览页面。
2. 在 BOS 控制台左侧的导航栏中选择扫描文件所在的目标 Bucket，点击打开该 Bucket 的文件列表页。
3. 点击目标文件右侧操作栏的更多->软链接即可对文件设置软链接。

4.在弹窗中对软链接文件进行命名。若您需要将软链接文件放入 Bucket 中某一个文件夹，请在命名时将文件夹路径一起写入软链接文件名称中。若您在名称中未标明路径，默认统一放入 Bucket 根目录中。如软链接文件名称为 aaa/ruanlianjie1.csv，那么该软链接文件将放入 aaa 文件夹进行保存；若您将其命名为 ruanlianjie.csv，那么该文件将放入 Bucket 根目录进行保存。

说明：

• 若您不希望保存已创建的软链接文件，您可以将其删除。软链接文件删除后，源文件不受影响；
• 若您对软链接文件重命名，或者转换存储类型，都不会影响源文件的相关属性；
• 若您将源文件删除，已创建的软链接文件不会随源文件同步删除，此时访问软链接文件将不会成功。若您将源文件删除，请手动同步删除软链接文件；
• 软链接文件 API 操作方法同普通文件的操作方法相同，如删除，重命名操作等。

相关API

• PutSymlink 接口：使用 PutSymlink API 接口设置文件的软链接。
• GetSymlink 接口：使用 GetSymlink API 接口读取和访问软链接文件。