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: SignatureValueHeader 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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eContoh 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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eContoh 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. |