创建软链接
所有文档

          对象存储 BOS

          创建软链接

          接口说明

          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数据。

          请求URI

          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
          <公共响应头>
          
          { }

          错误码

          请参考通用错误码

          上一篇
          权限控制
          下一篇
          获取软链接