本文介紹如何將源儲存空間（Bucket）中的檔案（Object）拷貝到同一地區下相同或不同目標Bucket。
注意事項
本文以華東1（杭州）外網Endpoint為例。如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS，請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係，請參見地區和Endpoint。
本文以從環境變數讀取存取憑證為例。如何配置訪問憑證，請參見Java配置訪問憑證。
本文以OSS網域名稱建立OSSClient為例。如果您希望通過自訂網域名、STS等方式建立OSSClient，請參見常見情境配置樣本。
拷貝檔案時，您必須擁有源檔案的讀許可權及目標Bucket的讀寫權限。
拷貝檔案時，您需要確保源Bucket和目標Bucket均未設定合規保留原則，否則報錯The object you specified is immutable.。
不支援跨地區拷貝。例如不能將華東1（杭州）地區儲存空間中的檔案拷貝到華北1（青島）地區。
許可權說明
阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權，需要阿里雲帳號或帳號管理員通過RAM Policy或Bucket Policy授予操作許可權。
API | Action | 說明 |
CopyObject |
| 拷貝同一地區下相同或不同儲存空間（Bucket）之間的檔案（Object）。 |
| ||
| 如果通過versionId指定拷貝的源Object版本，還需要此操作的許可權。 | |
| 如果通過x-oss-tagging拷貝Object的標籤，則需要此操作的許可權。 | |
| ||
| 如果通過versionId指定拷貝的源Object特定版本的Object的標籤，還需要此操作的許可權。 | |
| 拷貝Object時，如果目標Object的中繼資料套件含X-Oss-Server-Side-Encryption: KMS，則需要這兩個許可權。 | |
|
範例程式碼
使用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) 相關文檔
關於拷貝檔案的API介面說明，請參見CopyObject。