注意事项

• 使用PutSymlink接口创建软链接时不会检查目标文件是否存在、目标文件类型是否合法以及目标文件是否有访问权限。
• Symlink自身的访问权限（ACL）以及目标文件的ACL检查仅会在GetObject等需要访问目标文件的API中进行。
• 使用PutSymlink接口时，携带以x-oss-meta-为前缀的参数，则被视为user meta，例如x-oss-meta-location。一个Object可以有多个类似的参数，但所有的user meta总大小不能超过8 KB。
• 默认情况下，如果试图添加的文件已经存在，并且有访问权限，则新添加的文件将覆盖原来的文件，成功添加后将返回200 OK。

版本控制

您可以通过TargetObject创建的软链接指向TargetObject的当前版本。

软链接本身也可以有多个版本，每个不同的版本可以指向不同的TargetObject，版本ID由OSS自动生成，在响应Header中返回x-oss-version-id。

请求语法

PUT /ObjectName?symlink HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
x-oss-symlink-target: TargetObjectName

请求头

此接口还需要包含Host、Date等公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

响应头

此接口仅包含公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

示例

• 请求示例

  PUT /link-to-oss.jpg?symlink HTTP/1.1 
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
  Cache-control: no-cache 
  Content-Disposition: attachment;filename=oss_download.jpg 
  Date: Tue, 08 Nov 2016 02:00:25 GMT 
  Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:kZoYNv66bsmc10+dcGKw5x2****= x-oss-symlink-target: oss****
  x-oss-storage-class: Standard

  返回示例

  HTTP/1.1 200 OK
  Server: AliyunOSS
  Date: Tue, 08 Nov 2016 02:00:25 GMT
  Content-Length: 0
  Connection: keep-alive
  x-oss-request-id: 582131B9109F4EE66CDE56A5
  ETag: "0A477B89B4602AA8DECB8E19BFD4****"

• 版本控制请求示例

  PUT /link-to-oss.jpg?symlink HTTP/1.1 
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
  Date: Tue, 09 Apr 2019 06:50:48 GMT 
  Authorization: OSS o3shiyktjw16xw1:NVXXKiyUJ2tg07PxINinU0eO****
  x-oss-symlink-target: oss.jpg

  返回示例

  HTTP/1.1 200 OK
  Server: AliyunOSS
  Date: Tue, 09 Apr 2019 06:50:48 GMT
  Content-Length: 0
  Connection: keep-alive
  x-oss-version-id: CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh****
  x-oss-request-id: 5CAC40C8B7AEADE01700064B
  ETag: "136A5E127272200EDAB170DD84DE****"

SDK

PutSymlink接口所对应的各语言SDK如下：

• Java
• Python
• PHP
• Go
• C
• .NET

错误码