シンボルリンクを取得します。 GetSymlink 操作を実行するには、シンボルリンクに対する読み取り権限が必要です。

バージョン管理

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

リクエスト構文

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

レスポンスヘッダー

ヘッダー 説明
x-oss-symlink-target String シンボルリンクのリンク先のターゲットオブジェクト。

  • 通常のリクエスト例

    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 qn6qrrqxo2oawuk53otfjbyc:UNQDb7GapEgJCZkcde6OhZ9J****

    レスポンス例

    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****"
  • 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: OSS o3shiyktjw16xw1:LFKjDsA81MCTcBKV6h+Z/95f****

    レスポンス例

    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

この API の SDK は次のとおりです。

エラーコード

エラーコード HTTP ステータスコード 説明
NoSuchKey 404 リクエストされたシンボルリンクは存在しません。