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

调试

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

请求参数

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

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

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

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

RICommodityCode String ecsRi

取值:

  • ecsRi(默认值):ECS的预留实例。
  • scu_bag:存储容量单位包。
StartTime String 2019-05-23 12:00:00

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

RIInstanceId String dsudfgdsjh

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

InstanceSpec String Instancetyp

预留实例对应的规格。

DeductedInstanceId String jsdgfsdhgsdjh

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

PageNum Integer 1

页码,默认为1。

PageSize Integer 20

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

返回数据

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

状态码。

Data Struct

返回数据。

DetailList Array

明细数组。

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

抵扣日期。

DeductFactorTotal Float 1

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

DeductHours String 24

抵扣时长

(小时)。 仅当RICommodityCode为ecsRi有效,SCU包不返回。 )
DeductQuantity Float 1

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

DeductedCommodityCode String rds

被抵扣商品code。

DeductedInstanceId String safdffghfgh

被抵扣实例ID。

DeductedProductDetail String 云数据库RDS

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

InstanceSpec String rds.mysql.s3.large

被抵扣实例的规格。

RIInstanceId String 324253645

预留实例ID。

PageNum Long 1

页码。

PageSize Long 20

每页条数。

TotalCount Long 0

总记录数。

Message String Successful!

错误信息。

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

请求ID。

Success Boolean true

是否成功。

示例

请求示例

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

正常返回示例

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 格式

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

错误码

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