參數(shù)

類型

說明

source

string

本地文件路徑。支持相對路徑、絕對路徑和-，當(dāng)為-時(shí)，表示從標(biāo)準(zhǔn)輸入讀入。

dest

string

目標(biāo)Bucket下的文件路徑。例如：oss://bucket[/prefix]。

--acl

string

對象的訪問權(quán)限。取值：

• private：私有。

• public-read：公共讀。

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

• default：繼承Bucket。

--bigfile-threshold

int

開啟大文件分片上傳、下載或拷貝的閾值（默認(rèn)值104857600）。

--cache-control

string

指定該對象被下載時(shí)網(wǎng)頁的緩存行為。

--content-disposition

string

指定對象的展示形式。

--content-encoding

string

聲明對象的編碼方式。

--content-type

string

對象的內(nèi)容類型。

--copy-props

string

確定從源對象上傳哪些屬性，取值：

• none

• metadata

• default

-d, --dirs

string

返回當(dāng)前目錄下的文件和子目錄，而非遞歸顯示所有子目錄下的所有文件。

--encoding-type

string

輸入的對象名或文件名的編碼方式。取值：url。

--end-with

string

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

--exclude

stringArray

路徑或文件名的排除規(guī)則。

--exclude-from

stringArray

從規(guī)則文件里讀取排除規(guī)則。

--expires

stringArray

指定緩存內(nèi)容的絕對過期時(shí)間。

--files-from

stringArray

從文件中讀取源文件名列表，忽略空行或注釋行。

--files-from-raw

stringArray

從文件中讀取源文件名列表。

--filter

stringArray

路徑或文件名過濾規(guī)則。

--filter-from

stringArray

從規(guī)則文件讀取過濾規(guī)則。

-f, --force

/

強(qiáng)制操作，不進(jìn)行詢問提示。

--include

stringArray

路徑或文件名的包含規(guī)則。

--include-from

stringArray

從規(guī)則文件里讀取包含規(guī)則。

-j, --job

int

多文件操作時(shí)的并發(fā)任務(wù)數(shù)（默認(rèn)值3）。

--listObjects

/

使用ListObjects接口列舉對象。

--max-age

Duration

不傳輸任何比此更早的文件。默認(rèn)是秒，或單位后綴形式 ms|s|m|h|d|w|M|y（默認(rèn)值off）。

--max-mtime

Time

不傳輸任何比此更新的文件，UTC時(shí)間格式 （默認(rèn)值off）。

--max-size

SizeSuffix

限制傳輸?shù)淖畲笪募笮。J(rèn)是字節(jié)，或單位后綴形式B|K|M|G|T|P，1K(KiB)=1024B。

--metadata

strings

指定對象的用戶元數(shù)據(jù)，使用key=value格式。

--metadata-directive

string

指定如何設(shè)置目標(biāo)對象的元數(shù)據(jù)。取值：

• COPY

• REPLACE

--metadata-exclude

stringArray

對象元數(shù)據(jù)的排除規(guī)則。

--metadata-filter

stringArray

對象元數(shù)據(jù)過濾規(guī)則。

--metadata-filter-from

stringArray

從規(guī)則文件讀取對象元數(shù)據(jù)過濾規(guī)則。

--metadata-include

stringArray

對象元數(shù)據(jù)的包含規(guī)則。

--min-age

Duration

不傳輸任何比此更新的文件。默認(rèn)是秒，或單位后綴形式 ms|s|m|h|d|w|M|y（默認(rèn)值off）。

--min-mtime

Time

不傳輸任何比此更早的文件，UTC時(shí)間格式（默認(rèn)值off）。

--min-size

SizeSuffix

限制傳輸?shù)淖钚∥募笮。J(rèn)是字節(jié)，或單位后綴形式B|K|M|G|T|P，1K(KiB)=1024B。

--no-progress

/

不現(xiàn)顯示度條。

--page-size

int

返回對象或文件的最大數(shù)（默認(rèn)值1000），取值范圍1~1000。

--parallel

int

單文件內(nèi)部操作的并發(fā)任務(wù)數(shù)。

--part-size

SizeSuffix

分片大小，默認(rèn)情況下根據(jù)文件大小自行計(jì)算合適的分片大小值。取值范圍100Ki~5Gi。

-r, --recursive

/

遞歸進(jìn)行操作。當(dāng)指定該選項(xiàng)時(shí)，命令會(huì)對存儲(chǔ)空間下所有符合條件的對象進(jìn)行操作，否則只對路徑指定的對象進(jìn)行操作。

--request-payer

string

請求的支付方式，如果為請求者付費(fèi)模式，請?jiān)O(shè)置該值。取值：requester。

--size-only

/

僅上傳文件大小不一致的源文件。

--storage-class

string

對象的存儲(chǔ)類型, 取值：

• Standard：標(biāo)準(zhǔn)存儲(chǔ)。

• IA：低頻存儲(chǔ)。

• Archive：歸檔存儲(chǔ)。

• ColdArchive：冷歸檔存儲(chǔ)。

• DeepColdArchive：深度冷歸檔存儲(chǔ)。

--tagging

strings

指定對象的標(biāo)簽，使用key=value格式。

--tagging-directive

string

指定如何設(shè)置目標(biāo)對象的標(biāo)簽。取值：

• COPY

• REPLACE

-u, --update

/

僅上傳源文件新于目標(biāo)文件。

--ignore-existing

/

跳過已存在的目標(biāo)文件。