预留实例、SCU覆盖率汇总查询

与费用中心“资源实例管理”菜单中的“覆盖率概况”的汇总数据一致。

当前支持RI和SCU两种资源的覆盖率查询。

调试

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

请求参数

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

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

PeriodType String HOUR

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

ResourceType String RI

RI:预留实例;SCU:存储容量单位包

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

时段覆盖率

CoveragePercentage Float 0.1

覆盖率

Period String 2020110100

时段

yyyyMMddHH

TotalCoverage Struct

总覆盖率

CapacityUnit String 算力*小时

抵扣单位

CoveragePercentage Float 1

总覆盖率

DeductQuantity Float 1

总抵扣量

TotalQuantity Float 1

总使用量

Message String Successful!

错误信息

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

请求标识

Success Boolean true

是否成功

示例

请求示例

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

正常返回示例

JSON格式

{"Message":"Successful!","RequestId":"79EE7556-0CFD-44EB-9CD6-B3B526E3A85F","Data":{"PeriodCoverage":[{"Period":"2020110100","CoveragePercentage":"0.1"}],"TotalCoverage":{"TotalQuantity":"1","CapacityUnit":"算力*小时","CoveragePercentage":"1","DeductQuantity":"1"}},"Code":"Success","Success":"true"}

错误码

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