预留实例、SCU覆盖率明细查询

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

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

3. 提供“小时”、“天”,“月”三种维度的覆盖率查询。

调试

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

请求参数

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

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

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;查询逻辑为不包括该时间;为空表示截止到当前时间

NextToken String eyJwYWdlTnVtIjoyLCJwYWdlU2l6ZSI6MTB9

分页token,首页查询时传空,查询结果中返回下一页token地址。当结果token为空时表示全部查完。

MaxResults Integer 200

本次读取的最大数据记录数量。默认值:20,最大值:300。

BillOwnerId Long 123745698925000

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

返回数据

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

状态码

Data Struct

返回数据

Items Array of Item

数据项

CapacityUnit String 算力*小时

抵扣单位

CommodityCode String ecs

产品明细Code

CommodityName String 云服务器ECS-按量付费

产品明细

CoveragePercentage Float 1

覆盖率

Currency String CNY

币种

DeductQuantity Float 1

抵扣量

EndTime String 2021-04-01 01:00:00

结束时间

InstanceId String i-bp1d9x623987rlj0dx4xx

按量实例ID

InstanceSpec String ecs.t5-lc2m1.nano

规格

PaymentAmount Float 0

账单金额

ProductCode String ecs

产品Code

ProductName String 云服务器 ECS

产品名称

Region String 华东1(杭州)

地域

RegionNo String cn-hangzhou-dg-a01

地域Code

StartTime String 2021-04-01 00:00:00

开始时间

TotalQuantity Float 1

总用量

UserId String 123745698925000

账号ID

UserName String test13@test.aliyun.com

账号名称

Zone String cn-hangzhou-i

可用区Code

ZoneName String 杭州 可用区I

可用区

MaxResults Integer 200

本页条数

NextToken String eyJwYWdlTnVtIjoyLCJwYWdlU2l6ZSI6MTB9

下一页的token

TotalCount Integer 10000

总条数

Message String Successful!

错误信息

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

请求标识

Success Boolean true

是否成功

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeResourceCoverageDetail
&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":{"TotalCount":"10000","NextToken":"eyJwYWdlTnVtIjoyLCJwYWdlU2l6ZSI6MTB9","MaxResults":"200","Items":[{"RegionNo":"cn-hangzhou-dg-a01","InstanceSpec":"ecs.t5-lc2m1.nano","UserName":"test13@test.aliyun.com","EndTime":"2021-04-01 01:00:00","ProductName":"云服务器 ECS","CapacityUnit":"算力*小时","InstanceId":"i-bp1d9x623987rlj0dx4xx","ProductCode":"ecs","Zone":"cn-hangzhou-i","StartTime":"2021-04-01 00:00:00","PaymentAmount":"0","ZoneName":"杭州 可用区I","TotalQuantity":"1","UserId":"123745698925000","Currency":"CNY","CommodityCode":"ecs","Region":"华东1(杭州)","CoveragePercentage":"1","CommodityName":"云服务器ECS-按量付费","DeductQuantity":"1"}]},"Code":"Success","Success":"true"}

错误码

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