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

文档中心

立即注册

导航

GetFsUsage

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

调用 GetFsUsage 接口，查询目标文件存储实例的资源用量。

注意事项

仅支持文件存储场景实例使用该接口查询资源用量，数据湖场景实例不支持。

请求参数

Query

参数	类型	是否必填	示例值	说明
FsName	String	是	doc-test-cfs-1	目标文件存储实例的名称。
Unit	String	否	MiB	资源用量统计单位，支持的单位取值包含 B、KiB、MiB、GiB、TiB、EiB。默认值为 MiB。

返回参数

参数	类型	示例值	说明
AccountId	Integer	210**0903	当前账号的 ID。
FsName	String	doc-test-cfs-1	所查询的文件存储实例的名称。
TimeSnapshot	String	2022-10-25T15:17:59.202	查询结果时间戳。
Usage	String	1078146 MiB	文件存储实例的资源用量

请求示例

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

返回示例

{
    "Result": {
        "AccountId": "210**0903",
        "FsName": "doc-test-cfs-1",
        "TimeSnapshot": "2023-04-24T11:52:16.253",
        "Usage": "1078146 MiB"
    },
    "ResponseMetadata": {
        "RequestId": "2023042411***AAD6FCCE542BF3",
        "Action": "GetFsUsage",
        "Version": "2022-02-02",
        "Service": "cfs",
        "Region": "cn-beijing",
        "Error": null
    }
}

错误码

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

HttpCode	错误码	错误信息
404	FsNameNotFound	输入 FsName 参数时，FsName 不属于本账户。