set-props(設(shè)置對象屬性)
set-props命令用于設(shè)置對象屬性,支持設(shè)置訪問權(quán)限、存儲類型、元數(shù)據(jù)和標(biāo)簽。
命令格式
ossutil set-props oss://bucket[/prefix] [flags]
參數(shù) | 類型 | 說明 |
--acl | string | 對象的訪問權(quán)限。取值:
|
--bigfile-threshold | int | 開啟大文件分片上傳、下載或拷貝的閾值(默認(rèn)值104857600)。 |
--cache-control | string | 指定該對象被下載時(shí)網(wǎng)頁的緩存行為。 |
--content-disposition | string | 指定對象的展示形式。 |
--content-encoding | string | 聲明對象的編碼方式。 |
--content-type | string | 對象的內(nèi)容類型。 |
-d, --dirs | / | 返回當(dāng)前目錄下的文件和子目錄,而非遞歸顯示所有子目錄下的所有文件。 |
--encoding-type | string | 輸入的對象名或文件名的編碼方式。取值:url。 |
--end-with | string | 按字母排序,返回設(shè)定值之前的對象,包含設(shè)定值。 |
--exclude | stringArray | 路徑或文件名的排除規(guī)則。 |
--exclude-from | stringArray | 從規(guī)則文件里讀取排除規(guī)則。 |
--expires | string | 指定緩存內(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)。 |
--list-objects | / | 使用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 test=value,test1=value1。 |
--metadata-directive | string | 元數(shù)據(jù)的修改指令。取值:
|
--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ì)對存儲空間下所有符合條件的對象進(jìn)行操作,否則只對路徑指定的對象進(jìn)行操作。 |
--request-payer | string | 請求的支付方式,如果為請求者付費(fèi)模式,請?jiān)O(shè)置該值。取值:requester。 |
--start-after | string | 按字母排序,返回設(shè)定值之后的對象,不包含設(shè)定值。 |
--storage-class | string | 對象的存儲類型。取值:
|
--tagging | strings | 指定對象的標(biāo)簽,使用key=value格式。 例如:--tagging tag1=value1,tag2=value2。 |
--tagging-directive | string | 標(biāo)簽的修改指令。取值:
|
--version-id | string | 對象的版本標(biāo)識。 |
--list-format | string | 列表文件的格式,取值:plain、inventory。 |
--list-manifest-from | string | 從文件中讀取列表文件格式的描述信息,當(dāng)列表文件格式為inventory時(shí),需要設(shè)置該參數(shù)。 |
關(guān)于支持的全局命令行選項(xiàng),請參見支持的全局命令行選項(xiàng)。
使用示例
設(shè)置對象的訪問權(quán)限為私有。
ossutil set-props oss://examplebucket/exampleobject.txt --acl private
設(shè)置對象的存儲類型為歸檔存儲。
ossutil set-props oss://examplebucket/exampleobject.txt --storage-class Archive
對*.txt對象,修改content-type為text/plain。
ossutil set-props oss://bucket/prefix --content-type text/plain --include *.txt --metadata-directive update -r
設(shè)置對象的標(biāo)簽。
ossutil set-props oss://examplebucket/exampleobject.txt --tagging tag1=value1 --tagging-directive update
從列表設(shè)置對象的屬性。
說明list列表文件里的一行表示一個(gè)對象,且采用oss路徑格式,即oss://{bucket}/{key},如list.txt文件:
oss://examplebucket/key1 oss://examplebucket/key2
ossutil set-props list://list.txt
從清單文件設(shè)置對象的屬性。
說明執(zhí)行清單任務(wù)后,會(huì)在清單結(jié)果中生成 一個(gè) csv.gz 和 manifest.json 文件。從清單文件設(shè)置對象需要用到這兩個(gè)文件。
ossutil set-props list://ca8007fc-4123-493e-9a01-dd1511fbac54.csv.gz --list-format inventory --list-manifest-from manifest.json