调用QueryRIUtilizationDetail查询RI的使用量情况。

调试

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

请求参数

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

系统规定参数。取值:QueryRIUtilizationDetail

RIInstanceId String dsudfgdsjh

筛选查询的预留实例ID,为空时返回所有的使用的预留实例明细。

InstanceSpec String Instancetyp

预留实例对应的规格。

RICommodityCode String ecsRi

取值:

  • ecsRi(默认值):ECS的预留实例。
  • scu_bag:存储容量单位包。
DeductedInstanceId String jsdgfsdhgsdjh

被抵扣实例的ID,为空时返回所有实例的明细数据。

StartTime String 2019-05-23 12:00:00

开始时间,格式:YYYY-MM-dd HH:mm:ss。

EndTime String 2019-05-23 12:00:00

结束时间,格式:YYYY-MM-dd HH:mm:ss。

PageNum Integer 1

页码,默认为1。

PageSize Integer 20

每页条数,默认为20,最大值为300。

返回数据

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

状态码。

Message String Successful!

错误信息。

RequestId String DF58589C-A06C-4224-8615-7797E6474FA3

请求ID。

Success Boolean true

是否成功。

Data Object

返回数据。

PageNum Long 1

页码。

PageSize Long 20

每页条数。

TotalCount Long 0

总记录数。

DetailList Array of DetailList

明细数组。

DetailList
DeductedCommodityCode String rds

被抵扣商品code。

DeductedProductDetail String 云数据库RDS

被抵商品(产品明细)名称。

DeductedInstanceId String safdffghfgh

被抵扣实例ID。

DeductFactorTotal Float 1

RI或SCU在该时间段的算力或容量总量。

DeductQuantity Float 1

实际抵扣对应按量实例的算力或容量。

DeductHours String 24

抵扣时长(小时)。

仅当RICommodityCode为ecsRi有效,SCU包不返回。

DeductDate String 2019-05-23 12:00:00

抵扣日期。

RIInstanceId String 324253645

预留实例ID。

InstanceSpec String rds.mysql.s3.large

被抵扣实例的规格。

示例

请求示例

http(s)://[Endpoint]/?Action=QueryRIUtilizationDetail
&EndTime=2019-05-23 12:00:00
&RICommodityCode=ecsRi
&StartTime=2019-05-23 12:00:00
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<QueryRIUtilizationDetailResponse>
    <RequestId>DF58589C-A06C-4224-8615-7797E6474FA3</RequestId>
    <Message>Successful!</Message>
    <Data>
        <TotalCount>0</TotalCount>
        <PageNum>1</PageNum>
        <PageSize>20</PageSize>
        <DetailList>
        </DetailList>
    </Data>
    <Code>Success</Code>
    <Success>true</Success>
</QueryRIUtilizationDetailResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "DF58589C-A06C-4224-8615-7797E6474FA3",
  "Message" : "Successful!",
  "Data" : {
    "TotalCount" : 0,
    "PageNum" : 1,
    "PageSize" : 20,
    "DetailList" : {
      "DetailList" : [ ]
    }
  },
  "Code" : "Success",
  "Success" : true
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidQueryTime The specified start time and end time are incorrect 开始时间或结束时间格式错误
400 InvalidInstanceSpec The specified Instance specification is not valid. 实例规格无效

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