新功能

說明

全新的命令組織形式

支持多級命令。

• API級命令：ossutil api xxx。例如：ossutil api put-bucket-acl。

• 高級命令：ossutil xxx。例如：ossutil config。

基礎配置

為避免在使用ossutil時因配置項缺失導致操作失敗，請確保配置以下必要的基礎項：AccessKey ID、AccessKey Secret、地域ID。特別是地域ID，由于簽名已升級到V4版本，因此成為必需項。關于如何獲取您的地域ID，請參見OSS地域和訪問域名。

配置文件修改

支持profile概念，一個配置文件支持設置多個配置，通過--profile name方式引用。

配置文件中的配置支持通過source-profile方式引用指定profile中的參數。

新增訪問憑證

• 新增支持外部憑證。有兩種形式，通過URI地址獲取和通過外部進程獲取。

• 新增支持OIDC憑證。

• 實例角色訪問憑證模式支持自動獲取角色名。

config命令增強

提供交互命令，支持基礎配置：

• config set/get：支持增加/刪除/修改。

• config list-profiles：查詢所有已配置的配置名。

• config credential：在輸入的profile里面快速設置憑證。

修改輸出格式

支持--output-format修改輸出格式，默認為原始格式輸出，即XML或者文本，可設置為JSON、YAML、XML格式。

當從其它格式轉成 XML時，會丟棄掉根節點名字，統一使用root作為根節點。

輸出內容篩選

支持--output-query對輸出的內容做篩選。

全新的幫助文檔格式

幫助文檔的組織更加清晰，其中對于命令行選項部分，按照選項和全局選項劃分。

支持豐富的過濾參數

對于高級命令中，涉及到批量處理的命令，例如ls、cp、rm等，都支持完整的過濾參數：

• 基于路徑/對象名和路徑目錄

• 基于路徑/對象列表

• 基于文件/對象大小

• 基于文件/對象修改時間

• 基于對象的元數據

批量處理命令具備統一控制選項

所有的命令都使用了統一的選項名。具備以下能力：

• 支持對象key范圍查詢。

• 支持返回指定數量的結果。

• 支持遞歸和當前目錄下查詢。

• 強制操作 。

添加復制命令的元數據

增加--copy-props參數，用于控制元數據和標簽的復制規則：不拷貝、拷貝元數據、拷貝元數據和標簽。

通過環境變量設置參數

新增訪問憑證類參數對應的環境變量參數，避免直接使用命令行參數而導致的密鑰泄露風險。

新增region、endpoint、config-file和profile參數對應的環境變量參數。

支持--dry-run/-n

支持通過--dry-run選項驗證該命令的運行行為。

設置請求地址訪問格式

增加--addressing-style設置請求地址的訪問格式，支持虛擬域名、path-style和 CNAME。

命令參數/行選項值支持從標準輸入中讀入

該模式用于多個命令的串聯，支持通過管道把多個命令串聯起來。

命令支持別名

部分命令支持別名。

命令返回代碼一致

所有命令返回碼更加規范和一致。

在命令執行的過程中，如果出現錯誤則返回非0代碼。根據錯誤出現的階段，錯誤返回不同的錯誤碼，方便業務根據錯誤代碼做不同的處理。

選項參數支持友好設置方式

• 部分選項支持單位后綴的輸入格式，以具備更好的可讀性。例如對于字節類參數，支持 --max-size 1M，表示1024*1024字節；--max-age 1.5d，表示1.5天即36小時（等于 --max-age 36h）。

• 部分選項支持字符列表形式，即通過,分割。例如對標簽輸入--tagging key=value,key1=value1。也支持--tagging key=value --tagging key1=value1。

支持客戶端時間自動糾錯

當客戶端時間和服務端時間相差超過15分鐘時，會收到服務端返回的RequestTimeTooSkewed錯誤。ossutil能夠識別到該錯誤，并自動校正。