全部产品
Search
文档中心

阿里云交易和账单管理API:DescribeSavingsPlansUsageDetail - 节省计划使用率明细

更新时间:Jul 17, 2024

节省计划使用率明细查询

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
StartPeriodstring

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

2021-01-01 00:00:00
EndPeriodstring

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

2021-01-02 00:00:00
PeriodTypestring

查询使用情况摘要的时间粒度。枚举值:MONTH:月维度; DAY:天维度; HOUR:小时维度。

HOUR
Tokenstring

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

eyJwYWdlTnVtIjoyLCJwYWdlU2l6ZSI6MTB9
MaxResultsinteger

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

300
BillOwnerIdlong

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

123745698925000

返回参数

名称类型描述示例值
object
Codestring

状态码

Success
Messagestring

错误信息

Successful!
RequestIdstring

请求标识

79EE7556-0CFD-44EB-9CD6-B3B526E3A85F
Successboolean

是否成功

true
Dataobject

返回数据

TotalCountinteger

总数据个数

1000
NextTokenstring

下一页 token

eyJwYWdlTnVtIjoyLCJwYWdlU2ldhsSI6MTB9
Itemsarray<object>

数据项

object
Statusstring

当前状态

-1: 欠费、1: 生效

-1
Typestring

类型:通用型、ECS 计算型

通用型
UsagePercentagefloat

使用率

0.9
UserIdlong

账号 ID

123745698925000
InstanceIdstring

实例 ID

spn-a1fhs54c243hP22
Currencystring

币种

CNY
PostpaidCostfloat

按量标准费用

4.2
DeductValuefloat

节省计划已支出,即已使用承付款

3.94
StartPeriodstring

开始时间

2021-08-01 00:00:00
SavedCostfloat

节省净额

0.08
PoolValuefloat

节省计划总金额

29.84
UserNamestring

账号名称

test13@test.aliyun.com
EndPeriodstring

结束时间

2021-08-09 00:00:00

示例

正常返回示例

JSON格式

{
  "Code": "Success",
  "Message": "Successful!",
  "RequestId": "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F",
  "Success": true,
  "Data": {
    "TotalCount": 1000,
    "NextToken": "eyJwYWdlTnVtIjoyLCJwYWdlU2ldhsSI6MTB9",
    "Items": [
      {
        "Status": "-1",
        "Type": "通用型",
        "UsagePercentage": 0.9,
        "UserId": 123745698925000,
        "InstanceId": "spn-a1fhs54c243hP22",
        "Currency": "CNY",
        "PostpaidCost": 4.2,
        "DeductValue": 3.94,
        "StartPeriod": "2021-08-01 00:00:00",
        "SavedCost": 0.08,
        "PoolValue": 29.84,
        "UserName": "test13@test.aliyun.com",
        "EndPeriod": "2021-08-09 00:00:00"
      }
    ]
  }
}

错误码

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