presign用于生成對象的預簽名URL。
命令格式
ossutil presign oss://bucket[/prefix] [flags]
參數 | 類型 | 說明 |
-d, --dirs | / | 返回當前目錄下的文件和子目錄,而非遞歸顯示所有子目錄下的所有文件。 |
--encoding-type | string | 輸入的對象名或文件名的編碼方式。取值:url。 |
--end-with | string | 按字母排序,返回設定值之前的對象,包含設定值。 |
--exclude | stringArray | 路徑或文件名的排除規則。 |
--exclude-from | stringArray | 從規則文件里讀取排除規則。 |
--expires-date | Time | 簽名URL過期時間點(默認值off)。 |
--expires-duration | Duration | 簽名URL過期時間,默認值15m0s(15分鐘0秒),取值范圍1s~1w(1秒 ~1周)。 |
--files-from | stringArray | 從文件中讀取源文件名列表,忽略空行或注釋行。 |
--files-from-raw | stringArray | 從文件中讀取源文件名列表。 |
--filter | stringArray | 路徑或文件名過濾規則。 |
--filter-from | stringArray | 從規則文件讀取過濾規則。 |
-f, --force | / | 強制操作,不進行詢問提示。 |
--include | stringArray | 路徑或文件名的包含規則。 |
--include-from | stringArray | 從規則文件里讀取包含規則。 |
--limited-num | int | 返回結果的最大個數。 |
--list-objects | / | 使用ListObjects接口列舉對象。 |
--max-age | Duration | 不傳輸任何比此更早的文件,默認是秒,或單位后綴形式 ms|s|m|h|d|w|M|y(默認值off)。 |
--max-mtime | Time | 不傳輸任何比此更新的文件,UTC時間格式(默認值off)。 |
--max-size | SizeSuffix | 限制傳輸的最大文件大小,默認是字節,或單位后綴形式B|K|M|G|T|P,1K(KiB)=1024B。 |
--metadata-exclude | stringArray | 對象元數據的排除規則。 |
--metadata-filter | stringArray | 對象元數據過濾規則。 |
--metadata-filter-from | stringArray | 從規則文件讀取對象元數據過濾規則。 |
--metadata-include | stringArray | 對象元數據的包含規則。 |
--min-age | Duration | 不傳輸任何比此更新的文件,默認是秒,或單位后綴形式 ms|s|m|h|d|w|M|y(默認值off)。 |
--min-mtime | Time | 不傳輸任何比此更早的文件,UTC時間格式(默認值off)。 |
--min-size | SizeSuffix | 限制傳輸的最小文件大小,默認是字節,或單位后綴形式B|K|M|G|T|P,1K(KiB)=1024B。 |
--page-size | int | 返回對象或文件的最大數(默認值1000),取值范圍1~1000。 |
--query-param | stringArray | 請求中的查詢參數。 |
-r, --recursive | / | 遞歸進行操作。當指定該選項時,命令會對存儲空間下所有符合條件的對象進行操作,否則只對路徑指定的對象進行操作。 |
--request-payer | string | 請求的支付方式,如果為請求者付費模式,請設置該值。取值:requester。 |
--start-after | string | 按字母排序,返回設定值之后的對象,不包含。 |
--traffic-limit | int | 單連接帶寬限制。取值范圍:819200~838860800。 |
--version-id | string | 對象的版本標識。 |
關于支持的全局命令行選項,請參見支持的全局命令行選項。
使用示例
對存儲空間examplebucket里的example.txt 對象,生成默認有效期為15分鐘的預簽名URL。
ossutil presign oss://examplebucket/example.txt
對存儲空間examplebucket里的example.txt對象,生成有效期為1小時的預簽名URL。
ossutil presign oss://examplebucket/example.txt --expires-duration 1h
對存儲空間examplebucket里的example.txt對象,生成有效期到2024-06-01T12:00:00(UTC)的預簽名URL。
ossutil presign oss://examplebucket/example.txt --expires-date 2024-06-01T12:00:00
對存儲空間examplebucket里的example.txt對象,生成包含圖片處理參數的預簽名URL。
ossutil presign oss://examplebucket/example.txt --query-param x-oss-process=image/resize,m_fixed,w_100,h_100/rotate,90
對存儲空間examplebucket里的example.txt對象,生成版本標識為123的預簽名URL。
ossutil presign oss://examplebucket/example.txt --version-id 123
對存儲空間examplebucket里的folder目錄,批量生成默認有效期為15分鐘的預簽名URL。
ossutil presign oss://examplebucket/folder/ -r
對存儲空間examplebucket里的folder目錄下的后綴為.txt的文件,批量生成默認有效期為15分鐘的預簽名URL。
ossutil presign oss://examplebucket/folder/ -r --include "*.txt"