全部产品
Search
文档中心

Object Storage Service:Unduh objek ke file lokal (Ruby SDK)

更新时间:Nov 30, 2025

Topik ini menjelaskan cara mengunduh objek dari bucket Object Storage Service (OSS) ke file lokal.

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 Policy atau Bucket policies.

API

Action

Definition

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.

Sample code

Kode berikut menunjukkan cara mengunduh objek exampleobject.txt dari bucket examplebucket dan menyimpannya sebagai examplefile.txt di direktori D:\localpath.

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  # Wilayah China (Hangzhou) digunakan sebagai contoh. Ganti nilai ini dengan endpoint yang sebenarnya.
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
  # Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode contoh, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah dikonfigurasi.
  access_key_id: ENV['OSS_ACCESS_KEY_ID'],
  access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
)
# Tentukan nama bucket. Contoh: examplebucket.
bucket = client.get_bucket('examplebucket')
# Unduh objek ke file lokal.
bucket.get_object('exampleobject.txt', :file => 'D:\\localpath\\examplefile.txt')

References

Untuk informasi selengkapnya mengenai operasi API GetObject, lihat GetObject.