注意事項

• 使用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 qn6q**************:77Dv**************** 
  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 qn6q**************:77Dv****************
  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

• C++

• .NET

• Android

• iOS

• Node.js

錯誤碼