获取文件信息_资源管理_API参考

描述

该接口用于在云存储平台上获取一个文件的信息描述，包括文件名，文件大小，文件的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=="

产品文档

用户服务

技术文章

获取文件信息

描述

请求说明

头部说明

头部说明

响应说明

范例