本接口用于获取指定时间范围内的算力用量。
下表列出了接口特定的请求参数以及公共请求参数 Action 和 Version。 其他公共参数,请参见公共参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetVEEWInstanceUsage | 公共参数。该参数表示接口名称。取值:GetVEEWInstanceUsage。 |
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 | 计费方式,取值范围:
|
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
usages | 请参见返回示例 | 算力用量信息。 |
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 请求失败。关于错误码的更多信息,参见错误码。