资源包用量查询 - 阿里云交易和账单管理API

限制：

仅支持查询最近1年的用量记录

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	QueryDPUtilizationDetail	系统规定参数。取值：QueryDPUtilizationDetail。
InstanceId	String	否	oss-123123	筛选查询的实例ID，为空时返回所有的使用的实例明细。
InstanceSpec	String	否	Instancetyp	实例对应的规格。
CommodityCode	String	否	ecsRi	商品code，如ecsRi、scu_bag等。如果填写该字段，则prodCode字段不生效
DeductedInstanceId	String	否	oss-123123	被抵扣实例的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。
LastToken	String	否	CAESF***zNTAw	查询从LastToken之后开始返回。第一次查询填null，之后的从结果NextToken获取
Limit	Integer	否	20	每次查询条数，默认为20，最大值为300。
IncludeShare	Boolean	是	true	是否包含财务云子账号的资源包用量 true：包含 false：不包含
ProdCode	String	否	oss	产品code，如：ecs

返回数据


名称	类型	示例值	描述
Code	String	Success	状态码。
Message	String	Successful！	错误信息。
RequestId	String	DF58589C-A06C-4224-8615-7797E6474FA3	请求ID。
Success	Boolean	true	是否成功。
Data	Object		返回数据。
NextToken	String	CAESF***zNTAw	下次请求查询开始标识，填充到request的LastToken字段中。如果返回为null，则标识查询结束
DetailList	Array of DetailList		明细数组。
DetailList
DeductedInstanceId	String	oss-123123	被抵扣实例ID。
InstanceId	String	oss-123123	预留实例ID。
DeductHours	Float	24	抵扣时长（小时）。仅当RICommodityCode为ecsRi有效，SCU包不返回。 )
ShareUid	Long	1111111111	抵扣实例所属uid 共享抵扣：抵扣实例所属uid 非共享抵扣：等于uid字段
DeductDate	String	2019/5/23 12:00	抵扣日期。
InstanceSpec	String	rds.mysql.s3.large	被抵扣实例的规格。
DeductedCommodityCode	String	rds	被抵扣商品code。
DeductedProductDetail	String	云数据库RDS	被抵商品（产品明细）名称。
DeductMeasure	Float	1	原始计量量
Region	String	cn-hangzhou	计量中region,可以是空
DeductQuantity	Float	1	实际抵扣对应按量实例的算力或容量。
DeductFactorTotal	Float	1	RI或SCU在该时间段的算力或容量总量。
ResCode	String	PutRequest	计费项
Uid	Long	1111111111	被抵扣实例的uid

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/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格式

HTTP/1.1 200 OK
Content-Type:application/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	InvalidInstanceSpec	The specified Instance specification is not valid.	实例规格无效
400	InvalidQueryTime	The specified start time and end time are incorrect	开始时间或结束时间格式错误
400	CommodityNotSupported	The specified commodity is not supported.	商品code无效

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