All Products
Search

This Product

    Object Storage Service:read-symlink (membaca tautan simbolik)

    Document Center

    Object Storage Service:read-symlink (membaca tautan simbolik)

    Last Updated:Mar 21, 2026

    Gunakan read-symlink untuk mengambil metadata tautan simbolik di OSS, termasuk ETag-nya, waktu modifikasi terakhir, dan objek target yang ditunjuk oleh tautan tersebut.

    Prasyarat

    Sebelum memulai, pastikan Anda telah memiliki:

    • Izin oss:GetObject pada tautan simbolik tersebut. Untuk detailnya, lihat Lampirkan kebijakan kustom ke RAM user.

    • ossutil terinstal. Untuk ossutil versi 1.6.16 atau yang lebih baru, gunakan ossutil langsung sebagai nama biner. Untuk versi sebelumnya, sesuaikan nama biner berdasarkan sistem operasi Anda. Untuk detailnya, lihat Referensi perintah ossutil.

    Sintaksis perintah

    ossutil read-symlink oss://bucketname/objectname [--encoding-type <value>] [--payer <value>]
    ParameterWajibDeskripsiContoh
    bucketnameYaNama bucket.examplebucket
    objectnameYaNama tautan simbolik.test.jpg
    --encoding-typeTidakMetode pengkodean untuk nama tautan simbolik. Nilai yang valid: url. Jika tidak ditentukan, nama tidak dikodekan.url
    --payerTidakPihak yang membayar permintaan. Tetapkan ke requester ketika pemilik bucket ingin pihak peminta menanggung biaya traffic dan permintaan.requester

    Contoh

    Kueri tautan simbolik

    Perintah berikut mengambil metadata tautan simbolik bernama test.jpg di examplebucket:

    ossutil read-symlink oss://examplebucket/test.jpg

    Tanggapan sukses mencakup ETag, waktu modifikasi terakhir, dan objek target yang ditunjuk oleh tautan simbolik tersebut:

    Etag                    : 938F26218CE422CBEEE0B6543A2B2D
Last-Modified           : 2021-04-21 18:00:13 +0800 CST
X-Oss-Symlink-Target    : example.jpg
0.217317(s) elapsed

    Pada output ini, X-Oss-Symlink-Target: example.jpg menunjukkan bahwa test.jpg mengarah ke example.jpg.

    Kueri objek non-tautan simbolik

    Jika objek target bukan tautan simbolik, NotSymlink akan dikembalikan.

    Gunakan respons ini untuk memverifikasi apakah suatu objek merupakan tautan simbolik sebelum memprosesnya.

    Opsi umum

    Untuk mengakses bucket di wilayah berbeda, tambahkan -e untuk menentukan titik akhir bucket tersebut. Untuk menggunakan kredensial dari Akun Alibaba Cloud yang berbeda, tambahkan -i untuk ID AccessKey dan -k untuk Rahasia AccessKey.

    Perintah berikut mengambil metadata untuk testobject.png di testbucket, yang berada di wilayah China (Shanghai) dan dimiliki oleh akun berbeda:

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

    Untuk daftar lengkap opsi umum, lihat Opsi umum.

    Langkah selanjutnya