Object Storage Service:GetSymlink

Versioning

GetSymlink obtains the current version of the target symbol link by default. You can specify the versionId in the request to obtain the specified version of a symbol link. If the current version of the target symbol link is a delete marker, OSS returns the 404 Not Found error and includes x-oss-delete-marker = true and x-oss-version-id in the response header. A delete marker does not contain any data. Therefore, the information about the target object that the symbol link directs to is not included in the response.

Request syntax

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

Response headers

Examples

• Normal request example:

  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****************

  Response example:

  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: oss.jpg
  ETag: "A797938C31D59EDD08D86188F6D5****"

• Example of a request initiated with a specified versionId to obtain the specified version of a symbol link:

  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****************

  Response example:

  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: oss.jpg
  ETag: "40CF4D450730DCCD1A78566FAE35****"

SDK

The SDKs of this API are as follows:

• Java

• Python

• PHP

• Go

• C

• C++

• .NET

• Android

• iOS

• Node.js

Error codes