Mengelola metadata objek menggunakan Ruby SDK - Object Storage Service

Objek yang disimpan di Object Storage Service (OSS) terdiri dari kunci, data, dan metadata objek. Metadata objek menggambarkan properti suatu objek dan mencakup header HTTP standar serta metadata yang ditentukan pengguna. Anda dapat mengatur header HTTP standar untuk menyesuaikan kebijakan permintaan HTTP, seperti kebijakan cache objek atau kebijakan unduh paksa. Selain itu, Anda juga dapat menetapkan metadata yang ditentukan pengguna untuk mengidentifikasi tujuan atau properti lain dari objek tersebut.

Penting

Dalam kit pengembangan perangkat lunak (SDK) Ruby, metadata objek direpresentasikan sebagai Hash. Kunci dan nilainya bertipe String.
Metadata objek termasuk dalam header HTTP. Protokol HTTP menetapkan bahwa header permintaan hanya boleh berisi karakter ASCII sederhana yang terlihat dan tidak boleh mengandung jeda baris.
Ukuran total seluruh metadata tidak boleh melebihi 8 KB.

Mengatur metadata objek

Anda dapat menggunakan kode berikut untuk mengatur metadata objek saat mengunggah objek.

require 'aliyun/oss'
client = Aliyun::OSS::Client.new(
  # Tentukan titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur titik akhir menjadi https://oss-cn-hangzhou.aliyuncs.com.
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
  # Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode contoh ini, 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')

# Atur metadata objek selama unggahan simple.
bucket.put_object(
  'my-object-1',
  :file => 'local-file',
  :metas => {'year' => '2016', 'people' => 'mary'})

# Atur metadata objek selama unggahan append.
bucket.append_object(
  'my-object-2', 0,
  :file => 'local-file',
  :metas => {'year' => '2016', 'people' => 'mary'})

# Atur metadata objek selama unggahan yang dapat dilanjutkan.
bucket.resumable_upload(
  'my-object',
  'local-file',
  :metas => {'year' => '2016', 'people' => 'mary'})

Ubah metadata objek

Anda dapat menggunakan kode berikut untuk memodifikasi metadata objek.

require 'aliyun/oss'
client = Aliyun::OSS::Client.new(
  # Tentukan titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur titik akhir menjadi https://oss-cn-hangzhou.aliyuncs.com.
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
   # Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode contoh ini, 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')
# Modifikasi metadata objek.
bucket.update_object_metas('my-object', {'year' => '2017'})

Referensi

Untuk informasi selengkapnya tentang pengaturan metadata objek selama unggahan simple, lihat operasi API PutObject.
Untuk informasi selengkapnya tentang modifikasi metadata objek saat menyalin objek, lihat operasi API CopyObject.