創(chuàng)建解壓縮任務(wù)可以將您壓縮包內(nèi)的指定文件解壓縮到特定位置，也可以將壓縮包完整解壓。目前支持的壓縮格式包括Zip、RAR和7z。
接口說明
-
請(qǐng)確保在使用該接口前，已充分了解智能媒體管理產(chǎn)品的收費(fèi)方式和價(jià)格。
-
文件數(shù)量限制：最多支持打包 8 萬個(gè)文件。
-
文件大小限制：zip 和 rar 格式最多支持 200 GB，7z 格式最多支持 50 GB。
-
文件解壓縮任務(wù)的處理方式為流式解壓，在處理的過程中邊解壓邊輸出文件。如果在解壓過程中有部分文件損壞導(dǎo)致解壓操作中止，已解壓生成的文件不會(huì)被刪除。
-
該接口為異步接口，獲取任務(wù)開始執(zhí)行后，任務(wù)信息只保存 7 天，超過 7 天則無法再獲取。調(diào)用 GetTask 或 ListTasks 接口獲取返回的
TaskId，查看任務(wù)信息。也可以通過設(shè)置 Notification 消息通知參數(shù)，通過消息通知獲取任務(wù)信息。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問級(jí)別：是指每個(gè)操作的訪問級(jí)別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對(duì)于必選的資源類型，用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| imm:CreateFileUncompressionTask | create |
|
| 無 |
請(qǐng)求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ProjectName | string | 是 | 項(xiàng)目名稱，獲取方式請(qǐng)參見創(chuàng)建項(xiàng)目。 | test-project |
| CredentialConfig | CredentialConfig | 否 | 如無特殊需求，請(qǐng)保持留空即可。 鏈?zhǔn)绞跈?quán)配置，非必填。更多信息，請(qǐng)參見使用鏈?zhǔn)绞跈?quán)訪問其他實(shí)體資源。 | |
| Password | string | 否 | 壓縮包加密的密碼。 | 123456 |
| UserData | string | 否 | 用戶自定義信息，在異步消息通知中會(huì)為您返回，方便您系統(tǒng)內(nèi)對(duì)消息通知進(jìn)行關(guān)聯(lián)處理。最大長度為 2048 字節(jié)。 | test-data |
| SelectedFiles | array | 否 | 需要解壓的文件列表，該參數(shù)為空時(shí)表示解壓整個(gè)壓縮包。默認(rèn)為空。 | |
| string | 否 | 需要解壓的文件名，相對(duì)壓縮包根目錄的路徑值。 | test-dir/test.jpg | |
| SourceURI | string | 是 | 壓縮文件存放的 OSS 地址。 OSS 地址規(guī)則為 oss://${Bucket}/${Object}，其中 | oss://test-bucket/test-object.zip |
| Notification | Notification | 否 | 消息通知配置，詳細(xì)內(nèi)容請(qǐng)單擊 Notification 查看，異步通知消息格式請(qǐng)參見異步通知消息格式。 | |
| TargetURI | string | 否 | 解壓文件的目標(biāo) OSS 地址。被選中的文件或壓縮包會(huì)解壓到該地址下。 OSS 地址規(guī)則為 oss://${Bucket}/${Object}，其中 | oss://test-bucket/test-dir/ |
創(chuàng)建解壓縮任務(wù)請(qǐng)如果需要獲取具體解壓信息，請(qǐng)?jiān)O(shè)置Notification中的ExtendedMessageURI參數(shù)。該文件中包含的信息結(jié)構(gòu)如下所示：
{
"Password" : "壓縮包的密碼",
"IsEncryption": "true/false, 壓縮包是否加密",
"ArchiveFiles": [
{
"URI": "解壓后的文件地址，例 oss://test-bucket/test-dir/test.txt",
"PathName": "文件相對(duì)于壓縮包的路徑，例如./test.txt",
"Reason": "如果預(yù)覽失敗，該文件預(yù)覽失敗的原因",
"IsFolder": "true/false，該文件是否是文件夾",
"PackedSize": "壓縮包內(nèi)文件大小",
"UnPackedSize": "解壓后文件大小",
"FileAccessTime": "文件時(shí)間信息",
},
{
"URI": "oss://test-bucket/test-dir/text.doc",
"PathName": "./text.doc",
"Reason": "",
"IsFolder": "true",
"PackedSize": "102",
"UnPackedSize": "150",
"FileAccessTime": "2023-07-21T09:46:35Z",
},
]
}
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "EC564A9A-BA5C-4499-A087-D9B9E76E*****",
"EventId": "0ED-1Bz8z71k5TtsUejT4UJ16Es*****",
"TaskId": "FileUncompression-16ab5dd6-af02-480e-9ed7-a8d51b1*****"
}錯(cuò)誤碼
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2023-08-30 | OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2023-04-03 | OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2023-03-09 | OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |