对象存储

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

    资源元信息查询

    最近更新时间: 2023-12-25 11:34:21

    描述

    本接口仅用于获取资源的 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 表示深度归档存储4 表示归档直读存储
    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当天转为低频存储类型。

    transitionToArchiveIR 文件生命周期中转为归档直读存储的日期,int64 类型,Unix 时间戳格式 ,具体日期计算参考 生命周期管理。文件在设置转归档后才会返回该字段

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

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

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

    transitionToDeepArchive 文件生命周期中转为深度归档存储的日期,int64 类型,Unix 时间戳格式 ,具体日期计算参考 生命周期管理。文件在设置转深度归档后才会返回该字段

    例如:值为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