预留实例、SCU使用率明细查询

调试

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

请求参数

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

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

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。

返回数据

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

状态码

Data Struct

返回数据

Items Array of Item

数据条目

CapacityUnit String 算力*小时

抵扣单位

Currency String CNY

币种

DeductQuantity Float 1

抵扣量

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

结束时间

ImageType String linux

操作系统

InstanceSpec String ecs.t5-lc2m1.nano

规格

PostpaidCost String 0.06

按量成本等效值

PotentialSavedCost String 0.13

潜在节省净值

Quantity Long 2

资源数量

Region String 华东1(杭州)

地域

RegionNo String cn-hangzhou-dg-a01

地域Code

ReservationCost String 0

资源购买费用

ResourceInstanceId String ecsri-bp147nnfz21225k9mpix00

资源实例ID

SavedCost String 0.06

节省净值

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

开始时间

Status String Valid

状态

StatusName String 生效

状态名称

TotalQuantity Float 2

资源总量

UsagePercentage Float 0.5

使用率

UserId String 123745698925000

账号ID

UserName String test@aliyun.com

账号名称

Zone String cn-hangzhou-i

可用区

ZoneName String 杭州 可用区I

可用区Code

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=DescribeResourceUsageDetail
&PeriodType=HOUR
&ResourceType=RI
&StartPeriod=2021-01-01 00:00:00
&<公共请求参数>

正常返回示例

JSON格式

{"Message":"Successful!","RequestId":"79EE7556-0CFD-44EB-9CD6-B3B526E3A85F","Data":{"TotalCount":"10000","NextToken":"eyJwYWdlTnVtIjoyLCJwYWdlU2l6ZSI6MTB9","MaxResults":"200","Items":[{"Status":"Valid","RegionNo":"cn-hangzhou-dg-a01","PostpaidCost":"0.06","InstanceSpec":"ecs.t5-lc2m1.nano","UserName":"test@aliyun.com","EndTime":"2021-04-01 01:00:00","CapacityUnit":"算力*小时","Zone":"cn-hangzhou-i","SavedCost":"0.06","StartTime":"2021-04-01 00:00:00","Quantity":"2","StatusName":"生效","UsagePercentage":"0.5","ImageType":"linux","ReservationCost":"0","ZoneName":"杭州 可用区I","TotalQuantity":"2","UserId":"123745698925000","Currency":"CNY","PotentialSavedCost":"0.13","Region":"华东1(杭州)","DeductQuantity":"1","ResourceInstanceId":"ecsri-bp147nnfz21225k9mpix00"}]},"Code":"Success","Success":"true"}

错误码

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