Object Storage Service:GetSymlink

バージョニング

GetSymlink は、デフォルトでターゲットシンボリックリンクの現在のバージョンを取得します。 リクエストで versionId を指定して、シンボリックリンクの特定のバージョンを取得できます。 ターゲットシンボリックリンクの現在のバージョンが削除マーカーの場合、OSS は 404 Not Found エラーを返し、x-oss-delete-marker = true と x-oss-version-id をレスポンスヘッダーに含めます。 削除マーカーにはデータが含まれていません。 そのため、シンボリックリンクが指すターゲットオブジェクトに関する情報はレスポンスに含まれません。

構文

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

リクエストヘッダー

GetSymlink リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通リクエストヘッダー」をご参照ください。

レスポンスヘッダー

例

• 通常のリクエスト例：

  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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  レスポンス例：

  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 で開始されたリクエストの例。シンボリックリンクの特定のバージョンを取得します。

  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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  レスポンス例：

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

OSS SDK

以下のプログラミング言語の OSS SDK を使用して、GetSymlink 操作を呼び出すことができます。

• Java

• Python V2

• PHP V2

• Go V2

• C

• C++

• .NET

• Android

• iOS

• Node.js

• Browser.js

ossutil

GetSymlink 操作に対応する ossutil コマンドについては、「get-symlink」をご参照ください。

エラーコード