ファイル解凍タスクを使用すると、特定のファイルまたは圧縮パッケージ全体を指定した場所に解凍できます。サポートされているフォーマットは、Zip、RAR、7z です。
操作説明
この API はパブリックプレビュー中です。ご不明な点がございましたら、DingTalk グループにご参加いただき、フィードバックをお寄せください。グループ番号については、「お問い合わせ」をご参照ください。
-
この API を使用する前に、Intelligent Media Management の課金方法と料金をご確認ください。
重要 非同期タスクの適時性は保証されません。 -
ファイル数の上限:圧縮パッケージには最大 80,000 個のファイルを含めることができます。
-
ファイルサイズの上限:Zip および RAR フォーマットでは 200 GB、7z フォーマットでは 50 GB です。
-
ファイル解凍タスクはストリーム解凍を使用します。これは、ファイルが解凍されると同時に出力される方式です。ファイルの破損により操作が中止された場合でも、すでに解凍されたファイルは削除されません。
-
これは非同期 API です。タスク情報は 7 日間のみ保存され、この期間を過ぎると取得できなくなります。タスク情報を表示するには、返された
TaskIdを使用して GetTask または ListTasks 操作を呼び出します。または、Notification パラメーターを設定して、非同期通知メッセージを通じてタスク情報を受信することもできます。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
imm:CreateFileUncompressionTask |
create |
*Project
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ProjectName |
string |
必須 |
プロジェクト名。詳細については、「プロジェクトの作成」をご参照ください。 |
test-project |
| CredentialConfig | CredentialConfig |
任意 |
特定の要件がない限り、このパラメーターは空のままにしてください。 チェーン承認の設定。このパラメーターはオプションです。詳細については、「チェーン承認を使用して他のエンティティリソースにアクセスする」をご参照ください。 |
|
| Password |
string |
任意 |
暗号化された圧縮パッケージのパスワード。 |
123456 |
| UserData |
string |
任意 |
カスタムユーザー情報。非同期通知メッセージで返され、通知とご利用のシステムを関連付けるのに役立ちます。最大長は 2,048 バイトです。 |
test-data |
| SelectedFiles |
array |
任意 |
解凍するファイルのリスト。このパラメーターが空の場合、圧縮パッケージ全体が解凍されます。デフォルト値は空です。 |
|
|
string |
任意 |
解凍するファイルの名前。これは、圧縮パッケージのルートディレクトリからの相対パスです。 |
test-dir/test.jpg |
|
| SourceURI |
string |
必須 |
圧縮ファイルが保存されている Object Storage Service (OSS) アドレス。 OSS アドレスは、`oss://${Bucket}/${Object}` というフォーマットである必要があります。`${Bucket}` は、現在のプロジェクトと同じリージョンにある OSS バケットの名前です。`${Object}` は、ファイル名拡張子を含むファイルの完全なパスです。 |
oss://test-bucket/test-object.zip |
| Notification | Notification |
任意 |
メッセージ通知設定。詳細については、Notification をクリックしてください。非同期通知メッセージのフォーマットについては、「非同期通知メッセージのフォーマット」をご参照ください。 説明
Intelligent Media Management API のコールバックは、カスタム Webhook アドレスをサポートしていません。代わりに MNS を使用してください。 |
|
| TargetURI |
string |
任意 |
解凍されたファイルの宛先 OSS アドレス。選択したファイルまたは圧縮パッケージ全体がこのアドレスに解凍されます。 OSS アドレスは、`oss://${Bucket}/${Object}` というフォーマットである必要があります。`${Bucket}` は、現在のプロジェクトと同じリージョンにある OSS バケットの名前です。`${Object}` は、ファイル名拡張子を含むファイルの完全なパスです。 |
oss://test-bucket/test-dir/ |
解凍タスクの作成時に詳細な解凍情報を取得するには、`Notification` の `ExtendedMessageURI` パラメーターを設定します。ファイルには、次の構造の情報が含まれています:
{
"Password" : "圧縮パッケージのパスワード",
"IsEncryption": "true/false、圧縮パッケージが暗号化されているかどうかを指定します",
"ArchiveFiles": [
{
"URI": "解凍されたファイルのアドレス。例:oss://test-bucket/test-dir/test.txt",
"PathName": "圧縮パッケージからのファイルの相対パス。例:./test.txt",
"Reason": "プレビューが失敗した場合、このパラメーターは失敗の理由を示します。",
"IsFolder": "true/false、ファイルがフォルダーであるかどうかを指定します",
"PackedSize": "圧縮パッケージ内のファイルのサイズ",
"UnPackedSize": "解凍後のファイルのサイズ",
"FileAccessTime": "ファイル時間情報",
},
{
"URI": "oss://test-bucket/test-dir/text.doc",
"PathName": "./text.doc",
"Reason": "",
"IsFolder": "true",
"PackedSize": "102",
"UnPackedSize": "150",
"FileAccessTime": "2023-07-21T09:46:35Z",
},
]
}
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答構造体 |
||
| RequestId |
string |
リクエスト ID。 |
EC564A9A-BA5C-4499-A087-D9B9E76E***** |
| EventId |
string |
イベント ID。 |
0ED-1Bz8z71k5TtsUejT4UJ16Es***** |
| TaskId |
string |
タスク ID。 |
FileUncompression-16ab5dd6-af02-480e-9ed7-a8d51b1***** |
例
成功レスポンス
JSONJSON
{
"RequestId": "EC564A9A-BA5C-4499-A087-D9B9E76E*****",
"EventId": "0ED-1Bz8z71k5TtsUejT4UJ16Es*****",
"TaskId": "FileUncompression-16ab5dd6-af02-480e-9ed7-a8d51b1*****"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。