You need to enable JavaScript to run this app.
导航
大数据文件存储
  • 文档首页
    • /
  • 大数据文件存储

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 不属于本账户。