文档中心

对象存储

请输入

软链接

PutSymlink

功能描述

调用 PutSymlink 接口为 TOS 已有的目标文件创建软链接，您可以通过该软链接快速访问目标文件。

注意事项

PutSymlink 接口按照软链接对象的存储类型收取请求次数费用，详细介绍，请参见请求次数费用。

使用 PutSymlink 接口创建软链接时，不会检查目标文件是否存在、以及是否有权限访问目标文件。调用 GetObject、HeadObject 等接口获取软链接信息时，会检查账号是否有软链接和目标文件的读取权限、以及目标文件是否存在。

软链接对象和目标对象支持位于同地域不同存储桶中，不支持位于不同地域的存储桶。

不支持二级软链接。您可以使用 PutSymlink 接口创建二级链接，但是无法通过二级软链接访问指向的目标文件。

关于 PutSymlink 接口的更多注意事项，请参见创建软链接。

请求消息样式

说明

请求消息样式中的 ObjectName 用于指定软链接的名称，Host 中的 bucketname 用于指定存储软链接的桶名。

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
symlink	Query	String	是	-	代表 PutSymlink 请求的特殊标识。
x-tos-symlink-target	Header	String	是	test-object	软链接指向的目标文件名。注意目标文件名需要进行 URL 编码，遵循 application/x-www-form-urlencoded 标准。软链接指向的目标文件不能为软链接。
x-tos-symlink-bucket	Header	String	否	test-bucket	软链接的目标文件所属存储桶，若不设置，则表示软链接及其指向的目标文件在同一个桶内。
x-tos-forbid-overwrite	Header	String	否	false	如果桶中存在同名对象，是否允许软链接覆盖该对象，取值说明如下： true：禁止覆盖同名对象。 false ：允许覆盖同名对象。默认为 false，即不设置 x-tos-forbid-overwrite 参数，则表示允许覆盖同名对象。注意当软链接所属存储桶处于已开启或已暂停的版本控制状态时，x-tos-forbid-overwrite 参数设置无效，即允许覆盖同名 Object。
x-tos-acl	Header	String	否	private	软链接的访问权限，有效的设置包括： private：私有 public-read：公共读。 public-read-write：公共读写。 authenticated-read：认证用户读。 bucket-owner-read：桶所有者读。 bucket-owner-full-control：桶所有者完全权限。 bucket-owner-entrusted：受桶策略控制，桶所有者完全权限。 default：继承桶 ACL，即对象的 ACL 策略和桶 ACL 策略保持一致。默认为 private。
x-tos-storage-class	Header	String	否	STANDARD	软链接的存储类型，取值说明如下： STANDARD：标准存储。 IA：低频访问存储。 NTELLIGENT_TIERING：智能分层存储。 ARCHIVE_FR：归档闪回存储。 ARCHIVE：归档存储。 COLD_ARCHIVE：冷归档存储。 DEEP_COLD_ARCHIVE：深度冷归档存储。若不设置，则与所在桶的默认存储类型保持一致。说明低频存储、归档闪回等存储类型存在最小计量单位限制，单个文件小于 64 KiB，将按照 64 KiB 计算存储容量费用。而标准存储类型的小对象（小于 64 KiB）在某个地域的数量小于 10 亿时，则该地域仍按照小对象的实际大小计算标准存储容量费用。软链接对象存储容量一般小于 64 KiB，为了避免不必要的费用，建议您设置软链接对象的存储类型为标准存储。
x-tos-tagging	Header	String	否	Key1=Value1&Key2=Value	软链接的对象标签信息，格式为 {Key}={Value}，支持同时设置多个标签，设置多个标签时使用 & 分隔。说明对象标签的 Key 和 Value 需要先进行 URLEncode，遵循 application/x-www-form-urlencoded 标准。如果某个标签未使用 = 设置 Value，则 TOS 会认为该标签的 Value 为空字符串。关于对象标签的更多限制信息，请参见对象标签。
x-tos-meta-*	Header	String	否	x-tos-meta-key:value	软链接的自定义元数据。

请求元素

该请求中无请求消息元素。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

名称	参数类型	示例值	说明
x-tos-version-id	String	5840E600C6FBD446792D	软链接的版本号。如果不存在版本号，则该消息头不会出现在响应消息中。

响应元素

该请求响应中无消息元素。

请求示例

响应示例

最近更新时间：2025.11.10 10:27:26

这个页面对您有帮助吗？

有用

无用