最終更新日:2025-08-18 15:32:25
このAPIは、「アーカイブストレージ」タイプに保存されたファイルをリストア(復元)するために使用できます。復元が完了すると、これらのファイルに直接アクセスできるようになります。
このAPIを呼び出すには、以下の形式でPOSTリクエストを送信してください。
POST /restore/{encodedEntry}/days/{duration}
Host: {mgrDomain}
Authorization: {managementcredential}
| パラメータ | 必須 | 説明 |
|---|---|---|
encodedEntry |
はい | 復元したいファイルを指定します。形式は EncodeEntryURI(bucket:key) です。bucket はバケット名、key はファイル名(パス含む)。例:YnVja2V0MToxLmpwZw== は bucket1:1.jpg をURL-safe Base64でエンコードしたものです。 |
days |
はい | 復元後、ファイルへアクセス可能な期間(日数指定、最小1日)。フォーマットが間違っている場合400エラーになります。 |
mgrDomain |
はい | 管理ドメイン。バケットの「概要」タブで確認できます。通常は *.v1.wcsapi.com です。 |
managementcredential |
はい | API認証で使用する管理用クレデンシャル。作成方法については管理用クレデンシャルの作成を参照してください。 |
curlコマンドによるアーカイブファイルのリストア例:
curl -v -X POST "http://{mgrDomain}/restore/aW1hZ2VzOkltYWdlLnBuZw==/days/1"
正常に処理されると、以下のようなレスポンスが返されます。
{"code": 200, "message": "ok"}
{"code": 401, "message": "Invalid Object State"}
{"code": 409, "message": "Restore Is InProgress"}
{"code": 403, "message": "Unsupported Operation"}
{"code": 404, "message": "File Not Found"}
{
"code": "<httpCode int>",
"message": "<errMsg string>"
}
| フィールド名 | 必須 | 説明 |
|---|---|---|
| code | はい | HTTPリクエストのステータスコード。HTTP Response Status Codes参照 |
| message | はい | リクエストの結果メッセージ。OKは成功時を示します。 |