对象存储

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

    资源元信息查询

    最近更新时间:2021-11-12 16:41:22

    描述

    本接口仅用于获取资源的 Metadata 信息,不返回资源内容。

    请求

    请求语法

    GET /stat/<EncodedEntryURI> HTTP/1.1
    Host:          rs.qbox.me
    Content-Type:  application/x-www-form-urlencoded
    Authorization: Qiniu <AccessToken>
    

    请求参数

    参数名称 必填 说明
    EncodedEntryURI 具体请参考EncodedEntryURI

    请求头

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

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

    其他 该请求操作的实现使用了所有操作的公共请求头。详情请查阅公共请求头

    请求内容

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


    响应

    响应头

    头部名称 必填 说明
    Content-Type 正常情况下该值将被设为 application/json,表示返回 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 归档存储文件的解冻状态,uint3 2类型,2表示解冻完成,1表示解冻中;归档文件冻结时,不返回该字段。
    status 文件状态,uint32 类型。1 表示禁用;只有禁用状态的文件才会返回该字段。
    md5 文件 md5 值,string类型,32 位 16 进制组成的字符串,只有通过直传文件和追加文件 API 上传的文件,服务端确保有该字段返回,如请求时服务端没有返回md5字段,可以通过请求qhash/md5 方法来获取,比如 http://test.com/test.mp4?qhash/md5
    expiration 文件过期删除日期,int64 类型,Unix 时间戳格式,具体文件过期日期计算参考 生命周期管理。文件在设置过期时间后才会返回该字段(通过生命周期规则设置文件过期时间,仅对该功能发布后满足规则条件新上传文件返回该字段;历史文件想要返回该字段需要在功能发布后可通过 修改文件过期删除时间 API 或者 修改文件生命周期 API 指定过期时间;对于已经设置过过期时间的历史文件,到期都会正常过期删除,只是服务端没有该字段返回)

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

    transitionToIA 文件生命周期中转为低频存储的日期,int64 类型,Unix 时间戳格式 ,具体日期计算参考 生命周期管理。文件在设置转低频后才会返回该字段(通过生命周期规则设置文件转低频,仅对该功能发布后满足规则条件新上传文件返回该字段;历史文件想要返回该字段需要在功能发布后可通过 修改文件生命周期 API 指定转低频时间;对于已经设置过转低频时间的历史文件,到期都会正常执行,只是服务端没有该字段返回)

    例如:值为1568736000的时间,表示文件会在2019/9/18当天转为低频存储类型。

    transitionToARCHIVE 文件生命周期中转为归档存储的日期,int64 类型,Unix 时间戳格式 ,具体日期计算参考 生命周期管理。文件在设置转归档后才会返回该字段(通过生命周期规则设置文件转归档,仅对该功能发布后满足规则条件新上传文件返回该字段;历史文件想要返回该字段需要在功能发布后可通过 修改文件生命周期 API 指定转归档时间;对于已经设置过转归档时间的历史文件,到期都会正常执行,只是服务端没有该字段返回)

    例如:值为1568736000的时间,表示文件会在2019/9/18当天转为低归档储类型。


    响应状态码

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

    示例

    命令行示例

    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: */*
    Content-Type: application/x-www-form-urlencoded
    Authorization: Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r72Vsn...(过长已省略)
    

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


    响应示例

    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