restore-object用于解凍歸檔類型(Archive)或冷歸檔(Cold Archive)的文件(Object)。
注意事項
阿里云賬號默認擁有解凍文件的權限。如果您需要通過RAM用戶或者STS的方式進行解凍,您必須擁有
oss:RestoreObject
權限。具體操作,請參見為RAM用戶授權自定義的權限策略。restore-object只針對歸檔或冷歸檔類型的Object,不適用于標準類型和低頻訪問類型的Object。
對于歸檔類型或者冷歸檔類型的Object,如果需要讀取Object,請提前解凍。歸檔類型的Object解凍有分鐘級延遲,冷歸檔類型的Object解凍有數小時延遲。
命令格式
ossutil api restore-object --bucket value --key value [flags]
參數 | 類型 | 說明 |
--bucket | string | Bucket名稱。 |
--key | string | Object的完整路徑。 |
--restore-request | string | 解凍請求信息。 |
--version-id | string | 請求解凍的Obejct的版本號。 |
說明
restore-object命令對應API接口RestoreObject。關于API中的具體參數含義,請參見RestoreObject。
--restore-request
--restore-request配置選項既支持XML語法也支持JSON語法,當選項值包含file://前綴時,表示從文件中讀取配置。
XML語法:
<RestoreRequest> <Days>integer</Days> <JobParameters> <Tier>string</Tier> </JobParameters> </RestoreRequest>
JSON語法:
{ "Days": integer, "JobParameters": { "Tier": "string" } }
說明
關于支持的全局命令行選項,請參見支持的全局命令行選項。
使用示例
解凍存儲空間examplebucket
中的exampleobject。
使用XML配置文件,restore-request.xml內容如下:
<?xml version="1.0" encoding="UTF-8"?> <RestoreRequest> <Days>2</Days> <JobParameters> <Tier>Standard</Tier> </JobParameters> </RestoreRequest>
命令示例如下:
ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.xml
使用JSON配置文件,restore-request.json內容如下:
{ "RestoreRequest": { "Days": "2", "JobParameters": { "Tier": "Standard" } } }
命令示例如下:
ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.json
使用JSON配置參數,命令示例如下:
ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request "{\"RestoreRequest\":{\"Days\":\"2\",\"JobParameters\":{\"Tier\":\"Standard\"}}}"
文檔內容是否對您有幫助?