文档中心

对象存储

请输入

文件管理

创建软链接

软链接是一个独立的文件，其中包含指向目标文件的路径信息，类似于快捷方式。您可以通过软链接对象快速访问常用的目标对象，且相比目标对象，软链接对象的存储容量很小，可以忽略不计，帮助您节约存储成本。本文介绍软链接行为、计费说明和创建软链接的操作步骤等内容。

行为说明

软链接对象支持版本控制功能，支持不同版本的软链接对象指向不同的目标对象。访问软链接对象时，不同的操作，实际访问的对象不同，返回的对象内容也不同，说明如下：

操作	返回的内容
GetObject	使用 GetObject 下载软链接对象时，不同的参数返回的内容不同，说明如下： body：返回软链接对象指向的目标对象的具体内容。 Content-Length、ETag 、x-tos-storage-class 和 x-tos-hash-crc64ecma：返回软链接对象指向的目标对象的信息。 Last-Modified：返回软链接对象和目标对象两者之间最新的更新日期。其他参数：返回软链接对象信息。
HeadObject	使用 HeadObject 获取对象元数据时，不同的参数返回的内容不同，说明如下： ETag、 x-tos-storage-class 、 x-tos-hash-crc64ecma 和x-tos-symlink-target-size：返回软链接对象指向的目标对象信息。 Last-Modified：返回软链接对象和目标对象两者之间最新的更新日期。其他参数：返回软链接对象信息
除了 GetObject 和 HeadObject 外的其他操作	获取软链接对象的信息，不会获取目标对象信息。

计费说明

软链接对象的计费方式和普通对象相同，访问软链接对象时，TOS 收取软链接对象的费用，与目标对象无关。例如使用 GetObject 、HeadObject 接口获取软链接对象信息，或者使用数据处理功能处理软链接对象时，TOS 收取软链接对象的请求次数费用、流量费用等。PutSymlink 和 GetSymlink 接口也按照软链接对象的存储类型收取请求次数费用。

注意事项

类别	注意事项
地域	软链接对象和目标对象支持位于同地域同存储桶或同地域不同存储桶中，不支持位于不同地域的存储桶。
权限	创建软链接对象时，TOS 不会检查创建者是否有权限访问目标对象，但是通过软链接访问目标对象时，TOS 会检查账号是否有软链接对象和目标对象的读取权限，您需要确保账号拥有对应权限，否则访问会失败。
数量	目标对象支持创建的软链接对象个数无限制。
存储类型	低频存储、归档闪回等存储类型存在最小计量单位限制，单个文件小于 64 KiB，将按照 64 KiB 计算存储容量费用。而标准存储类型的小对象（小于 64 KiB）在某个地域的数量小于 10 亿时，则该地域仍按照小对象的实际大小计算标准存储容量费用。软链接对象存储容量一般小于 64 KiB，为了避免不必要的费用，建议您设置软链接对象的存储类型为标准存储。
操作生效范围	对软链接对象执行的操作仅对软链接对象生效，不会应用到目标对象，例如修改存储类型、删除软链接对象等操作。

使用限制

类别	说明
创建限制	不支持对目录创建软链接。不支持创建二级链接，即不支持对软链接对象创建软链接。
访问限制	通过软链接对象访问目标对象时，如果目标对象存储类型是归档闪回、冷归档和深度冷归档，则目标对象必须先完成恢复，否则访问会失败。具体操作，请参见恢复文件。移动、删除或重命名目标对象后，您将无法访问该目标对象对应的软链接对象。
功能限制	软链接对象不支持以下功能，说明如下：不支持跨区域复制和同区域复制功能，即您无法使用该功能复制软链接对象。不支持服务端加密功能，即您无法加密软链接对象。不支持恢复文件功能，如果软链接对象的存储类型是归档、冷归档或深度冷归档，您无需恢复软链接对象，就可以使用 GetObject 接口下载该对象。
TOS Browser 限制	仅 1.8.1 及以上版本的 TOS Browser 支持下载软链接对象。

创建软链接

登录对象存储控制台。

在左侧导航栏单击桶列表，在桶列表页面单击目标桶名称。

在文件列表页面，单击目标文件操作列下的 ... >设置软链接。

在设置软链接对话框，配置如下参数。

参数	说明
软链接存储桶	选择存储软链接的存储桶，只能选择与目标文件位于相同地域的存储桶。
软链接路径	选择路径定位方式，设置软链接对象在存储桶的保存路径，说明如下：相对路径：相对于目标文件的路径，例如您当前的文件在 /test/ 目录下，设置路径为 data-symlink，则软链接所在路径为 /test/data-symlink。说明如果您目标对象和软链接对象位于不同存储桶，且软链接对象所在存储桶没有目标文件的路径，设置路径方式为相对路径后，软链接对象将保存在根目录开始的路径下。绝对路径：从根目录开始的完整路径，例如您当前的文件在 /test/ 目录下，设置路径为 data1-symlink，则软链接所在路径为 /data1-symlink。选择路径定位方式后，输入具体路径，具体规范如下：支持中文、英文、数字及常见字符。支持使用正斜线（ /）快速创建子文件夹。不支持以正斜线（/ ）或反斜线（\）开头。不支持使用连续的正斜线（/ ）。不支持以连续点号（..）作为目录名称。例如 aaa/bbb/filename。

完成设置后，单击确定。

软链接对象创建成功后，您可以鼠标悬浮至软链接对象名称右侧的链接图标，查看软链接对象所指向的目标对象所在路径。