对象存储

  • 对象存储 > API Reference > Object 接口 > 解冻归档存储文件

    解冻归档存储文件

    最近更新时间:2020-01-02 14:33:29

    解冻归档存储类型的文件,可设置解冻有效期1~7天。

    请求报文

    请求语法

    POST /restoreAr HTTP/1.1
    Host:           rs.qbox.me
    Content-Type:   application/json
    Authorization:  Qiniu <AccessToken>
    
    Body:
    {
        "entries":[
            {
                "bucket":<Bucketname>,
                "key":<Objectkey>,
                "freeze_after_days":<FreezeAfterDays>,
                "cond":"condKey1=condVal1&condKey2=condVal2"
            },
            ...
        ]
    }
    

    请求参数

    参数名称 必填 说明
    bucket 执行解冻操作的对象所在的bucket
    key 执行解冻操作的对象的key
    freeze_after_days 解冻有效时长,1~7天
    cond 执行解冻操作的条件,可以不设置。支持设置hash、mime、fsize、putTime 条件,指定多个条件时只有全部匹配才会执行解冻操作

    访问权限

    管理凭证方式。

    响应报文

    头部信息

    头部名称 必填 说明
    Content-Type 正常情况下该值将被设为application/json,表示返回JSON格式的文本信息

    其它可能返回的头部信息,请参考HTTP扩展字段

    响应内容

    • 如果请求成功,不返回任何内容。

    • 如果请求失败,返回包含如下内容的JSON字符串(已格式化,便于阅读):

    {
        "error":   "<errMsg    string>"
    }
    
    字段名称 必填 说明
    error 与HTTP状态码对应的消息文本

    响应状态码

    HTTP状态码 含义
    200 更改成功
    400 请求报文格式错误
    <Objectkey>不符合UTF-8编码,返回400 Bad Request {"error":"key must be utf8 encoding"}
    <FreezeAfterDays>不符合要求时,返回400 Bad Request {"error":"invalid freeze after days"}
    401 管理凭证无效
    612 目标资源不存在
    599 服务端操作失败

    示例

    请求示例

    POST /restoreAr  HTTP/1.1
    Host: rs.qbox.me
    User-Agent: Go-http-client/1.1
    Authorization: Qiniu fjxKGs5obR6WYH39j3wn...BURvsxLFp3D:Znv4-3bFUntspUakYurcUcDTha8=
    Content-Type: application/json
    
    {
      "entries":[
            {
                  "bucket":"publicbucket_z0",
                  "key":"KODO-KEY-TEST-archive-qhdw18YRgL",
                  "freeze_after_days":1
                }
        ]
    }
    
    

    响应示例

    HTTP/1.1 200 OK
    Date: Mon, 23 Dec 2019 10:20:15 GMT
    Content-Type: application/json
    Connection: keep-alive
    X-Reqid: DQkAANOJpXDV-OIV
    
    以上内容是否对您有帮助?
  • Icon free helper
    Close