获取文件信息
更新时间：2022-05-24 18:28:19
该接口用于在云存储平台上获取一个文件的信息描述，包括文件名，文件大小，文件的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>",
"storageClass": "<storageClass>"
}
| 字段名 | 必填 | 描述 |
|---|---|---|
| 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。 注：文件过期后被清理的具体时间点以服务端任务执行为准，一天内的时间差属正常现象。 |
| storageClass | 是 | 文件存储类型，如Standard–标准存储、IA-低频存储、Archive–归档存储。 |
| result | 是 | 代表处理是否成功。"true"表示处理成功。 |
如果请求失败，则返回如下内容的Json字符串：
{
"code": "<code string>",
"message": "<ErrMsg string>"
}
| 字段名 | 必填 | 描述 |
|---|---|---|
| code | 是 | HTTP请求响应码，参见HTTP响应状态码。 |
| message | 是 | 获取文件信息失败的提示信息。 |
范例
curl -v -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:OGZmYzQ0ZmM2MDU5N2FhZWRhMDhjNWNmZjcxZjE5MmEwNjUxOGU4Nw==" --url "http://mgrDomain/stat/aW1hZ2VzOmFmZGRkLnBuZw=="
本篇文档内容对您是否有帮助？
有帮助
我要反馈