获取文件信息

描述

该接口用于在云存储平台上获取一个文件的信息描述,包括文件名,文件大小,文件的ETag信息,文件上传时间及过期时间等信息。

请求说明

GET /stat/{param1}
Host:<MgrDomain>
Authorization:<AccessToken>

头部说明

参数 必填 描述
Host 管理域名,可在用户管理界面获取
Authorization 管理凭证

响应说明

如果请求成功,则返回如下内容的Json串:

{
    "result":  "true",
    "code":  "200",
    "name":  "<fileName string>",
    "message":  "< message string>",
    "fsize":     "<FileSize  int>",
    "hash":     "<FileETag  string>",
    "mimeType:  "<MimeType  string>",
    "putTime":    "<PutTime   int64>"
    "expirationDate":   "<ExpirationDate string>"
}
字段名 必填 描述
code 请求返回状态码,参看HTTP响应状态码<返回码>
name 文件名
message 获取文件信息成功的提示信息
fsize 文件尺寸,单位:字节(Byte)
hash 文件的ETag信息
mimeType 以MIME信息表达的文件类型。请参见MIME Media Types(内容由IANA维护)
putTime 文件上传时的服务器端Epoch时间戳,单位:毫秒
例如返回时间戳为13603956734587420,对应实际时间为2013-02-09 15:41:13
expirationDate 文件过期时间,格式为YYYYMMDDhhmmss。
注:文件过期后被清理的具体时间点以服务端任务执行为准,一天内的时间差属正常现象
result 代表处理是否成功。"true"表示处理成功。

如果请求失败,则返回如下内容的Json字符串:

{
    "code":     "<code string>",
    "message":  "<ErrMsg string>"
}
字段名 必填 描述
code HTTP请求响应码,参见HTTP响应状态码<返回码>
message 获取文件信息失败的提示信息

范例

curl -v -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:OGZmYzQ0ZmM2MDU5N2FhZWRhMDhjNWNmZjcxZjE5MmEwNjUxOGU4Nw==" --url "http://mgrDomain/stat/aW1hZ2VzOmFmZGRkLnBuZw=="