All Products
Search

This Product

    :get-object

    Document Center

    :get-object

    Last Updated:Apr 22, 2026

    Mengunduh objek dari bucket.

    Usage notes

    • Secara default, operasi API GetObject dapat diakses melalui HTTP dan HTTPS. Untuk membatasi akses hanya melalui HTTPS, gunakan Bucket Policy. Untuk informasi selengkapnya, lihat Configure bucket policies to authorize other users to access OSS resources.

    • Jika objek berada dalam kelas penyimpanan Archive, Anda harus terlebih dahulu memulihkannya dengan mengirim permintaan RestoreObject. Pastikan permintaan tersebut tidak mengalami timeout.

    Permissions

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

    API

    Action

    Description

    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.

    Command syntax

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

    Parameter

    Type

    Description

    --accept-encoding

    string

    Menentukan jenis encoding client.

    --bucket

    string

    Nama bucket.

    --if-match

    string

    Jika ETag yang ditentukan sesuai dengan ETag objek, OSS mengembalikan metadata objek dan kode status 200 OK. Jika tidak, OSS mengembalikan error 412 Precondition Failed.

    --if-modified-since

    string

    Jika waktu yang ditentukan lebih awal daripada waktu modifikasi terakhir objek, OSS mengembalikan metadata objek dan kode status 200 OK. Jika tidak, OSS mengembalikan kode status 304 Not Modified.

    --if-none-match

    string

    Jika ETag yang ditentukan tidak sesuai dengan ETag objek, OSS mengembalikan metadata objek dan kode status 200 OK. Jika tidak, OSS mengembalikan kode status 304 Not Modified.

    --if-unmodified-since

    string

    Jika waktu yang ditentukan sama dengan atau lebih baru daripada waktu modifikasi terakhir objek, OSS mengembalikan metadata objek dan kode status 200 OK. Jika tidak, OSS mengembalikan error 412 Precondition Failed.

    --key

    string

    Jalur lengkap objek.

    --range

    stringArray

    Rentang byte objek yang akan diambil.

    --response-cache-control

    string

    Header Cache-Control yang dikembalikan dalam respons.

    --response-content-disposition

    string

    Header Content-Disposition yang dikembalikan dalam respons.

    --response-content-encoding

    string

    Header Content-Encoding yang dikembalikan dalam respons.

    --response-content-language

    string

    Header Content-Language yang dikembalikan dalam respons.

    --response-expires

    string

    Header Expires yang dikembalikan dalam respons.

    --version-id

    string

    ID versi objek yang akan diambil.

    Catatan

    • Perintah get-object dibangun di atas operasi API GetObject. Untuk informasi selengkapnya mengenai parameter operasi API tersebut, lihat GetObject.

    • Untuk opsi baris perintah global yang didukung, lihat Global command-line options.

    Examples

    • Ambil objek exampleobject dari bucket examplebucket.

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

    • Ambil objek exampleobject dengan ID versi 123 dari bucket examplebucket.

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

    • Ambil rentang tertentu dari objek exampleobject dari bucket examplebucket.

      ossutil api get-object --bucket examplebucket --key exampleobject --range bytes=1-10

    • Ambil objek exampleobject dari bucket examplebucket jika waktu modifikasi exampleobject setelah Mon, 11 May 2020 08:16:23 GMT.

      ossutil api get-object --bucket examplebucket --key exampleobject --if-modified-since "Mon, 11 May 2020 08:16:23 GMT"

    • Ambil exampleobject dari bucket examplebucket. Objek dikembalikan jika ETag dari exampleobject sama dengan 123.

      ossutil api get-object --bucket examplebucket --key exampleobject --if-match 123

    • Ambil exampleobject dari bucket examplebucket dan transfer respons dengan kompresi Gzip.

      ossutil api get-object --bucket examplebucket --key exampleobject --accept-encoding gzip

    API reference

    Perintah ini dibangun di atas API RESTful GetObject. Untuk penyesuaian lebih lanjut, Anda dapat membuat permintaan API langsung, yang mengharuskan Anda menulis kode untuk menghitung signature. Untuk informasi selengkapnya, lihat GetObject.