全部产品
Search
文档中心

Object Storage Service:create-symlink

更新时间:Jul 02, 2025

Tautan simbolik mirip dengan pintasan di Windows dan memungkinkan akses cepat ke objek dalam Object Storage Service (OSS). Anda dapat menjalankan perintah create-symlink untuk membuat tautan simbolik yang menunjuk ke objek di OSS.

Catatan penggunaan

  • Untuk ossutil versi 1.6.16 dan lebih baru, Anda dapat langsung menggunakan ossutil sebagai nama biner di baris perintah tanpa perlu memperbarui nama biner berdasarkan sistem operasi. Untuk versi sebelum 1.6.16, Anda harus memperbarui nama biner sesuai dengan sistem operasi. Untuk informasi lebih lanjut, lihat Referensi perintah ossutil.

Sintaks perintah

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

Tabel berikut menjelaskan parameter dan opsi sebelumnya.

Parameter/Opsi

Deskripsi

cloud_url

Jalur lengkap tautan simbolik yang ingin Anda buat.

target_object

Jalur lengkap objek yang ditunjuk oleh tautan simbolik. Tautan simbolik dan objek yang ditunjuk oleh tautan simbolik harus berada dalam bucket yang sama.

--encoding-type

Metode yang digunakan untuk mengkodekan nama objek yang ditentukan dalam cloud_url dan target_object. Nilai valid: url. Jika Anda tidak menentukan parameter ini, nama tidak dikodekan.

--payer

Pembayar permintaan. Jika Anda ingin peminta yang mengakses sumber daya di jalur tertentu membayar biaya yang dihasilkan oleh operasi, seperti lalu lintas dan biaya permintaan, atur parameter ini ke requester.

Contoh

Saat menjalankan perintah create-symlink untuk membuat tautan simbolik, ossutil tidak memeriksa apakah objek yang ditunjuk oleh tautan simbolik ada. Jika objek ada, tautan simbolik yang dibuat akan menunjuk ke objek tersebut. Jika objek tidak ada, tautan simbolik yang dibuat tidak menunjuk ke apa pun. Untuk menentukan apakah objek yang ditunjuk oleh tautan simbolik ada, jalankan perintah ls untuk menanyakan semua objek dalam bucket.

Contoh berikut menunjukkan cara membuat tautan simbolik yang menunjuk ke objek yang ada.

Penting

Jika nama tautan simbolik yang ingin Anda buat sama dengan tautan simbolik yang sudah ada di bucket, tautan simbolik yang sudah ada akan ditimpa.

  • Buat tautan simbolik bernama test.jpg di direktori root bucket examplebucket dan arahkan tautan simbolik ke objek exampleobject.jpg di direktori root bucket.

    ossutil create-symlink  oss://examplebucket/test.jpg  oss://examplebucket/exampleobject.jpg
  • Buat tautan simbolik bernama example.jpg di direktori destfolder bucket examplebucket dan arahkan tautan simbolik ke objek test.jpg di direktori root bucket. Tentukan bahwa semua biaya yang timbul saat perintah dijalankan dibayar oleh peminta.

    ossutil create-symlink  oss://examplebucket/destfolder/example.jpg  oss://examplebucket/test.jpg --payer requester
  • Keluaran sampel berikut menunjukkan bahwa tautan simbolik telah dibuat untuk objek:

    0.106744(s) elapsed

    Setelah tautan simbolik dibuat, Anda dapat menjalankan perintah read-symlink atau stat untuk menanyakan informasi tentang tautan simbolik, seperti nilai ETag dan waktu pembaruan terakhir.

Opsi umum

Jika Anda menggunakan ossutil untuk beralih ke bucket yang berlokasi di wilayah lain, tambahkan opsi -e untuk menentukan titik akhir wilayah tempat bucket berada. Jika Anda menggunakan ossutil untuk beralih ke bucket yang dimiliki oleh akun Alibaba Cloud lain, tambahkan opsi -i untuk menentukan ID AccessKey dari akun yang ditentukan, dan tambahkan opsi -k untuk menentukan Rahasia AccessKey dari akun yang ditentukan.

Sebagai contoh, Anda dapat menjalankan perintah berikut untuk membuat tautan simbolik bernama testobject.png yang menunjuk ke objek exampleobject.png di bucket testbucket yang berlokasi di wilayah China (Shanghai) dan dimiliki oleh akun Alibaba Cloud lain:

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

Untuk informasi lebih lanjut tentang opsi umum, lihat Opsi umum.