节省计划使用率明细查询
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeSavingsPlansUsageDetail |
系统规定参数。取值：DescribeSavingsPlansUsageDetail。 |
| 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；查询逻辑为不包括该时间；为空表示截止到当前时间 |
| Token | String | 否 | eyJwYWdlTnVtIjoyLCJwYWdlU2l6ZSI6MTB9 |
分页token，首页查询时传空，查询结果中返回下一页token地址。当结果token为空时表示全部查完。 |
| MaxResults | Integer | 否 | 300 |
本次读取的最大数据记录数量。默认值：20，最大值：300。 |
| BillOwnerId | Long | 否 | 123745698925000 |
如果为空查询当前账号及其托管子账号的数据，可传入托管子账号ID，明确查询该子账号数据。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| Code | String | Success |
状态码 |
| Data | Struct |
返回数据 |
|
| Items | Array of Item |
数据项 |
|
| Currency | String | CNY |
币种 |
| DeductValue | Float | 3.94 |
节省计划已支出，即已使用承付款 |
| EndPeriod | String | 2021-08-09 00:00:00 |
结束时间 |
| InstanceId | String | spn-a1fhs54c243hP22 |
实例ID |
| PoolValue | Float | 29.84 |
节省计划总金额 |
| PostpaidCost | Float | 4.2 |
按量标准费用 |
| SavedCost | Float | 0.08 |
节省净额 |
| StartPeriod | String | 2021-08-01 00:00:00 |
开始时间 |
| Status | String | -1 |
当前状态 -1: 欠费、1: 生效 |
| Type | String | 通用型 |
类型：通用型、ECS计算型 |
| UsagePercentage | Float | 0.9 |
使用率 |
| UserId | Long | 123745698925000 |
账号ID |
| UserName | String | test13@test.aliyun.com |
账号名称 |
| NextToken | String | eyJwYWdlTnVtIjoyLCJwYWdlU2ldhsSI6MTB9 |
下一页token |
| TotalCount | Integer | 1000 |
总数据个数 |
| Message | String | Successful! |
错误信息 |
| RequestId | String | 79EE7556-0CFD-44EB-9CD6-B3B526E3A85F |
请求标识 |
| Success | Boolean | true |
是否成功 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeSavingsPlansUsageDetail
&PeriodType=HOUR
&StartPeriod=2021-01-01 00:00:00
&<公共请求参数>正常返回示例
JSON格式
{"Message":"Successful!","RequestId":"79EE7556-0CFD-44EB-9CD6-B3B526E3A85F","Data":{"TotalCount":"1000","NextToken":"eyJwYWdlTnVtIjoyLCJwYWdlU2ldhsSI6MTB9","Items":[{"Status":"-1","PostpaidCost":"4.2","Type":"通用型","UserName":"test13@test.aliyun.com","InstanceId":"spn-a1fhs54c243hP22","EndPeriod":"2021-08-09 00:00:00","UserId":"123745698925000","Currency":"CNY","SavedCost":"0.08","PoolValue":"29.84","DeductValue":"3.94","UsagePercentage":"0.9","StartPeriod":"2021-08-01 00:00:00"}]},"Code":"Success","Success":"true"}错误码
访问错误中心查看更多错误码。