如何通過RubySDK實現不同Bucket間的檔案拷貝 - Object Storage Service

本文介紹如何將源儲存空間（Bucket）中的檔案（Object）拷貝到同一地區下相同或不同目標Bucket。

注意事項

本文以華東1（杭州）外網Endpoint為例。如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS，請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係，請參見訪問網域名稱和資料中心。
本文以從環境變數讀取存取憑證為例。如何配置訪問憑證，請參見Java配置訪問憑證。
本文以OSS網域名稱建立OSSClient為例。如果您希望通過自訂網域名、STS等方式建立OSSClient，請參見建立OSSClient。
拷貝檔案時，您必須擁有源檔案的讀許可權及目標Bucket的讀寫權限。
拷貝檔案時，您需要確保源Bucket和目標Bucket均未設定合規保留原則，否則報錯The object you specified is immutable.。
不支援跨地區拷貝。例如不能將華東1（杭州）地區儲存空間中的檔案拷貝到華北1（青島）地區。

範例程式碼

使用bucket.copy_object拷貝一個檔案，並通過:meta_directive參數指定檔案中繼資料。拷貝時對檔案中繼資料的處理有以下兩種方式：

如果沒有指定meta參數，則拷貝後的檔案中繼資料與源檔案相同。
如果指定了meta參數，則拷貝後的檔案將使用新的中繼資料覆蓋源檔案的中繼資料。

以下代碼用於拷貝檔案：

require 'aliyun/oss'
client = Aliyun::OSS::Client.new(
  # 填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
  # 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
  access_key_id: ENV['OSS_ACCESS_KEY_ID'],
  access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
)

# 填寫Bucket名稱，例如examplebucket。
bucket = client.get_bucket('examplebucket')

# 拷貝檔案並拷貝檔案中繼資料。
bucket.copy_object(
  # 以將srcobject.txt拷貝為destobject.txt為例。
  'destobject.txt', 'srcobject.txt',
  :meta_directive => Aliyun::OSS::MetaDirective::COPY)

# 拷貝檔案並覆蓋檔案中繼資料。
bucket.copy_object(
  'destobject.txt', 'srcobject.txt',
  :metas => {'year' => '2017'},
  :meta_directive => Aliyun::OSS::MetaDirective::REPLACE)

Object Storage Service：Ruby拷貝檔案

注意事項

範例程式碼

相關文檔