GetSymlink
更新時(shí)間:
調(diào)用GetSymlink接口獲取軟鏈接。此操作需要您對(duì)該軟鏈接有讀權(quán)限。
版本控制
GetSymlink接口默認(rèn)獲取軟鏈接的當(dāng)前版本。允許通過(guò)指定versionId來(lái)獲取指定版本。如果軟鏈接的當(dāng)前版本為刪除標(biāo)記,OSS會(huì)返回404 Not Found,在響應(yīng)header中返回x-oss-delete-marker = true以及版本ID : x-oss-version-id。刪除標(biāo)記沒(méi)有關(guān)聯(lián)數(shù)據(jù),因此也沒(méi)有軟鏈接指向的TargetObject。
請(qǐng)求語(yǔ)法
GET /ObjectName?symlink HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
當(dāng)您在OSS ON云盒中調(diào)用該接口時(shí),您需要將Host替換為云盒Endpoint。更多信息,請(qǐng)參見(jiàn)云盒Endpoint。
請(qǐng)求頭
此接口僅涉及公共請(qǐng)求頭。更多信息,請(qǐng)參見(jiàn)公共請(qǐng)求頭(Common Request Headers)。
響應(yīng)頭
名稱 | 類型 | 示例值 | 描述 |
x-oss-symlink-target | 字符串 | example.jpg | 軟鏈接指向的目標(biāo)文件。 |
示例
請(qǐng)求示例
GET /link-to-oss.jpg?symlink HTTP/1.1 Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Fri, 24 Feb 2012 06:38:30 GMT Authorization: OSS qn6q**************:77Dv****************
返回示例
HTTP/1.1 200 OK Server: AliyunOSS Date: Fri, 24 Feb 2012 06:38:30 GMT Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT Content-Length: 0 Connection: keep-alive x-oss-request-id: 5650BD72207FB30443962F9A x-oss-symlink-target: example.jpg ETag: "A797938C31D59EDD08D86188F6D5****"
指定versionId獲取軟鏈接的請(qǐng)求示例
GET /link-to-oss.jpg?symlink&versionId=CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh**** HTTP/1.1 Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Tue, 09 Apr 2019 06:50:48 GMT Authorization: OSS qn6q**************:77Dv****************
返回示例
HTTP/1.1 200 OK Server: AliyunOSS Date: Tue, 09 Apr 2019 06:50:48 GMT Last-Modified: Tue, 09 Apr 2019 06:50:48 GMT Content-Length: 0 Connection: keep-alive x-oss-version-id: CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh**** x-oss-request-id: 5CAC40C8B7AEADE01700064D x-oss-symlink-target: example.jpg ETag: "40CF4D450730DCCD1A78566FAE35****"
SDK
GetSymlink接口所對(duì)應(yīng)的各語(yǔ)言SDK如下:
錯(cuò)誤碼
錯(cuò)誤碼 | HTTP狀態(tài)碼 | 描述 |
NoSuchKey | 404 | 文件不存在。 |
NotSymlink | 400 | 軟鏈接不存在。 |
文檔內(nèi)容是否對(duì)您有幫助?