仅获取资源的Metadata
信息,不返回资源内容。
请求报文
请求语法
GET /stat/<EncodedEntryURI> HTTP/1.1
Host: rs.qbox.me
Authorization: Qiniu <AccessToken>
EncodedEntryURI的细节请参考EncodedEntryURI。
访问权限
管理凭证方式。
头部信息
头部名称 | 必填 | 说明 |
---|---|---|
Authorization |
是 | 该参数应严格按照管理凭证格式进行填充,否则会返回401错误码 一个合法的 |
响应报文
头部信息
头部名称 | 必填 | 说明 |
---|---|---|
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纳秒。 例如:值为 |
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指定过期时间;对于已经设置过过期时间的历史文件,到期都会正常过期删除,只是服务端没有该字段返回) 例如:值为 |
- 如果请求失败,返回包含如下内容的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"
}
文档反馈
(如有产品使用问题,请提交工单)