## **功能描述** 调用 PutSymlink 接口为 TOS 已有的目标文件创建软链接，您可以通过该软链接快速访问目标文件。 ## 注意事项 * PutSymlink 接口按照软链接对象的存储类型收取请求次数费用，详细介绍，请参见[请求次数费用](/docs/6349/79462)。 * 使用 PutSymlink 接口创建软链接时，不会检查目标文件是否存在、以及是否有权限访问目标文件。调用 [GetObject](/docs/6349/74856)、[HeadObject](/docs/6349/74864) 等接口获取软链接信息时，会检查账号是否有软链接和目标文件的读取权限、以及目标文件是否存在。 * 软链接对象和目标对象支持位于同地域不同存储桶中，不支持位于不同地域的存储桶。 * 不支持二级软链接。您可以使用 PutSymlink 接口创建二级链接，但是无法通过二级软链接访问指向的目标文件。关于 PutSymlink 接口的更多注意事项，请参见[创建软链接](/docs/6349/1285440)。 ## 请求消息样式 ```JSON 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 ``` :::tip 请求消息样式中的 `ObjectName` 用于指定软链接的名称，`Host` 中的 `bucketname` 用于指定存储软链接的桶名。 ::: ## 请求参数和消息头该请求使用的公共请求消息头，请参见[公共参数](/docs/6349/75044)。 |**名称** |**位置** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---|---| |symlink |Query |String |是 |\- |代表 PutSymlink 请求的特殊标识。 | |x\-tos\-symlink\-target |Header |String |是 |test\-object |软链接指向的目标文件名。|\ | | | | | |:::warning|\ | | | | | ||\ | | | | | |* 目标文件名需要进行 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` 参数，则表示允许覆盖同名对象。|\ | | | | | |:::warning|\ | | | | | |当软链接所属存储桶处于已开启或已暂停的版本控制状态时，`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`：深度冷归档存储。|\ | | | | | ||\ | | | | | |若不设置，则与所在桶的默认存储类型保持一致。|\ | | | | | |:::tip|\ | | | | | |低频存储、归档闪回等存储类型存在最小计量单位限制，单个文件小于 64 KiB，将按照 64 KiB 计算存储容量费用。而标准存储类型的小对象（小于 64 KiB）在某个地域的数量小于 10 亿时，则该地域仍按照小对象的实际大小计算标准存储容量费用。软链接对象存储容量一般小于 64 KiB，为了避免不必要的费用，建议您设置软链接对象的存储类型为标准存储。|\ | | | | | ||\ | | | | | |:::| |x\-tos\-tagging |Header |String |否 |Key1=Value1&Key2=Value |软链接的对象标签信息，格式为 `{Key}={Value}`，支持同时设置多个标签，设置多个标签时使用 `&` 分隔。|\ | | | | | |:::tip|\ | | | | | ||\ | | | | | |* 对象标签的 Key 和 Value 需要先进行 URLEncode，遵循 application/x\-www\-form\-urlencoded 标准。|\ | | | | | |* 如果某个标签未使用 `=` 设置 Value，则 TOS 会认为该标签的 Value 为空字符串。|\ | | | | | |* 关于对象标签的更多限制信息，请参见[对象标签](https://www.volcengine.com/docs/6349/141325)。|\ | | | | | ||\ | | | | | |:::| |x\-tos\-meta\-\* |Header |String |否 |x\-tos\-meta\-key:value |软链接的自定义元数据。 | ## 请求元素该请求中无请求消息元素。 ## 响应消息头该请求返回的公共响应消息头，请参见[公共参数](/docs/6349/75044)。 |**名称** |**参数类型** |**示例值** |**说明** | |---|---|---|---| |x\-tos\-version\-id |String |5840E600C6FBD446792D |软链接的版本号。如果不存在版本号，则该消息头不会出现在响应消息中。 | ## 响应元素该请求响应中无消息元素。 ## **请求示例** ```JSON 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 ``` ## 响应示例 ```JSON 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****" ```