You need to enable JavaScript to run this app.
导航

获取算力用量

最近更新时间2023.07.03 16:32:41

首次发布时间2022.02.25 18:58:32

本接口用于获取指定时间范围内的算力用量。

请求方法

GET

请求参数

下表列出了接口特定的请求参数以及公共请求参数 Action 和 Version。 其他公共参数,请参见公共参数

名称

类型

是否必选

示例值

描述

Action

String

GetVEENInstanceUsage

公共参数。该参数表示接口名称。取值:GetVEENInstanceUsage。

Version

String

2021-04-30

公共参数。该参数表示接口版本。取值:2021-04-30。

start_bill_cycle

String

2023-04

账单的起始时间。格式为 YYYY-MM。

end_bill_cycle

String

2023-04

账单的结束时间。格式为 YYYY-MM。

bill_method

String

MonthlyPeak

计费方式,取值范围:

  • MonthlyPeak(默认值):按月峰值计费。
  • DailyPeak:按日峰值计费。如您有日峰值计费或其他方式计费需求,请提交工单

返回数据

名称

类型

示例值

描述

usages

[]VEENInstanceUsage

请参见返回示例

算力用量信息。

请求示例

GET https://veenedge.volcengineapi.com/?Action=GetVEENInstanceUsage&Version=2021-04-30
&start_bill_cycle=2023-04
&end_bill_cycle=2023-04
&<其他公共参数>

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230530202106A639489FA0783395****",
        "Action": "GetVEENInstanceUsage",
        "Version": "2021-04-30",
        "Service": "veenedge",
        "Region": "cn-north-1"
    },
    "Result": {
        "usages": [
            {
                "bill_cycle": "2023-04",
                "bill_start_time": "2023-04-01",
                "bill_end_time": "2023-04-30",
                "usage": {
                    "CPU": 102,
                    "CloudHDD": 180,
                    "CloudSSD": 690,
                    "GPU_T4": 0,
                    "InstanceCount": 11,
                    "LocalHDD": 0,
                    "LocalSSD": 0,
                    "MEM": 212
                }
            }
        ]
    }
}

错误码

如果响应正文中包含 Error 字段,则表示 API 请求失败。关于错误码的更多信息,参见错误码