对象存储

  • 对象存储 > API Reference > Object 接口 > 资源元信息查询

    资源元信息查询

    最近更新时间:2020-07-24 15:06:18

    仅获取资源的Metadata信息,不返回资源内容。

    请求报文

    请求语法

    GET /stat/<EncodedEntryURI> HTTP/1.1
    Host:          rs.qbox.me
    Authorization: Qiniu <AccessToken>
    

    EncodedEntryURI的细节请参考EncodedEntryURI

    访问权限

    管理凭证方式。

    头部信息

    头部名称 必填 说明
    Authorization 该参数应严格按照管理凭证格式进行填充,否则会返回401错误码

    一个合法的Authorization值应类似于:Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7...

    响应报文

    头部信息

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

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

    响应内容

    • 如果请求成功,返回包含如下内容的JSON字符串:
    字段名称 必填 说明
    fsize 文件大小,int64类型,单位为字节(Byte)。
    hash 文件HASH值,string类型。
    mimeType 文件MIME类型,string类型。
    type 文件存储类型,uint32类型,2 表示归档存储1 表示低频存储0表示普通存储。
    putTime 文件上传时间,int64类型,Unix时间戳格式,单位为 100纳秒。

    例如:值为13603956734587420的时间,对应的实际时间为2013-02-09 15:41:13

    restoreStatus 归档存储文件的解冻状态,uint32类型,2表示解冻完成,1表示解冻中;归档文件冻结时,不返回该字段。
    status 文件状态,uint32类型。1表示禁用;只有禁用状态的文件才会返回该字段。
    md5 文件md5值,string类型,32位16进制组成的字符串,只有通过直传文件和追加文件API上传的文件,服务端确保有该字段返回,如请求时服务端没有返回md5字段,可以通过请求qhash/md5 方法来获取,比如 http://test.com/test.mp4?qhash/md5
    expiration 文件过期删除日期,int64类型,Unxi时间戳格式,具体文件过期日期计算参考生命周期管理。文件在设置过期时间后才会返回该字段(通过生命周期规则设置文件过期时间,仅对该功能发布后满足规则条件新上传文件返回该字段;历史文件想要返回该字段需要在功能发布后可通过更新文件生命周期API指定过期时间;对于已经设置过过期时间的历史文件,到期都会正常过期删除,只是服务端没有该字段返回)

    例如:值为1568736000的时间,表示文件会在2019/9/18当天内删除。

    • 如果请求失败,返回包含如下内容的JSON字符串(已格式化,便于阅读):
    {
        "error":   "<errMsg    string>"
    }
    
    字段名称 必填 说明
    error 与HTTP状态码对应的消息文本

    响应状态码

    HTTP状态码 含义
    200 获取Metadata成功
    400 请求报文格式错误
    401 管理凭证无效
    599 服务端操作失败
    612 目标资源不存在

    示例

    命令行示例

    curl -i \
         -H "Authorization: Qiniu QNJi_bYJlmO5LeY..." \
         "http://rs.qbox.me/stat/ZGVtbzoyMDEzLTAyLTA5LTA3LTM5LTIwLmpwZw=="
    

    请求示例

    GET /stat/ZGVtbzoyMDEzLTAyLTA5LTA3LTM5LTIwLmpwZw== HTTP/1.1
    User-Agent: curl/7.30.0
    Host: rs.qbox.me
    Accept: */*
    Authorization: Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r72Vsn...(过长已省略)
    

    注意:要在Authorization头部的<AccessToken>前添加Qiniu和半角空格。

    响应示例

    以下响应中JSON字符串经过格式化,以便阅读。

    HTTP/1.1 200 OK
    Server: nginx/1.0.8
    Date: Sun, 03 Nov 2013 14:01:28 GMT
    Content-Type: application/json
    Connection: keep-alive
    Cache-Control: no-store
    Content-Length: 121
    X-Log: qtbl.get;RS
    X-Reqid: swEAAMipp-5bIjMT
    
    {
        "fsize":        5122935,
        "hash":         "ljfockr0lOil_bZfyaI2ZY78HWoH",
        "mimeType":     "application/octet-stream",
        "putTime":      13603956734587420,
        "md5":          "e41714a18899cf59c200a9bddfa78b95"
    }
    
    以上内容是否对您有帮助?
  • Qvm free helper
    Close