PutSymlink - Object Storage Service

Membuat tautan simbolik yang menunjuk ke objek tujuan. Anda dapat menggunakan tautan simbolik untuk mengakses objek tersebut.

Catatan penggunaan

Saat memanggil operasi PutSymlink untuk membuat tautan simbolik, Object Storage Service (OSS) tidak memeriksa apakah objek tujuan ada, kelas penyimpanannya valid, atau apakah Anda memiliki akses ke objek tersebut.
Daftar kontrol akses (ACL) dari tautan simbolik dan ACL objek tujuan yang ditunjuk oleh tautan simbolik diperiksa saat operasi API seperti GetObject dipanggil untuk mengakses objek tujuan.
Jika permintaan PutSymlink berisi parameter dengan nama diawali x-oss-meta-, parameter tersebut dianggap sebagai metadata pengguna dari tautan simbolik. Contoh: x-oss-meta-location. Sebuah objek dapat memiliki beberapa parameter serupa, namun total ukuran semua metadata pengguna tidak boleh melebihi 8 KB.
Secara default, jika objek yang ingin dibuat sudah ada dan Anda memiliki izin untuk mengaksesnya, objek baru akan menimpa objek lama, dan OSS mengembalikan respons 200 OK.

Versi

Anda dapat membuat tautan simbolik untuk objek tujuan dan menunjuk tautan simbolik ke versi terkini dari objek tersebut.

Tautan simbolik dapat memiliki beberapa versi. Anda dapat memanggil operasi PutSymlink untuk menunjuk setiap versi tautan simbolik ke objek yang berbeda. Dalam hal ini, ID versi dibuat oleh OSS dan dikembalikan dalam respons sebagai header x-oss-version-id.

Izin

Secara default, akun Alibaba Cloud memiliki izin penuh. Pengguna RAM atau Peran RAM di bawah akun Alibaba Cloud tidak memiliki izin apa pun secara default. Akun Alibaba Cloud atau administrator harus memberikan izin operasi melalui Kebijakan RAM atau Kebijakan Bucket.

API

Aksi

Definisi

PutSymlink

oss:PutObject

Membuat tautan simbolik untuk sebuah objek.

oss:PutObjectTagging

Saat membuat tautan simbolik untuk sebuah objek, jika Anda menentukan tag objek melalui x-oss-tagging, izin ini diperlukan.

Sintaks permintaan

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

Header permintaan

Header	Tipe	Diperlukan	Deskripsi
x-oss-forbid-overwrite	String	Tidak	Menentukan apakah operasi PutSymlink menimpa objek dengan nama yang sama. Jika Anda tidak menentukan header x-oss-forbid-overwrite atau jika Anda mengatur header x-oss-forbid-overwrite ke false, objek dengan nama yang sama akan ditimpa. Jika Anda mengatur header x-oss-forbid-overwrite ke true, objek dengan nama yang sama tidak dapat ditimpa. Jika Anda menentukan header x-oss-forbid-overwrite, kinerja queries per second (QPS) OSS mungkin menurun. Jika Anda ingin menentukan header x-oss-forbid-overwrite dalam sejumlah besar permintaan (QPS lebih besar dari 1.000), hubungi dukungan teknis. Catatan Header x-oss-forbid-overwrite tidak berlaku saat penomoran versi diaktifkan atau ditangguhkan untuk bucket tujuan. Dalam hal ini, operasi PutSymlink menimpa objek dengan nama yang sama.
x-oss-symlink-target	String	Ya	Objek tujuan yang ditunjuk oleh tautan simbolik. Konvensi penamaan untuk objek tujuan sama dengan konvensi penamaan untuk objek. Sebagaimana ObjectName, TargetObjectName harus dienkripsi URL. Objek tujuan yang ditunjuk oleh tautan simbolik tidak dapat berupa tautan simbolik.
x-oss-object-acl	String	Tidak	ACL objek. Nilai default: default. Nilai valid: default: ACL objek sama dengan ACL bucket tempat objek disimpan. private: ACL objek adalah private. Hanya pemilik objek dan pengguna yang berwenang yang memiliki izin baca dan tulis pada objek. public-read: ACL objek adalah public-read. Hanya pemilik objek dan pengguna yang berwenang yang memiliki izin baca dan tulis pada objek. Pengguna lain hanya memiliki izin baca pada objek. Berhati-hatilah saat Anda mengatur ACL objek ke nilai ini. public-read-write: ACL objek adalah public-read-write. Semua pengguna memiliki izin baca dan tulis pada objek. Berhati-hatilah saat Anda mengatur ACL objek ke nilai ini. Untuk informasi lebih lanjut tentang ACL objek, lihat ACL Objek.
x-oss-storage-class	String	Tidak	Kelas penyimpanan objek. Jika Anda menentukan header x-oss-storage-class saat mengunggah objek, kelas penyimpanan objek yang diunggah adalah nilai header yang ditentukan tanpa memperhatikan kelas penyimpanan bucket tempat objek diunggah. Misalnya, jika Anda mengatur x-oss-storage-class ke Standard saat mengunggah objek ke bucket Infrequent Access (IA), objek disimpan sebagai objek Standard. Nilai valid: Standard IA Archive Objek IA dan Archive memiliki ukuran tagihan minimum 64 KB. Kami merekomendasikan agar Anda tidak mengatur kelas penyimpanan ke IA atau Archive dalam permintaan PutSymlink. Untuk informasi lebih lanjut tentang kelas penyimpanan, lihat Ikhtisar.

Untuk informasi lebih lanjut tentang header permintaan umum yang termasuk dalam permintaan PutSymlink, seperti Host dan Date, lihat Header Permintaan Umum.

Header respons

Respons terhadap permintaan PutSymlink hanya berisi header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Contoh

Contoh Permintaan

PUT /link-to-oss.jpg?symlink HTTP/1.1 
Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
Cache-control: no-cache 
Content-Disposition: attachment;filename=oss_download.jpg 
Date: Tue, 08 Nov 2016 02:00:25 GMT 
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-disposition,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e 
x-oss-symlink-target: oss****
x-oss-storage-class: Standard

Contoh Respons Sukses

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Tue, 08 Nov 2016 02:00:25 GMT
Content-Length: 0
Connection: keep-alive
x-oss-request-id: 582131B9109F4EE66CDE56A5
ETag: "0A477B89B4602AA8DECB8E19BFD4****"

Contoh Permintaan untuk Bucket Bernomor Versi

PUT /link-to-oss.jpg?symlink 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
x-oss-symlink-target: oss.jpg

Contoh Respons Sukses

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Tue, 09 Apr 2019 06:50:48 GMT
Content-Length: 0
Connection: keep-alive
x-oss-version-id: CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh****
x-oss-request-id: 5CAC40C8B7AEADE01700064B
ETag: "136A5E127272200EDAB170DD84DE****"

SDK OSS

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

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi PutSymlink, lihat put-symlink.

Kode kesalahan

Kode kesalahan	Status HTTP	Deskripsi
InvalidArgument	400	Pesan kesalahan yang dikembalikan karena nilai StorageClass tidak valid.
FileAlreadyExists	409	Pesan kesalahan yang dikembalikan karena objek dengan nama yang sama sudah ada dan header x-oss-forbid-overwrite diatur ke true dalam permintaan.
FileImmutable	409	Pesan kesalahan yang dikembalikan karena data yang ingin Anda hapus atau ubah dilindungi oleh kebijakan retensi.