获得文件信息_API_Object Storage-文档中心

该接口用于在对象存储平台上获取文件的信息描述，包括文件名、文件大小、文件的ETag、文件上传时间、文件过期时间、文件存储类型等信息。

请求说明

请求格式

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

关于{param1}的生成规则，请参考EncodeEntryURI格式。

Header 参数

参数	是否必需	描述
Host	是	管理域名，可在控制台空间概览界面获取。
Authorization	是	管理凭证。用于接口认证。

响应说明

如果请求成功，将返回包含以下内容的 Json 字符串。

x-wcs-object-type: Appendable
x-wcs-next-append-position: <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>",
    "storageClass": "<storageClass>"
}

字段名称	是否必需	描述
x-wcs-object-type	否	对象类型。条件：新增对象时将返回该头部，固定值为 Appendable。
x-wcs-next-append-position	否	下次追加对象时的位置，即对象的大小。条件：对已上传对象进行追加操作时，将返回该头部。
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。注意：文件过期后实际清理的具体时间以服务器端任务执行为准，时间差异在一天内属正常。
storageClass	是	文件存储类型，如标准存储 - Standard，低频存储 - IA，归档存储 - Archive。
result	是	代表处理是否成功。`"true"`表示处理成功。

如果请求失败，将返回包含以下内容的 Json 字符串。

{
    "code":     "<code string>",
    "message":  "<message string>"
}

字段名称	是否必需	描述
code	是	HTTP请求响应代码，请参见 HTTP响应状态码。
message	是	枚举资源失败的提示信息。

示例

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

Media Delivery

Cloud Security

Web Performance

Enterprise Application

Storage

Edge Computing

Console Guide

API Docs

获得文件信息

请求说明

响应说明

示例

目录