对象存储

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

    资源元信息查询

    最近更新时间: 2023-06-02 16:00:19

    描述

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

    请求

    请求语法

    GET /stat/<EncodedEntryURI> HTTP/1.1
    Host:          rs.qiniuapi.com
    Content-Type:  application/x-www-form-urlencoded
    X-Qiniu-Date: 20060102T150405Z
    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 类型,0表示标准存储,1 表示低频存储2 表示归档存储3 表示深度归档存储
    putTime 文件上传时间,int64 类型,Unix时间戳格式,单位为 100 纳秒。

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

    restoreStatus 归档/深度归档存储文件的解冻状态,uint32 类型,2表示解冻完成,1表示解冻中;归档/深度归档文件冻结时,不返回该字段。
    x-qn-meta 自定义元数据,含 meta_key 参数 及对应 metaValue 值;仅当自定义元数据后返回该字段。
    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当天转为归档存储类型。

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

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


    响应状态码

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

    示例

    请求示例

    GET /stat/ZGVtbzoyMDEzLTAyLTA5LTA3LTM5LTIwLmpwZw== HTTP/1.1
    User-Agent: curl/7.30.0
    Host: rs.qiniuapi.com
    Accept: */*
    Content-Type: application/x-www-form-urlencoded
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r72Vsn...(过长已省略)
    

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


    响应示例

    HTTP/1.1 200 OK
    Server: nginx/1.0.8
    Date: Mon, 02 Jan 2006 15:04:05 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