presign (generate signed URL) - Object Storage Service

Anda dapat menggunakan perintah presign untuk menghasilkan URL yang ditandatangani.

Sintaksis Perintah

ossutil presign oss://bucket[/prefix] [flags]

Parameter	Tipe	Deskripsi
-d, --dirs	/	Mengembalikan objek dan subdirektori di direktori saat ini, bukan menampilkan secara rekursif semua objek di semua subdirektori.
--encoding-type	string	Metode pengkodean yang digunakan untuk mengkode nama objek atau nama file. Nilai valid: url.
--end-with	string	Mengembalikan objek yang namanya secara alfabetis sebelum atau sama dengan nilai parameter --end-with.
--exclude	stringArray	Aturan pengecualian untuk jalur atau nama objek.
--exclude-from	stringArray	Membaca aturan pengecualian dari sebuah file.
--expires-date	Waktu	Titik waktu ketika URL yang ditandatangani kedaluwarsa.
--expires-duration	Durasi	Periode validitas URL yang ditandatangani. Periode validitas berkisar antara 1 detik hingga 1 minggu. Nilai default: 15m0s.
--files-from	stringArray	Membaca daftar nama objek sumber dari sebuah file, dengan baris kosong atau baris komentar diabaikan.
--files-from-raw	stringArray	Membaca daftar nama objek sumber dari sebuah file.
--filter	stringArray	Aturan filter untuk jalur atau nama objek.
--filter-from	stringArray	Membaca aturan filter dari sebuah file.
-f, --force	/	Memaksa operasi tanpa memerlukan konfirmasi pengguna.
--include	stringArray	Aturan inklusi untuk jalur atau nama objek.
--include-from	stringArray	Membaca aturan inklusi dari sebuah file.
--limited-num	int	Jumlah maksimum hasil yang akan dikembalikan.
--list-objects	/	Menampilkan objek dengan memanggil operasi ListObjects.
--min-age	Durasi	Hanya memproses file yang dimodifikasi sebelum interval waktu tertentu. Unit default adalah detik. Anda dapat menggunakan akhiran unit. Contohnya, 1h menunjukkan satu jam. Catatan `--min-age 1h` menunjukkan bahwa hanya file yang dimodifikasi setidaknya 1 jam yang lalu yang diproses.
--max-age	Durasi	Hanya memproses file yang dimodifikasi dalam interval waktu tertentu. Unit default adalah detik. Anda dapat menggunakan akhiran unit. Contohnya, 1h menunjukkan satu jam. Catatan `--max-age 1h` menunjukkan bahwa hanya file yang dimodifikasi dalam satu jam terakhir yang diproses.
--min-mtime	Waktu	Hanya memproses file yang dimodifikasi setelah waktu tertentu. Format waktu: UTC. Contoh: 2006-01-02T15:04:05. Catatan `--min-mtime "2006-01-02T15:04:05"` menunjukkan bahwa hanya file yang dimodifikasi setelah 2 Januari 2006, 15:04:05 yang diproses.
--max-mtime	Waktu	Hanya memproses file yang dimodifikasi sebelum waktu tertentu. Format waktu: UTC. Contoh: 2006-01-02T15:04:05.
--max-size	SizeSuffix	Ukuran maksimum file yang dapat ditransfer. Secara default, ukuran dalam byte (B). Anda dapat memberi akhiran numerik dengan unit berbasis 1024: B untuk byte, K untuk Kibibyte, M untuk Mebibyte, G untuk Gibibyte, T untuk Tebibyte, atau P untuk Pebibyte.
--metadata-exclude	stringArray	Aturan pengecualian untuk metadata objek.
--metadata-filter	stringArray	Aturan filter untuk metadata objek.
--metadata-filter-from	stringArray	Membaca aturan filter metadata dari sebuah file.
--metadata-include	stringArray	Aturan inklusi untuk metadata objek.
--min-size	SizeSuffix	Ukuran minimum file yang dapat ditransfer. Secara default, ukuran dalam byte (B). Anda dapat memberi akhiran numerik dengan unit berbasis 1024: B untuk byte, K untuk Kibibyte, M untuk Mebibyte, G untuk Gibibyte, T untuk Tebibyte, atau P untuk Pebibyte.
--page-size	int	Jumlah maksimum objek yang akan ditampilkan per halaman selama pemrosesan batch. Nilai default: 1000. Nilai valid: 1 hingga 1000.
--query-param	stringArray	Parameter kueri dalam permintaan.
-r, --recursive	/	Menentukan bahwa perintah melakukan operasi secara rekursif. Jika parameter ini ditentukan, perintah berlaku untuk semua objek yang memenuhi kondisi di bucket. Jika tidak, perintah hanya berlaku untuk objek di jalur yang ditentukan.
--request-payer	string	Pembayar permintaan. Jika pay-by-requester diaktifkan untuk bucket, atur parameter ini ke requester.
--start-after	string	Menentukan bahwa objek yang namanya secara alfabetis sebelum atau sama dengan nilai parameter --end-with dikembalikan.
--traffic-limit	int	Batas bandwidth untuk koneksi tunggal. Nilai valid: 819200 hingga 838860800.
--version-id	string	ID versi objek.

Catatan

Untuk informasi lebih lanjut, lihat Opsi baris perintah.

Contoh

Hasilkan URL yang ditandatangani untuk objek example.txt di bucket examplebucket dengan periode validitas default 15 menit.
```
ossutil presign oss://examplebucket/example.txt
```
Hasilkan URL yang ditandatangani untuk objek example.txt di bucket examplebucket dengan periode validitas 1 jam.
```
ossutil presign oss://examplebucket/example.txt --expires-duration 1h
```
Hasilkan URL yang ditandatangani untuk objek example.txt di bucket examplebucket yang tetap valid hingga 2024-06-01T12:00:00 (UTC).
```
ossutil presign oss://examplebucket/example.txt --expires-date 2024-06-01T12:00:00
```
Hasilkan URL yang ditandatangani untuk objek example.txt di bucket examplebucket yang berisi parameter pemrosesan gambar.
```
ossutil presign oss://examplebucket/example.txt --query-param x-oss-process=image/resize,m_fixed,w_100,h_100/rotate,90
```
Hasilkan URL yang ditandatangani untuk versi "123" dari objek example.txt di bucket examplebucket.
```
ossutil presign oss://examplebucket/example.txt --version-id 123
```
Hasilkan URL yang ditandatangani untuk objek di direktori "folder" di bucket examplebucket dengan periode validitas 15 menit.
```
ossutil presign oss://examplebucket/folder/ -r
```
Hasilkan URL yang ditandatangani untuk objek TXT di direktori "folder" di bucket examplebucket dengan periode validitas default 15 menit.
```
ossutil presign oss://examplebucket/folder/ -r --include "*.txt"
```