You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /对象存储/API 参考/对象/软链接/PutSymlink
PutSymlink
最近更新时间：2024.08.01 20:30:33首次发布时间：2024.07.02 20:13:50
我的收藏
有用
有用
无用
无用

功能描述

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

注意事项

  • PutSymlink 接口按照软链接对象的存储类型收取请求次数费用，详细介绍，请参见请求次数费用。
  • 使用 PutSymlink 接口创建软链接时，不会检查目标文件是否存在、以及是否有权限访问目标文件。调用 GetObject、HeadObject 等接口获取软链接信息时，会检查账号是否有软链接和目标文件的读取权限、以及目标文件是否存在。
  • 软链接对象和目标对象支持位于同地域不同存储桶中，不支持位于不同地域的存储桶。
  • 不支持二级软链接。您可以使用 PutSymlink 接口创建二级链接，但是无法通过二级软链接访问指向的目标文件。

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

请求消息样式

PUT /ObjectName?symlink HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Wed, 29 May 2024 08:37:23 GMT
Authorization: authorization string
x-tos-symlink-target: TargetObjectName
x-tos-symlink-bucket: TargetBucketName

说明

请求消息样式中的 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，为了避免不必要的费用，建议您设置软链接对象的存储类型为标准存储。

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

软链接的版本号。如果不存在版本号，则该消息头不会出现在响应消息中。

响应元素

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

请求示例

PUT /link-to-abc?symlink HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Wed, 29 May 2024 08:37:23 GMT
Authorization: authorization string
x-tos-symlink-target: abc
x-tos-symlink-bucket: target-bucket

响应示例

HTTP/1.1 200 OK
Date: Wed, 29 May 2024 08:41:23 GMT
Server: TosServer
Content-Length: 0
x-tos-id-2: 1e89f203jld00006-a444fd0
x-tos-request-id: 1e89f203b2d00006-a443223
Etag: "47bce5c74f589f4867dbd57e9****"