节省计划使用率汇总查询

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeSavingsPlansUsageTotal

系统规定参数。取值:DescribeSavingsPlansUsageTotal。

PeriodType String HOUR

MONTH:月维度; DAY:天维度; HOUR:小时维度;

StartPeriod String 2021-01-01 00:00:00

格式:yyyy-MM-dd HH:mm:ss; 查询逻辑为包括该时间

EndPeriod String 2021-01-02 00:00:00

格式:yyyy-MM-dd HH:mm:ss;查询逻辑为不包括该时间;为空表示截止到当前时间

BillOwnerId Long 123745698925000

如果为空查询当前账号及其托管子账号的数据,可传入托管子账号ID,明确查询该子账号数据。

返回数据

名称 类型 示例值 描述
Code String Success

状态码

Data Struct

返回数据

PeriodCoverage Array of Item

时段使用率

Percentage Float 1

使用率

Period String 2021041500

时段

yyyyMMddHH

TotalUsage Struct

使用率汇总

PoolValue Float 100

节省计划总金额

PostpaidCost Float 200

按量标准费用

SavedCost Float 100

已节省 / 节省净额

UsagePercentage Float 1

总使用率

Message String Successful!

错误信息

RequestId String 79EE7556-0CFD-44EB-9CD6-B3B526E3A85F

请求标识

Success Boolean true

是否成功

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeSavingsPlansUsageTotal
&PeriodType=HOUR
&StartPeriod=2021-01-01 00:00:00
&<公共请求参数>

正常返回示例

JSON格式

{"Message":"Successful!","RequestId":"79EE7556-0CFD-44EB-9CD6-B3B526E3A85F","Data":{"PeriodCoverage":[{"Percentage":"1","Period":"2021041500"}],"TotalUsage":{"PostpaidCost":"200","SavedCost":"100","PoolValue":"100","UsagePercentage":"1"}},"Code":"Success","Success":"true"}

错误码

访问错误中心查看更多错误码。