CDN加速

获取文件信息

更新时间:2021-07-22 15:05:18

获取文件信息

描述

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

请求说明

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

{param1}生成规则参考EncodeEntryURI格式

头部说明

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

响应说明

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

x-wcs-object-type: Appendable
x-wcs-next-append-positon: <Content-Length int64>
{
    "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>"
}
字段名 必填 描述
x-wcs-object-type 对象类型
条件:追加上传的对象会返回该头部,固定值为Appendable。
x-wcs-next-append-positon 下次追加对象位置,即返回对象大小。
条件:追加上传的对象会返回该头部。
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=="