该接口用于在云存储平台上获取一个文件的信息描述,包括文件名,文件大小,文件的ETag信息,文件上传时间及过期时间等信息。
GET /stat/{param1}
Host:<MgrDomain>
Authorization:<AccessToken>
{param1}
生成规则参考EncodeEntryURI格式参数 | 必填 | 描述 |
---|---|---|
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=="