Fetch Resource from Mirror Storage

最終更新日:2025-08-18 15:32:15

このインターフェースは、ミラー元サイトから指定したリソースを取得し、ミラーストレージスペースに保存する機能を提供します。同名のリソースが既にスペース内に存在する場合、ミラー元サイトから取得したリソースによって完全に上書きされます。

リクエスト説明

リクエストパス

POST /prefetch/{param1}
Host: <MgrDomain>
Authorization: <AccessToken>

{param1} 生成ルール

{param1}の生成方法は以下の通りです:
バケット名 + “:” + ファイル名1 | ファイル名2 | ファイル名3…

この連結文字列をURL-safe Base64エンコードしてください。

エンコード形式例:

encode_file_key = Urlsafe_Base64_Encode(<key>)
{param1} = Urlsafe_Base64_Encode(<bucket>:encode_file_key1|encode_file_key2|encode_file_key3)

ヘッダー項目 説明

パラメータ 必須 説明
Host はい 管理ドメイン名。ユーザー管理画面で取得可能。
Authorization はい 管理認証情報

レスポンス説明

  • リクエストが成功した場合、以下の内容の Json 文字列が返されます。
{
    "bucket":"<バケット名>",
    "items":[
    {
        "key":"<ファイルキー>",
        "mirrorAddress":"<ミラーソースアドレス>",
        "code":"<コードint>",
        "message":"<メッセージ>"
    }]
}
フィールド名 必須 説明
bucket はい バケット名
mirrorAddress はい ミラーソースアドレス
code はい ミラーソース応答コード
message はい ミラーソース応答情報
  • リクエスト失敗時には、次の形式の Json 文字列が返却されます。
{
    "code":     "<コード文字列>",
    "message":  "<メッセージ文字列>"
}
フィールド名 必須 説明
code はい HTTPリクエスト応答コード。HTTPレスポンスステータスコード 参照
message はい 補足(Tips)

実行例

curl -v  -X POST -H "Authorization:bea919a5a1bc53d76a9e4340951b0b3692ff2517:YjRmYWI4ZWVkYzNmNDkyYmM2Y2I0NWE2NzVjNjk1Y2NjOGQxYzI3NQ==" --url http://mgrDomain/prefetch/aW1hZ2U6TVM1cWNHYz18TWk1cWNHYz0=