对象存储

  • 对象存储 > API 文档 > Bucket 接口 > 设置 Bucket 镜像源

    设置 Bucket 镜像源

    最近更新时间: 2023-03-01 17:47:24

    描述

    七牛镜像存储服务可以帮助用户实现数据热迁移,迁移过程中并不影响原有业务系统的访问。镜像存储适用于迁移原有业务系统的已有数据。


    请求

    请求语法

    POST /image/<BucketName>/from/<EncodedSrcSiteUrl>/host/<EncodedHost> HTTP/1.1
    Host:           uc.qiniuapi.com
    Content-Type:   application/x-www-form-urlencoded
    X-Qiniu-Date: 20060102T150405Z
    Authorization:  Qiniu <AccessToken>
    

    使用说明:

    • 取回动作仅在第一次访问资源不存在时发生

    • 取回动作是一个同步操作,源文件过大可能导致客户端等待超时

    • 取回动作失败时,会返回 HTTP 响应码

    • 源站同名资源的内容发生改变后,七牛云存储不会自动将新内容取回,用户需要删除空间中的资源,再刷新预取才可以访问到更新后的资源

    • 多个客户端触发镜像回源时,资源的最终内容为最后一个成功执行的操作所存储的结果

    • 回源源站时,会携带固定的User-Agent信息:<RegionID>-qiniu-imgstg-spider-1.0Region(区域) ID列表


    请求参数

    参数名称 必填 说明
    BucketName 需要设定镜像源的目标空间名
    EncodedSrcSiteUrl 镜像源的访问域名,必须设置为形如http(s)://source.comhttp(s)://114.114.114.114的字符串。参数值必须做URL 安全的 Base64 编码
    EncodedHost 回源时使用的Host头部值。参数值必须做URL 安全的 Base64 编码。可以填空字符串 "" 或不包含 /host/<EncodedHost> 部分,表示不额外指定 host

    请求头

    该请求操作的实现使用了所有操作的公共请求头。有关详细信息,请查阅公共请求头


    请求内容

    该请求操作的请求体为空。


    响应

    响应头

    该请求操作的实现使用了所有操作的公共响应头。有关详细信息,请查阅公共响应头


    响应内容

    该请求操作的响应体为空。


    响应状态码

    该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息,请查阅错误响应


    示例

    请求示例

    POST /image/test02/from/aHR0cHM6Ly9zYXJhaC5xaW5pdWRlbW8uY29t HTTP/1.1
    Host: uc.qiniuapi.com
    User-Agent: Go-http-client/1.1
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:CCiHcTjKJDdseHBrldeYFywnxWo=
    Accept-Encoding: gzip
    

    响应示例

    HTTP/1.1 200 OK
    Content-Length: 2
    Connection: keep-alive
    Content-Type: application/json
    Date: Mon, 02 Jan 2006 15:04:05 GMT
    Server: nginx/1.4.4
    X-Reqid: WUQAAIqqrYab_9oU
    
    {}
    
    以上内容是否对您有帮助?
  • Qvm free helper
    Close