Restore Object

最終更新日: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は成功時を示します。