| Object接口 > 资源元信息查询 | ||||||||||||||||||||||||||||||||||||||||||||||||
|
仅获取资源的Metadata信息，不返回资源内容。
|
| 头部名称 | 必填 | 说明 |
|---|---|---|
| Authorization | 是 | 该参数应严格按照管理凭证格式进行填充，否则会返回401错误码 一个合法的Authorization值应类似于：QBox QNJi_bYJlmO5LeY08FfoNj9w_r7… |
| 头部名称 | 必填 | 说明 |
|---|---|---|
| Content-Type | 是 | 正常情况下该值将被设为application/json，表示返回JSON格式的文本信息 |
如果请求成功，返回包含如下内容的JSON字符串
{
"fsize": <FileSize int>,
"hash": "",
"mimeType": "",
"type": "",
"putTime": <PutTime int64>
}| 字段名称 | 必填 | 说明 |
|---|---|---|
| fsize | 是 | 文件大小，单位为字节（Byte）。 |
| hash | 是 | 文件的HASH值，使用hash值算法计算。 |
| mimeType | 是 | 文件的MIME类型。 |
| type | 是 | 资源的存储类型，1 表示低频存储，0表示普通存储。 |
| putTime | 是 | 上传时间，Unix时间戳格式，且单位是 100纳秒。 例如：值为13603956734587420的时间，对应的实际时间为2013-02-09 15:41:13。 |
如果请求失败，返回包含如下内容的JSON字符串
{
"error": ""
}| 字段名称 | 必填 | 说明 |
|---|---|---|
| error | 是 | 与HTTP状态码对应的消息文本 |
| HTTP状态码 | 含义 |
|---|---|
| 200 | 获取Metadata成功 |
| 400 | 请求报文格式错误 |
| 401 | 管理凭证无效 |
| 599 | 服务端操作失败 |
| 612 | 目标资源不存在 |
curl -i \ -H "Authorization: QBox QNJi_bYJlmO5LeY..." \ "http://rs.qiniu.com/stat/ZGVtbzoyMDEzLTAyLTA5LTA3LTM5LTIwLmpwZw=="
GET /stat/ZGVtbzoyMDEzLTAyLTA5LTA3LTM5LTIwLmpwZw== HTTP/1.1 User-Agent: curl/7.30.0 Host: rs.qiniu.com Accept: */* Authorization: QBox QNJi_bYJlmO5LeY08FfoNj9w_r72Vsn...
注意：要在Authorization头部的AccessToken前添加QBox和半角空格。
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
}function fileDetail($accessKey,$secretKey,$bucket,$key)
{
$authObj = new Auth($accessKey, $secretKey);
$http = new Http();
$encodedEntryURI = $authObj->entry($bucket, $key);
$url = "http://rs.qiniu.com/stat/{$encodedEntryURI}";
$headers = $authObj->getHeaders($url, null, 'application/x-www-form-urlencoded');
// 创建一个新cURL资源
$curl = curl_init();
// 设置URL和相应的选项
curl_setopt($curl, CURLOPT_URL, $url);
//CURLOPT_HEADER为true设置头文件的信息作为数据流输出
curl_setopt($curl, CURLOPT_HEADER, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 60);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, strtoupper('GET'));
curl_setopt($curl, CURLOPT_POST, true);
$result = curl_exec($curl);
curl_close($curl);
return $result;
}
$accessKey = 'xxx';
$secretKey = 'xxx';
$bucket = '123_1';//存储空间名称
$key = '123.png';//文件名
echo fileDetail($accessKey,$secretKey,$bucket,$key);