Uncompress zip Package
最終更新日：2025-08-20 11:11:16
このインターフェースは、オブジェクトストレージプラットフォーム上で圧縮ファイルを解凍する機能を提供します。解凍処理が完了すると、解凍結果を示すリストファイルがデフォルトでオブジェクトストレージに生成され、その内容に解凍されたファイル情報が含まれます。
リクエスト説明
リクエスト形式
POST /fops
Host: <MgrDomain>
Authorization: <accessToken>
管理認証パラメータ
<path>:/fops
<body>:<RequestParams> （＝リクエスト内容）
ヘッダー パラメータ説明
| パラメータ | 必須 | 説明 |
|---|---|---|
| Host | はい | 管理用ドメイン名。コンソールのバケット概要画面から取得可能です。 |
| Authorization | はい | 管理認証情報。 |
リクエストボディ形式
リクエストパラメータは以下の形式で送信します：
bucket=<Urlsafe_Base64_Encoded_Bucket>&key=<Urlsafe_Base64_Encoded_Key>&fops=<Urlsafe_Base64_Encoded_Fops>¬ifyURL=<Urlsafe_Base64_Encoded_PersistentNotifyUrl>&force=<Force>&separate=<Separate>
リクエストボディ パラメータ説明
| パラメータ | 必須 | 説明 |
|---|---|---|
| bucket | はい | スペース名（バケット名） |
| key | はい | ファイル名（解凍対象の圧縮ファイルを指定） |
| fops | はい | 処理パラメータリスト。詳細はDecompression Ops Parameter Formatを参照。複数指定時は;区切りで指定可。 |
| notifyURL | いいえ | 処理結果通知用URL。通知データ内容説明を参照。 |
| force | いいえ | データ処理を強制するかどうか。サーバー側でfops指定処理の結果が既に存在する場合、通常は成功済みとみなします。force=1で強制的に再処理し、既存結果を上書き（デフォルトは0）。 |
| separate | いいえ | トランスコード結果の個別通知オプション。1: 各命令ごとにnotifyURL通知。0: 全処理後一度だけ通知（デフォルト0）。 |
レスポンス説明
- 成功時は、以下のような
JSONが返されます：
{ "persistentId": <persistentId> }
| フィールド名 | 必須 | 説明 |
|---|---|---|
| persistentId | はい | アップロード前処理または永続処理のプロセスID |
- 失敗時は、次のような
JSONが返されます：
{
"code": "<code string>",
"message": "<ErrMsg string>"
}
| フィールド名 | 必須 | 説明 |
|---|---|---|
| code | はい | HTTPリクエストレスポンスコード。HTTP Response Status Codesを参照 |
| message | はい | ファイル解凍処理失敗時のメッセージ |
リストファイルの詳細
解凍が成功すると、該当スペースディレクトリ内にリストファイルが生成されます。デフォルトのファイル名形式は「乱数＋タイムスタンプ＋圧縮ファイル名.list」となります。
ファイル内容のフォーマットは以下のとおりです：
url \t key \t status
パラメータ説明
| パラメータ | 型 | 説明 |
|---|---|---|
| url | string | 解凍された各ファイルのアクセスパス |
| key | string | オブジェクトストレージ上のリソースを一意に示す情報（スペース名:ファイル名 例：video:1.txt） |
| status | int | ステータスコード。0:新規ファイル, 1:元ファイル上書き, 2:既存ファイル保持, 3:解凍例外, -1:解凍ファイル保存失敗 |
実行例
curl -v -X POST -d "bucket=aW1hZ2Vz&key=dGVzdC56aXA&fops=ZGVjb21wcmVzc2lvbi96aXA=&force=1&separate=0" -H "Authorization: 86622e227a50d49d858c2494a935bc2e4ac543a7:NmNlYmI5YzczMjlkN2MxYTYxNWYyMjE4MDMxZTVjMWQ3ZjlkZTVmOA==" --url "http://mgrDomain/fops"
このドキュメントの内容は役に立ちましたか?
はい
いいえ