Object Storage Service：cp（下載檔案）

API Action

說明

oss:GetObject

下載Object。

oss:GetObjectVersion

可選。通過 --version-id 選項指定下載源檔案的特定版本時，需要此許可權。

kms:GenerateDataKey

可選。下載的Object涉及KMS伺服器端加密時，需要此許可權。

kms:Decrypt

oss:ListObjects

可選。批量下載檔案（遞迴操作）時，需要授予此操作的許可權。

參數

說明

cloud_url

OSS檔案路徑，格式為oss://bucket[/prefix]。如oss://examplebucket/examplefile.txt。

file_url

本地檔案路徑。如果目標是目錄，需以路徑分隔字元（/ 或 \）結尾。如Linux系統檔案路徑/localfolder/examplefile.txt，Windows系統檔案路徑D:\localfolder\examplefile.txt。

-r, --recursive

遞迴操作。當指定該選項時，ossutil會對Bucket下所有合格Object進行操作，否則只對指定的單個Object進行操作。

-f --force

強制操作，不進行詢問提示。

-u，--update

只有當目標檔案不存在，或源檔案的最後修改時間晚於目標檔案時，ossutil才會執行下載操作。

--maxdownspeed

最大下載速度，單位為KB/s。預設值為0，表示不限制下載速度。

--disable-ignore-error

大量操作時不忽略錯誤。

--only-current-dir

僅下載目前的目錄下的檔案，忽略子目錄及子目錄下的檔案。

--bigfile-threshold

設定斷點續傳檔案的大小閾值，單位為位元組。

預設值：100 MB

取值範圍：0~9223372036854775807

--part-size

設定分區大小，單位為位元組。預設情況下ossutil會根據檔案大小自行計算合適的分區大小值。

取值範圍：1~9223372036854775807

--checkpoint-dir

指定斷點續傳記錄資訊所在的目錄。斷點續傳操作失敗時，ossutil會自動建立名為.ossutil_checkpoint的目錄，並在該目錄下記錄checkpoint資訊，斷點續傳成功後會刪除該目錄。如果指定了該選項，請確保指定的目錄可以被刪除。

--range

下載目標檔案的指定欄位，並儲存為一個新的檔案，欄位從0開始編號。

• 指定區間

  例如指定為3-9，表示下載檔案的第3個位元組到第9個位元組（包含第3和第9位元組）。

• 指定開始位置

  例如指定為3-，表示從第3個位元組開始到檔案結尾（包含第3個位元組）。

• 指定結束位置

  例如指定為-9，表示從0位元組到第9個位元組（包含第9個位元組）。

--encoding-type

檔案名稱的編碼方式。取值為url。如果不指定該選項，則表示檔案名稱未經過編碼。

--include

包含符合指定條件的所有檔案。

更多資訊，請參見include和exclude選項。

--exclude

不包含符合指定條件的檔案。

更多資訊，請參見include和exclude選項。

--meta

設定檔案的中繼資料，格式為header:value#header:value，樣本為Cache-Control:no-cache#Content-Encoding:gzip。有關中繼資料的介紹，請參見set-meta（管理檔案中繼資料）。

--acl

檔案的讀寫權限ACL。取值如下：

• default（預設值）：繼承Bucket的讀寫權限。

• private：只有該Bucket的擁有者可以對該Bucket內的檔案進行讀寫操作，其他人無法訪問該Bucket內的檔案。

• public-read：只有Bucket擁有者可以對該Bucket內的檔案進行寫操作，其他使用者（包括匿名訪問者）可以對該Bucket中的檔案進行讀操作。這有可能造成資料的外泄以及費用激增，請謹慎操作。

• public-read-write：任何人（包括匿名訪問者）都可以對該Bucket內檔案進行讀寫操作。這有可能造成資料的外泄以及費用激增，如果被人惡意寫入違法資訊還可能會侵害合法權益。除特殊情境外，不建議配置公用讀寫許可權。

--snapshot-path

指定儲存下載檔案時的快照資訊所在的目錄。在下一次下載檔案時，ossutil會讀取指定目錄下的快照資訊進行增量下載。

--disable-crc64

關閉CRC64資料校正。預設情況下，ossutil進行資料轉送時都會開啟CRC64校正。

--payer

請求的支付方式。如果希望訪問指定路徑下的資源產生的流量、請求次數等費用由要求者支付，請將此選項的值設定為requester。

--partition-download

用於分區下載。該選項取值格式為分區編號：總分區數。例如1：5，表示當前ossutil下載分區1，總共有5個分區。分區號從1開始編號，Object的分區規則由工具內部演算法決定。通過該選項將待下載的Object分成多個分區，並由多個ossutil命令並行下載，各個ossutil命令下載各自的分區。

-j，--job

多檔案操作時的並發任務數，預設值為3，取值範圍為1~10000。

--parallel

單檔案操作時的並發任務數，取值範圍為1~10000。 如果不設定此選項，預設由ossutil根據操作類型和檔案大小自行決定。

--version-id

下載指定版本的檔案，--version-id選項僅支援在已開啟版本控制的Bucket內使用。開啟Bucket版本控制命令請參見bucket-versioning（版本控制）。

--start-time

Unix時間戳記。如果輸入這個選項，最後更新時間早於該時間的Object會被忽略。

--end-time

Unix時間戳記。如果使用該選項，則最後更新時間晚於通過此選項指定時間的Object會被忽略。