Buat tautan simbolik dengan menggunakan perintah create-symlink - Object Storage Service

Gunakan perintah create-symlink untuk membuat tautan simbolik yang mengarah ke suatu objek di Object Storage Service (OSS). Tautan simbolik berfungsi seperti pintasan—memungkinkan Anda mengakses objek secara cepat tanpa menduplikasinya.

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

Izin oss:PutObject pada bucket target. Untuk detailnya, lihat Attach a custom policy to a RAM user.
ossutil versi 1.6.16 atau yang lebih baru. Versi sebelumnya mengharuskan Anda mengganti nama binari sesuai sistem operasi Anda. Untuk detailnya, lihat ossutil command reference.

Sintaksis perintah

ossutil create-symlink cloud_url target_object
[--encoding-type <value>]
[--payer <value>]

Parameter/Opsi	Deskripsi	Contoh
`cloud_url`	Path lengkap OSS dari tautan simbolik yang akan dibuat.	`oss://examplebucket/test.jpg`
`target_object`	Path lengkap OSS dari objek yang dituju oleh tautan simbolik. Tautan simbolik dan objek target harus berada dalam bucket yang sama.	`oss://examplebucket/exampleobject.jpg`
`--encoding-type`	Metode pengkodean untuk nama objek dalam `cloud_url` dan `target_object`. Nilai yang valid: `url`. Jika tidak ditentukan, nama tidak dikodekan.	`url`
`--payer`	Pihak yang membayar permintaan. Tetapkan ke `requester` agar pihak pemohon membayar biaya traffic dan permintaan.	`requester`

Catatan penggunaan

ossutil tidak memeriksa apakah objek target ada saat membuat tautan simbolik. Jika objek target ada, tautan simbolik akan mengarah ke objek tersebut. Jika objek target tidak ada, tautan simbolik tidak mengarah ke apa pun. Untuk memverifikasi keberadaan objek target, jalankan perintah ls untuk menampilkan daftar objek dalam bucket.

Penting

Jika nama tautan simbolik cocok dengan tautan simbolik yang sudah ada di bucket, tautan simbolik yang ada akan ditimpa.

Contoh

Buat tautan simbolik di direktori root

Buat tautan simbolik bernama test.jpg di root examplebucket, yang mengarah ke exampleobject.jpg dalam bucket yang sama:

ossutil create-symlink oss://examplebucket/test.jpg oss://examplebucket/exampleobject.jpg

Buat tautan simbolik di subdirektori

Buat tautan simbolik bernama example.jpg di direktori destfolder/ dari examplebucket, yang mengarah ke test.jpg di root bucket yang sama. Pemohon membayar seluruh biaya traffic dan permintaan:

ossutil create-symlink oss://examplebucket/destfolder/example.jpg oss://examplebucket/test.jpg --payer requester

Output yang diharapkan

Operasi yang berhasil mengembalikan waktu yang diperlukan:

0.106744(s) elapsed

Buat tautan simbolik lintas akun atau wilayah

Untuk mengakses bucket di wilayah berbeda atau yang dimiliki oleh Akun Alibaba Cloud lain, tambahkan opsi -e, -i, dan -k.

Perintah berikut membuat tautan simbolik bernama testobject.png yang mengarah ke exampleobject.png di testbucket, yang berlokasi di wilayah China (Shanghai) dan dimiliki oleh akun berbeda:

ossutil create-symlink oss://testbucket/testobject.png oss://testbucket/exampleobject.png -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Opsi	Deskripsi
`-e`	Titik akhir wilayah tempat bucket berada.
`-i`	ID AccessKey dari akun pemilik bucket.
`-k`	Rahasia AccessKey dari akun pemilik bucket.

Untuk semua opsi yang tersedia, lihat Common options.

Langkah selanjutnya

Setelah membuat tautan simbolik, jalankan perintah read-symlink atau stat untuk mengkueri detailnya, seperti nilai ETag dan waktu pembaruan terakhir.