cara menginisialisasi ruby sdk - Object Storage Service

OSSClient berfungsi sebagai klien Object Storage Service (OSS) SDK untuk Ruby guna mengelola sumber daya OSS seperti bucket dan objek. Sebelum menggunakan OSS SDK untuk Ruby guna mengirim permintaan API, Anda harus membuat instans OSSClient dan menyesuaikan pengaturan default sesuai kebutuhan.

Buat instance OSSClient

Anda dapat menggunakan salah satu metode berikut untuk membuat instance OSSClient:

Buat instans OSSClient menggunakan endpoint OSS

Kode berikut menunjukkan contoh pembuatan instans OSSClient menggunakan endpoint OSS:

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  # Endpoint diatur ke China (Hangzhou) dalam contoh ini. Tentukan endpoint aktual untuk wilayah Anda.
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
  # Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
  access_key_id: ENV['OSS_ACCESS_KEY_ID'],
  access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
)

Buat instans OSSClient menggunakan STS

Kode berikut menunjukkan contoh pembuatan instans OSSClient menggunakan Security Token Service (STS):

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  # Endpoint diatur ke China (Hangzhou) dalam contoh ini. Tentukan endpoint aktual untuk wilayah Anda.
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
  # ID AccessKey dan rahasia AccessKey temporary yang diperoleh dari STS.
  access_key_id: 'AccessKeyId',
  access_key_secret: 'AccessKeySecret',
  # Token keamanan yang diperoleh dari STS.
  sts_token: 'SecurityToken')

Buat instans OSSClient menggunakan nama domain kustom

Kode berikut menunjukkan contoh pembuatan instans OSSClient menggunakan nama domain kustom.

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  # Gunakan nama domain kustom sebagai endpoint.
  endpoint: 'http://example.com',
  # Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
  access_key_id: ENV['OSS_ACCESS_KEY_ID'],
  access_key_secret: ENV['OSS_ACCESS_KEY_SECRET'],
  cname: true
)

Konfigurasikan instance OSSClient

Instance OSSClient mendukung parameter berikut:

Parameter	Deskripsi
cname	Menentukan apakah CNAME dapat digunakan sebagai titik akhir. true: CNAME dapat digunakan sebagai endpoint. false (nilai default): Nama kanonik (CNAME) tidak dapat digunakan sebagai Endpoint.
download_crc_enable	Menentukan apakah akan mengaktifkan CRC-64 saat Anda mengunduh objek. true: Mengaktifkan pemeriksaan redundansi siklik (CRC) selama pengunduhan file. false (default): Menonaktifkan pemeriksaan redundansi siklik saat file diunduh.
upload_crc_enable	Menentukan apakah akan mengaktifkan CRC-64 saat Anda mengunggah objek. true (default): Mengaktifkan pemeriksaan redundansi siklik untuk pengunggahan file. false: Menonaktifkan pemeriksaan redundansi siklik untuk pengunggahan file.
open_timeout	Jangka waktu timeout untuk membangun koneksi. Satuan: detik. Nilai default: 10.
read_timeout	Jangka waktu timeout untuk menunggu respons. Satuan: detik. Nilai default: 120.