get-object - - 阿里云

Meminta objek dalam sebuah bucket.

Catatan Penggunaan

Secara default, operasi GetObject mendukung akses melalui HTTP dan HTTPS. Untuk membatasi akses ke bucket hanya melalui HTTPS, konfigurasikan kebijakan bucket untuk menentukan metode akses. Untuk informasi lebih lanjut, lihat Konfigurasi kebijakan bucket untuk mengizinkan pengguna lain mengakses sumber daya OSS.
Jika kelas penyimpanan objek yang ingin Anda periksa adalah Arsip, Anda harus mengirimkan permintaan RestoreObject untuk memulihkan objek sebelum memanggil operasi GetObject. Pastikan bahwa permintaan tidak mengalami timeout.

Deskripsi Izin

Secara default, akun Alibaba Cloud memiliki izin penuh. Pengguna RAM atau Peran RAM di bawah akun Alibaba Cloud awalnya tidak memiliki izin apa pun. Akun Alibaba Cloud atau administrator harus memberikan izin operasi melalui Kebijakan RAM atau Kebijakan Bucket.

API	Aksi	Definisi
GetObject	`oss:GetObject`	Mengunduh objek.
	`oss:GetObjectVersion`	Saat mengunduh objek, jika Anda menentukan versi objek melalui versionId, izin ini diperlukan.
	`kms:Decrypt`	Saat mengunduh objek, jika metadata objek berisi X-Oss-Server-Side-Encryption: KMS, izin ini diperlukan.

Sintaks Perintah

ossutil api get-object --bucket value --key value [flags]

Parameter	Tipe	Deskripsi
--accept-encoding	string	Metode enkode di sisi klien.
--bucket	string	Nama bucket.
--if-match	string	Jika ETag yang ditentukan dalam permintaan cocok dengan ETag objek, metadata objek dan 200 OK dikembalikan. Jika tidak, 412 Precondition Failed dikembalikan.
--if-modified-since	string	Jika waktu yang ditentukan lebih awal dari waktu modifikasi terakhir objek, metadata objek dan 200 OK dikembalikan. Jika tidak, 304 Not Modified dikembalikan.
--if-none-match	string	Jika ETag input tidak cocok dengan ETag objek, metadata objek dan 200 OK dikembalikan. Jika tidak, 304 Not Modified dikembalikan.
--if-unmodified-since	string	Jika waktu yang ditentukan sama dengan atau lebih baru dari waktu modifikasi terakhir objek, metadata objek dan 200 OK dikembalikan. Jika tidak, 412 Precondition Failed dikembalikan.
--key	string	Path lengkap objek.
--range	stringArray	Rentang data yang ingin Anda periksa.
--response-cache-control	string	Header Cache-control yang akan dikembalikan dalam respons.
--response-content-disposition	string	Header Content-disposition yang akan dikembalikan dalam respons.
--response-content-encoding	string	Header Content-encoding yang akan dikembalikan dalam respons.
--response-content-language	string	Header Content-language yang akan dikembalikan dalam respons.
--response-expires	string	Header Expires yang akan dikembalikan dalam respons.
--version-id	string	ID versi objek yang akan dipulihkan.

Catatan

Perintah get-object sesuai dengan operasi GetObject. Untuk informasi lebih lanjut tentang parameter dalam operasi GetObject, lihat GetObject.
Untuk informasi lebih lanjut tentang opsi baris perintah global yang didukung, lihat Opsi baris perintah global.

Contoh

Meminta objek exampleobject dalam bucket examplebucket.

ossutil api get-object --bucket examplebucket --key exampleobject

Meminta objek exampleobject dengan ID versi 123 dalam bucket examplebucket.

ossutil api get-object --bucket examplebucket --key exampleobject --version-id 123

Meminta rentang data tertentu (byte 1 hingga byte 10) dari objek exampleobject dalam bucket examplebucket.
```
ossutil api get-object --bucket examplebucket --key exampleobject --range bytes=1-10
```
Meminta objek exampleobject dalam bucket examplebucket. Jika waktu modifikasi terakhir objek exampleobject lebih awal dari Mon, 11 May 2020 08:16:23 GMT, objek tersebut dikembalikan.
```
ossutil api get-object --bucket examplebucket --key exampleobject --if-modified-since "Mon, 11 May 2020 08:16:23 GMT"
```
Meminta objek exampleobject dalam bucket examplebucket. Jika ETag dari objek exampleobject adalah 123, objek tersebut dikembalikan.
```
ossutil api get-object --bucket examplebucket --key exampleobject --if-match 123
```
Meminta objek exampleobject dalam bucket examplebucket dan mengembalikan objek dalam format GZIP.
```
ossutil api get-object --bucket examplebucket --key exampleobject --accept-encoding gzip
```

Operasi API Terkait

Metode yang dijelaskan di atas pada dasarnya diimplementasikan berdasarkan API RESTful, yang dapat Anda panggil langsung jika bisnis Anda memerlukan tingkat penyesuaian yang tinggi. Untuk memanggil API secara langsung, Anda harus menyertakan perhitungan tanda tangan dalam kode Anda. Untuk informasi lebih lanjut, lihat GetObject.