全部产品
Search
文档中心

Object Storage Service:GetSymlink

更新时间:Oct 21, 2025

Untuk mendapatkan tautan simbolik dengan memanggil operasi GetSymlink, Anda harus memiliki izin baca pada tautan simbolik tersebut.

Versioning

GetSymlink secara default mengambil versi terkini dari tautan simbol target. Anda dapat menentukan versionId dalam permintaan untuk mendapatkan versi tertentu dari sebuah tautan simbol. Jika versi terkini dari tautan simbol target adalah penanda hapus (delete marker), OSS akan mengembalikan kesalahan 404 Not Found dan menyertakan x-oss-delete-marker = true dan x-oss-version-id di header respons. Penanda hapus tidak berisi data apa pun. Oleh karena itu, informasi tentang objek target yang dituju oleh tautan simbol tidak disertakan dalam respons.

Syntax

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

Header Permintaan

Semua header dalam permintaan GetSymlink merupakan header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Header Respons

Header

Tipe

Contoh

Deskripsi

x-oss-symlink-target

String

example.jpg

Menunjukkan objek target yang dituju oleh tautan simbol.

Contoh

  • Contoh permintaan normal:

    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

    Contoh respons:

    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****"
  • Contoh permintaan dengan menentukan versionId untuk mendapatkan versi tertentu dari sebuah tautan simbol:

    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

    Contoh respons:

    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 SDKs

Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut guna memanggil operasi GetSymlink:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi GetSymlink, lihat get-symlink.

Kode Kesalahan

Kode kesalahan

Status HTTP

Deskripsi

NoSuchKey

404

Objek yang diminta tidak ada.

NotSymlink

400

Tautan simbol yang diminta tidak ada.