GetDirStat--大数据文件存储-火山引擎

文档中心

导航

GetDirStat

最近更新时间：2023.05.18 15:33:39首次发布时间：2023.05.18 14:53:14

调用 GetDirStat 接口，查询目标文件存储实例某个路径下存储的文件。

请求参数

Query

参数	类型	是否必填	示例值	说明
FsName	String	是	doc-test-cfs-1	文件存储实例的名称。
Path	String	是	/docfile	目标路径。

返回参数

参数	类型	示例值	说明
FsName	String	doc-test-cfs-1	文件存储实例的名称。
Path	String	/docfile	所查询的路径。
TimeSnapshot	String	2022-10-25T15:17:59.202	查询结果时间戳。
SizeBytes	Long	1130518251166	所查询路径下文件的总大小。
InodeNum	Long	120484	所查询路径下 inode 数量。
DirNum	Long	60208	所查询路径下文件夹的数量。
FileNum	Long	60276	所查询路径下文件的数量。

请求示例

GET https://open.volcengineapi.com?Action=GetDirStat&Version=2022-02-02&FsName=doc-test-cfs-1&Path=/docfile
Content-Type: application/json
Region: cn-beijing
ServiceName: cfs

返回示例

{
    "Result": {
        "FsName": "doc-test-cfs-1",
        "Path": "/docfile",
        "SizeBytes": 1130518251166,
        "InodeNum": 120484,
        "DirNum": 60208,
        "FileNum": 60276,
        "TimeSnapshot": "2023-04-24T14:07:32.412Z"
    },
    "ResponseMetadata": {
        "RequestId": "202304241407***D952731A08D1",
        "Action": "GetDirStat",
        "Version": "2022-02-02",
        "Service": "cfs",
        "Region": "cn-beijing",
        "Error": null
    }
}

错误码

下表列举了本接口的错误码信息。公共错误码信息，请参考公共错误码。

HttpCode	错误码	错误信息
404	FsNameNotFound	输入 FsName 参数时，FsName 不属于本账户。
404	PathNotFound	所查询路径不存在。