全部产品
云市场

预留实例用量查询

更新时间:2020-02-24 17:18:04

接口名

QueryRIUtilizationDetail

描述

用户查询RI的使用量情况,了解RI的抵扣详情。

请求参数

名称 类型 是否必填 说明
RIInstanceId String 筛选查询的预留实例ID,为空时返回所有的使用的预留实例明细
InstanceSpec String 预留实例对应的规格(Instance type或者scu capacity)
RICommodityCode String ecsRi:ecs的预留实例,scu_bag:存储容量单位包,默认为ecsRi
DeductedInstanceId String 被抵扣实例的Id,为空时返回所有实例的明细数据
StartTime Date 开始时间,格式:YYYY-MM-dd HH:mm:ss(例:2019-05-23 12:00:00)
EndTime Date 结束时间,格式:YYYY-MM-dd HH:mm:ss(例:2019-05-23 12:00:00)
PageNum Integer 查询分页,默认为1
PageSize Integer 每页条数,默认值:20,最大值:300

返回参数

名称 类型 说明
RIInstanceId Long 预留实例ID
InstanceSpec String 被抵扣实例的规格
DeductedInstanceId String 被抵扣实例id
DeductedCommodityCode String 被抵扣商品code
DeductedProductDetail String 被抵商品(产品明细)名称
DeductDate Date 抵扣日期
DeductHours Integer 抵扣时长(小时),仅当RICommodityCode为ecsRi有效,SCU包不返回
DeductQuantity Double 实际抵扣对应按量实例的算力或容量,当查询RI时返回被抵扣的vcpu数,查询SCU时返回被抵扣的磁盘容量(byte)
DeductFactorTotal Double RI或SCU在该时间段的算力或容量总量,当查询RI时返回vcpu数,查询SCU时返回磁盘总容量(byte)
PageNum Integer 当前分页数
PageSize Integer 每页条数

错误码

错误码 错误信息 HTTP状态码语义
NotApplicable This API is not applicable for caller. 400 该用户没有访问API的权限。
MissingParameter The specified parameter xx is mandatory for this request. 400 指定的xx参数未设置。
InvalidParameter The specified moduleCode is not valid. 400 指定的xx参数不合法。
InvalidQueryTime The specified start time and end time are incorrect. 400 指定的开始时间和结束时间不正确(开始时间>结束时间)。
InvalidInstanceSpec The specified Instance specification is not valid. 400 被抵扣实例的规格不正确。
CommodityNotSupported The specified RI commodity is not supported. 400 预留实例的产品明细编码不正确。

请求示例

  1. https://business.aliyuncs.com/?Action=QueryRIUtilizationDetail
  2. &EndTime=2019-05-23 12:00:00
  3. &RICommodityCode=scu_bag
  4. &StartTime=2018-10-23 12:00:00
  5. &公共参数

返回示例