创建软链接

更新时间：2021-12-29

接口说明

PutSymlink接口用于为BOS的相同bucket下已有的目的object（本文档称作"target object"）创建软链接（Symlink），您可以通过该软链接访问目的object。

注意：

软链接文件和target object文件需要位于同一个bucket下面。
目前支持对标准存储、低频存储、冷存储、归档存储类型的object文件设置软链接。软链接文件本身不支持ARCHIVE类型。如果用户指定ARCHIVE类型，或者不指定类型且Bucket默认存储类型是ARCHIVE时，返回报错CODE_INVALID_ARGUMENT。
调用该接口创建软链接时，不会检查目标文件是否存在、以及是否有权限访问目标文件。使用软链接调用GetObject接口时候，会检查用户是否有软链接和目标文件的读取权限、目标文件是否存在。
创建软链接需要有相应写权限。
如果不指定"x-bce-forbid-overwrite"这个Header，如果存在与软链接文件同名的object文件时，创建软链接操作时会默认覆盖同名Object。
不支持二级软链接。用户创建二级软链时不会进行检查，但是用户无法通过二级软链访问指向的object数据。

PUT /v1/{bucketName}/{objectKey}?symlink

参数名称	参数类型	是否必须	描述	示例值
xBceSymlinkTarget	String	是	指定软链接的目标文件。命名规范同Object。软链接的目标文件不能为软链接文件	"xBceSymlinkTarget_example"
xBceForbidOverwrite	String	否	指定创建软链接操作时是否覆盖同名Object。如果不指定x-bce-forbid-overwrite时，默认允许覆盖同名Object。指定x-bce-forbid-overwrite为true时，表示禁止覆盖同名Object；指定x-bce-forbid-overwrite为false时，表示允许覆盖同名Object。	"xBceForbidOverwrite_example"
xBceMeta_	String	否	用户自定义的meta	"xBceMeta__example"
xBceStorageClass	String	否	指定软链接文件的存储类型，STANDARD代表标准存储，STANDARD_IA代表低频存储，COLD代表冷存储,不指定时默认是bucket存储类型。软链接文件本身不支持ARCHIVE类型。	"xBceStorageClass_example"

无

参数名称	参数类型	描述	示例值
ETag	String	软链接目标Object名字的HTTP协议实体标签

无

无

HTTP/1.1 200 OK
<公共响应头>

{ }

请参考通用错误码