Gunakan perintah sign untuk menghasilkan dan berbagi URL yang ditandatangani - Object Storage Service

Jalankan perintah sign untuk menghasilkan URL yang ditandatangani bagi objek OSS dan membagikannya kepada pengguna pihak ketiga. URL tersebut memberikan akses terbatas waktu untuk mengunduh atau melihat pratinjau objek, terlepas dari daftar kontrol akses (ACL), kebijakan bucket, atau kebijakan RAM objek tersebut.

Penting

Untuk ossutil V1.6.16 dan versi lebih baru, gunakan ossutil langsung sebagai nama biner. Untuk versi sebelumnya, tentukan nama biner yang sesuai dengan sistem operasi Anda. Untuk detailnya, lihat referensi perintah ossutil.

Sintaks

ossutil sign cloud_url
[--timeout <value>]
[--version-id <value>]
[--trafic-limit <value>]
[--disable-encode-slash]
[--payer <value>]
[--query-param <value>]

Parameter

Parameter	Deskripsi
`cloud_url`	Jalur lengkap ke objek, termasuk nama bucket. Format: `oss://bucket/object`
`--timeout`	Periode validitas URL yang ditandatangani, dalam detik. Nilai default: `60`. Jumlah dari timestamp Unix saat ini dan nilai ini tidak boleh melebihi `9223372036854775807`. Misalnya, jika timestamp saat ini adalah `1643341269`, nilai maksimumnya adalah `9223372035211434538`.
`--version-id`	ID versi objek. Hanya berlaku untuk objek di bucket yang telah mengaktifkan atau menangguhkan versioning.
`--trafic-limit`	Kecepatan maksimum untuk mengakses objek melalui HTTP, dalam bit/detik. Nilai default: `0` (tanpa batas). Nilai yang valid: `819200`-`838860800` (100 KB/detik–100 MB/detik).
`--disable-encode-slash`	Melewati encode URL untuk garis miring maju (`/`) dalam `cloud_url`.
`--payer`	Pihak yang membayar permintaan. Atur ke `requester` untuk mengaktifkan requester-pays.
`--query-param`	Parameter kueri tambahan yang disematkan dalam URL yang ditandatangani. Parameter yang didukung: `x-oss-process`, `x-oss-traffic-limit`, `response-content-language`, `response-expires`, `response-cache-control`, `response-content-disposition`, `response-content-encoding`, `x-oss-ac-source-ip`, `x-oss-ac-subnet-mask`, `x-oss-ac-vpc-id`, dan `x-oss-ac-forward-allow`. Untuk detail parameter, lihat Buat URL yang ditandatangani menggunakan signature V1 dan GetObject. Catatan Tersedia di ossutil V1.7.15 dan versi lebih baru.

Contoh

Setelah salah satu perintah berikut berhasil dijalankan, output-nya mirip dengan contoh di bawah. Output mencakup waktu yang digunakan untuk menghasilkan URL yang ditandatangani, periode validitas URL, dan informasi signature dalam URL:

https://examplebucket.ss-cn-hangzhou.aliyuncs.com/exampleobject.png?Expires=1608282224&OSSAccessKeyId=LTAI****************&Signature=jo4%2FGykfuc1A4fvyvKRpRyymYH****
0.368676(s) elapsed

Menghasilkan URL yang ditandatangani dengan periode validitas default

Perintah berikut menghasilkan URL yang ditandatangani untuk exampleobject.png di examplebucket. URL tersebut berlaku selama 60 detik (nilai default).

ossutil sign oss://examplebucket/exampleobject.png

Menghasilkan URL yang ditandatangani dengan periode validitas kustom

Perintah berikut menghasilkan URL yang ditandatangani dengan masa berlaku 3.600 detik.

ossutil sign oss://examplebucket/exampleobject.png --timeout 3600

Menghasilkan URL yang ditandatangani dengan periode validitas dan batas kecepatan unduh

Perintah berikut menghasilkan URL yang ditandatangani dengan masa berlaku 7.200 detik dan kecepatan akses maksimum 100 MB/detik (838.860.800 bit/detik).

ossutil sign oss://examplebucket/exampleobject.png --timeout 7200 --trafic-limit 838860800

Menghasilkan URL yang ditandatangani untuk versi objek tertentu

Perintah berikut menghasilkan URL yang ditandatangani untuk versi tertentu dari exampleobject.jpg, dengan masa berlaku 1.800 detik.

ossutil sign oss://examplebucket/exampleobject.jpg --timeout 1800 --version-id CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3****

Menghasilkan URL yang ditandatangani untuk gambar dengan parameter pemrosesan

Perintah berikut mengubah ukuran exampleobject.jpg menjadi 100x100 piksel, memutarnya 90 derajat, lalu menghasilkan URL yang ditandatangani untuk gambar hasil pemrosesan tersebut.

ossutil sign oss://examplebucket/exampleobject.jpg --query-param x-oss-process:image/resize,m_fixed,w_100,h_100/rotate,90

Menghasilkan URL yang ditandatangani untuk gambar hasil pemrosesan dengan batas kecepatan

Perintah berikut menerapkan pemrosesan gambar yang sama seperti di atas dan membatasi kecepatan akses menjadi 100 KB/detik (819.200 bit/detik).

ossutil sign oss://examplebucket/exampleobject.jpg --query-param x-oss-process:image/resize,m_fixed,w_100,h_100/rotate,90 --query-param x-oss-traffic-limit:819200

Opsi umum

Untuk mengakses bucket di wilayah berbeda atau di bawah Akun Alibaba Cloud yang berbeda, tambahkan opsi berikut:

Opsi	Deskripsi
`-e`	Endpoint wilayah tempat bucket berada
`-i`	ID AccessKey akun target
`-k`	Rahasia AccessKey akun target

Contoh: Hasilkan URL yang ditandatangani untuk exampletest.jpg di testbucket, yang berlokasi di wilayah Tiongkok (Shanghai) dan dimiliki oleh akun berbeda, dengan periode validitas 3.600 detik.

ossutil sign oss://testbucket/exampletest.jpg --timeout 3600 -e oss-cn-shanghai.aliyuncs.com -i LTAI**************** -k yourAccessKeySecret

Untuk daftar lengkap opsi umum, lihat Opsi umum.