文档中心 Object Storage API 获取镜像资源

获取镜像资源

更新时间:2025-08-18 15:32:15

本接口为​​镜像存储空间​​提供从镜像源站获取指定资源并存储的功能。若空间内已存在同名资源,将被镜像源站资源​​完全覆盖​​。

请求描述

请求路径

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

参数 {param1}生成规则

{param1}生成规则为:空间名 + “:” + 文件名1 | 文件名2 | 文件名3…
对连接后的字符串需进行URL安全的Base64编码
编码格式:

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

Header 描述

参数 是否必需 描述
Host 管理域名,可以通过用户管理界面获取。
Authorization 管理凭证

响应描述

  • 如果请求成功,将返回包含以下内容的 Json 字符串:
{
    "bucket":"<bucket string>",
    "items":[
    {
        "key":"<filekey>",
        "mirrorAddress":"<mirrorAddress string>",
        "code":"<code int>",
        "message":"<message string>"
    }]
}
字段名称 是否必需 描述
bucket 空间名
mirrorAddress 镜像源地址
code 镜像源响应代码
message 镜像源响应信息
  • 如果请求失败,将返回包含以下内容的 Json 字符串:
{
    "code":     "<code string>",
    "message":  "<message string>"
}
字段名称 是否必需 描述
code HTTP请求响应代码,请参见 HTTP响应状态码
message 提示信息

示例

curl -v  -X POST -H "Authorization:bea919a5a1bc53d76a9e4340951b0b3692ff2517:YjRmYWI4ZWVkYzNmNDkyYmM2Y2I0NWE2NzVjNjk1Y2NjOGQxYzI3NQ==" –-url http://mgrDomain/prefetch/aW1hZ2U6TVM1cWNHYz18TWk1cWNHYz0=
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!