cp（拷貝檔案）

參數

類型

說明

src_bucket

string

源Bucket名稱。

src_prefix

string

源Bucket下的某個檔案目錄或指定首碼。

dest_bucket

string

目標Bucket名稱。

dest_prefix

string

目標Bucket下的某個檔案目錄或指定首碼。

--acl

string

對象的存取權限。取值：

• private：私人。

• public-read：公用讀取。

• public-read-write：公用讀寫。

• default：繼承Bucket。

--bandwidth-limit

SizeSuffix

用於限制網路頻寬，控制資料轉送的速率。最小值為1024 B/s。單位預設為B/s。

配置此參數時，可以根據需要為頻寬值指定單位，可選單位包括B（位元組）、K（KB）、M（MB）和G（吉位元組）。例如 50 M表示頻寬節流設定為50 MB/s。

--bigfile-threshold

SizeSuffix

開啟大檔案分區上傳、下載或拷貝的閾值（預設值104857600）。

--cache-control

string

指定該對象被下載時網頁的緩衝行為。

--checkers

int

並行啟動並執行檢查器數量（預設值為16）。

--checkpoint-dir

string

斷點續傳資訊的指定目錄（預設值.ossutil_checkpoint/）。

--checksum

/

僅拷貝檔案大小和校正和（如果存在）不一致的源檔案，僅當對象間拷貝有效。

--content-disposition

string

指定對象的展示形式。

--content-encoding

string

聲明對象的編碼方式。

--content-type

string

對象的內容類型。

--copy-props

string

用於設定對象間拷貝時的屬性和標籤複製規則，支援以下三種設定：

• default（預設值）：同時拷貝對象屬性和標籤。對象屬性包括content-type、content-language、content-encoding、content-disposition、cache-control、expires和metadata（自訂中繼資料）。

• metadata：只拷貝對象屬性。

• none：只複製資料，忽略掉對象屬性和標籤。

-d, --dirs

string

處理目前的目錄下的檔案和子目錄，而非遞迴處理所有子目錄下的所有檔案。

--encoding-type

string

輸入的對象名或檔案名稱的編碼方式。取值：url。

--end-with

string

按字母排序，返回設定值之前的對象，包含設定值。

--exclude

stringArray

路徑或檔案名稱的排除規則。

--exclude-from

stringArray

從規則檔案裡讀取排除規則。

--expires

string

指定緩衝內容的絕對到期時間。

--files-from

stringArray

從檔案中讀取源檔案名稱列表，忽略空行或注釋行。僅適用於過濾情境。

--files-from-raw

stringArray

從檔案中讀取源檔案名稱列表。僅適用於過濾情境。

--filter

stringArray

路徑或檔案名稱過濾規則。

--filter-from

stringArray

從規則檔案讀取過濾規則。

-f, --force

/

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

--ignore-existing

/

跳過已存在的目標檔案。

--include

stringArray

路徑或檔案名稱的包含規則。

--include-from

stringArray

從規則檔案裡讀取包含規則。

-j, --job

int

並發任務數，預設值為 3。

--list-objects

/

使用ListObjects介面列舉對象。

--max-size

SizeSuffix

限制傳輸的最大檔案大小，預設是位元組，或單位尾碼形式B|K|M|G|T|P，1K(KiB)=1024B。

--metadata

strings

指定對象的使用者中繼資料，使用key=value格式。

--metadata-directive

string

指定如何設定目標對象的中繼資料。取值：

• COPY

• REPLACE

--metadata-exclude

stringArray

對象中繼資料的排除規則。

--metadata-filter

stringArray

對象中繼資料過濾規則。

--metadata-filter-from

stringArray

從規則檔案讀取對象中繼資料過濾規則。

--metadata-include

stringArray

對象中繼資料的包含規則。

--min-age

Duration

僅拷貝修改時間在指定時間間隔前的檔案，預設單位是秒，可以使用單位尾碼形式。例如 1h，表示1小時。

--max-age

Duration

僅拷貝修改時間在指定時間間隔內的檔案，預設單位是秒，可以使用單位尾碼形式。例如 1h，表示1小時。

--min-mtime

Time

僅拷貝修改時間在指定時間之後的檔案，時間格式：UTC時間。例如2006-01-02T15:04:05。

--max-mtime

Time

僅拷貝修改時間在指定時間之前的檔案，時間格式：UTC時間，例如 2006-01-02T15:04:05。

--min-size

SizeSuffix

限制傳輸的最小檔案大小，預設是位元組，或單位尾碼形式B|K|M|G|T|P，1K(KiB)=1024B。

--no-progress

/

不顯示進度條。

--no-error-report

/

批處理時不建置錯誤報告檔案

--output-dir

string

指定批處理過程中產生的錯誤報表檔案所在的目錄（預設為 ossutil_output）

--page-size

int

批量拷貝時分頁列舉的對象的最大值（預設值1000），取值範圍1~1000。

--parallel

int

單檔案內部操作的並發任務數。

--part-size

SizeSuffix

分區大小，預設情況下根據檔案大小自行計算合適的分區大小值。取值範圍100KiB~5GiB。

-r, --recursive

/

遞迴進行操作。當指定該選項時，命令會對儲存空間下所有合格對象進行操作，否則只對路徑指定的對象進行操作。

--request-payer

string

請求的支付方式，如果為要求者付費模式，請設定該值。取值：requester。

--size-only

/

僅拷貝檔案大小不一致的源檔案。

--start-after

string

按字母排序，返回設定值之後的對象，不包含設定值。

--storage-class

string

對象的儲存類型, 取值：

• Standard：標準儲存。

• IA：低頻儲存。

• Archive：Archive Storage。

• ColdArchive：冷Archive Storage。

• DeepColdArchive：深度冷Archive Storage。

--tagging

string

指定對象的標籤，使用key=value格式。

--tagging-directive

string

指定如何設定目標對象的標籤。取值：

• COPY

• REPLACE

-u, --update

/

跳過目標端已存在且修改時間比源檔案更新的檔案。

--version-id

string

指定對象的版本 ID（VersionId）。