查询资源包(包含RI、scu)的使用量情况。

限制:

  • 国内除RI、scu外,仅支持查询2021-04-10以后的数据(ecsRi、scu_bag不限制时间)
  • 海外除RI、scu外,暂时不支持查询(ecsRi、scu_bag不限制时间)

调试

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

请求参数

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

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

CommodityCode String ecsRi

取值:

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

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

IncludeShare Boolean true

是否包含财务云子账号的资源包用量

  • true:包含
  • false:不包含
StartTime String 2019-05-23 12:00:00

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

InstanceId String jsdgfsdhgsdjh

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

InstanceSpec String Instancetyp

实例对应的规格。

DeductedInstanceId String jsdgfsdhgsdjh

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

LastToken String CAESFQoTChEKDWRlZHVjdGVkX3RpbWUQARgBIuQBChgDEwAAADIwMjEtMDEtMjMgMTI6NTk6NDUKxwEDwgAAADFTMzAzMDMwMzAzMDMwMzAzMDMwMzAzMDMwMzAzMDMwMzIzNjM4MzYzNzVmMzEzNjMxMzEzMzM2MzczMjMwMzAzMDMwMzA1ZjMwMzAzMDMwMzAzMDMwMzAzMDMwMzYzOTM3MzgzNDMxMzAzMTM4MzEuTDgwMDAwMDAwMDAwMDY4ZjMuUzRmNTM1MzQyNDE0NzJkNjM2ZTJkMzY2YTYxMzIzMDZhNzc3NzYxMzAzMzMwLkw4MDAwMDE3NzJjZjgzNTAw

查询从LastToken之后开始返回。第一次查询填null,之后的从结果NextToken获取

Limit Integer 20

每次查询条数,默认为20,最大值为300。

返回数据

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

状态码。

Data Struct

返回数据。

DetailList Array of DetailList

明细数组。

DetailList
DeductDate String 2019/5/23 12:00

抵扣日期。

DeductFactorTotal Float 1

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

DeductHours Float 24

抵扣时长(小时)。 仅当RICommodityCode为ecsRi有效,SCU包不返回。 )

DeductMeasure Float 1

原始计量量

DeductQuantity Float 1

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

DeductedCommodityCode String rds

被抵扣商品code。

DeductedInstanceId String safdffghfgh

被抵扣实例ID。

DeductedProductDetail String 云数据库RDS

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

InstanceId String 324253645

预留实例ID。

InstanceSpec String rds.mysql.s3.large

被抵扣实例的规格。

Region String cn-hangzhou

计量中region,可以是空

ResCode String PutRequest

计费项

ShareUid Long 1111111111

抵扣实例所属uid

  • 共享抵扣:抵扣实例所属uid
  • 非共享抵扣:等于uid字段
Uid Long 1111111111

被抵扣实例的uid

NextToken String CAESFQoTChEKDWRlZHVjdGVkX3RpbWUQARgBIuQBChgDEwAAADIwMjEtMDEtMjMgMTI6NTk6NDUKxwEDwgAAADFTMzAzMDMwMzAzMDMwMzAzMDMwMzAzMDMwMzAzMDMwMzIzNjM4MzYzNzVmMzEzNjMxMzEzMzM2MzczMjMwMzAzMDMwMzA1ZjMwMzAzMDMwMzAzMDMwMzAzMDMwMzYzOTM3MzgzNDMxMzAzMTM4MzEuTDgwMDAwMDAwMDAwMDY4ZjMuUzRmNTM1MzQyNDE0NzJkNjM2ZTJkMzY2YTYxMzIzMDZhNzc3NzYxMzAzMzMwLkw4MDAwMDE3NzJjZjgzNTAw

下次请求查询开始标识,填充到request的LastToken字段中。如果返回为null,则标识查询结束

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
&CommodityCode=ecsRi
&StartTime=2019-05-23 12:00:00
&<公共请求参数>

正常返回示例

XML格式

<Message>Successful!</Message>
<RequestId>DF58589C-A06C-4224-8615-7797E6474FA3</RequestId>
<Data>
    <TotalCount/>
    <PageSize/>
    <PageNum/>
    <DetailList>
        <DetailList>
            <ResCode/>
            <Uid/>
            <DeductDate/>
            <InstanceSpec/>
            <DeductMeasure/>
            <InstanceId/>
            <DeductFactorTotal/>
            <DeductedProductDetail/>
            <Region/>
            <DeductedCommodityCode/>
            <DeductedInstanceId/>
            <DeductHours/>
            <DeductQuantity/>
        </DetailList>
    </DetailList>
</Data>
<Code>Success</Code>
<Success>true</Success>

JSON格式

{"Message":"Successful!","RequestId":"DF58589C-A06C-4224-8615-7797E6474FA3","Data":{"NextToken":"CAESFQoTChEKDWRlZHVjdGVkX3RpbWUQARgBIuQBChgDEwAAADIwMjEtMDEtMjMgMTI6NTk6NDUKxwEDwgAAADFTMzAzMDMwMzAzMDMwMzAzMDMwMzAzMDMwMzAzMDMwMzIzNjM4MzYzNzVmMzEzNjMxMzEzMzM2MzczMjMwMzAzMDMwMzA1ZjMwMzAzMDMwMzAzMDMwMzAzMDMwMzYzOTM3MzgzNDMxMzAzMTM4MzEuTDgwMDAwMDAwMDAwMDY4ZjMuUzRmNTM1MzQyNDE0NzJkNjM2ZTJkMzY2YTYxMzIzMDZhNzc3NzYxMzAzMzMwLkw4MDAwMDE3NzJjZjgzNTAw","DetailList":{"DetailList":[{"ResCode":"PutRequest","InstanceSpec":"rds.mysql.s3.large","InstanceId":"324253645","DeductFactorTotal":"1","DeductedProductDetail":"云数据库RDS","DeductedCommodityCode":"rds","DeductHours":"24","Uid":"1111111111","DeductDate":"2019/5/23 12:00","ShareUid":"1111111111","DeductMeasure":"1","Region":"cn-hangzhou ","DeductedInstanceId":"safdffghfgh","DeductQuantity":"1"}]}},"Code":"Success","Success":"true"}

错误码

HttpCode 错误码 错误信息 描述
400 InternalError An error occurred in the internal server. 内部服务器错误。
400 InvalidOwner The specified owner does not belong to caller. 指定的所有者不属于调用方。
400 InvalidParameter The specified request contains invalid parameters. 请求中包含无效参数。
400 MissingParameter The specified request lacks essential parameters. 该请求缺少必要参数。
400 NotApplicable The specified API is not applicable for the user. 此API不适用于调用方。
400 NotAuthorized The user is not authorized for the specified API. 此API未对该调用者进行授权。
400 CommodityNotSupported The specified commodity is not supported. 商品code无效
400 InvalidInstanceSpec The specified Instance specification is not valid. 实例规格无效
400 InvalidQueryTime The specified start time and end time are incorrect 开始时间或结束时间格式错误

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