全部产品
Search

搜索本产品

    阿里云交易和账单管理API：DescribeResourceUsageDetail - 资源使用率明细

    文档中心

    阿里云交易和账单管理API：DescribeResourceUsageDetail - 资源使用率明细

    更新时间：Jul 29, 2024

    预留实例、SCU使用率明细查询。

    调试

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

    授权信息

    当前API暂无授权信息透出。

    请求参数

    名称类型必填描述示例值
    StartPeriodstring是

    格式：yyyy-MM-dd HH:mm:ss； 查询逻辑为包括该时间

    		2021-01-01 00:00:00
    EndPeriodstring否

    格式：yyyy-MM-dd HH:mm:ss；查询逻辑为不包括该时间；为空表示截止到当前时间

    		2021-01-02 00:00:00
    PeriodTypestring是

    MONTH：月维度； DAY：天维度； HOUR：小时维度；

    		HOUR
    NextTokenstring否

    分页 token，首页查询时传空，查询结果中返回下一页 token 地址。当结果 token 为空时表示全部查完。

    		eyJwYWdlTnVtIjoyLCJwYWdlU2l6ZSI6MTB9
    MaxResultsinteger否

    本次读取的最大数据记录数量。默认值：20，最大值：300。

    		200
    BillOwnerIdlong否

    如果为空查询当前账号及其托管子账号的数据，可传入托管子账号 ID，明确查询该子账号数据。

    		123745698925000
    ResourceTypestring是

    资源包类型。枚举值：RI：预留实例；SCU：存储容量单位包。

    		RI

    返回参数

    名称类型描述示例值
    object
    Codestring

    状态码

    		Success
    Messagestring

    错误信息

    		Successful!
    RequestIdstring

    请求标识

    		79EE7556-0CFD-44EB-9CD6-B3B526E3A85F
    Successboolean

    是否成功

    		true
    Dataobject

    返回数据

    NextTokenstring

    下一页的 token

    		eyJwYWdlTnVtIjoyLCJwYWdlU2l6ZSI6MTB9
    TotalCountinteger

    总条数

    		10000
    MaxResultsinteger

    本次读取的最大数据记录数量。默认值：20，最大值：300

    		200
    Itemsarray<object>

    数据条目

    object
    Statusstring

    状态

    		Valid
    UsagePercentagefloat

    使用率

    		0.5
    ResourceInstanceIdstring

    资源实例 ID

    		ecsri-bp147nnfz21225k9mpix00
    TotalQuantityfloat

    资源总量

    		2
    ReservationCoststring

    资源购买费用

    		0
    RegionNostring

    地域 Code

    		cn-hangzhou-dg-a01
    UserIdstring

    账号 ID

    		123745698925000
    StatusNamestring

    状态名称

    		生效
    CapacityUnitstring

    抵扣单位

    		算力*小时
    PotentialSavedCoststring

    潜在节省净值

    		0.13
    Currencystring

    币种

    		CNY
    ZoneNamestring

    可用区 Code

    		杭州 可用区I
    InstanceSpecstring

    规格

    		ecs.t5-lc2m1.nano
    EndTimestring

    结束时间

    		2021-04-01 01:00:00
    PostpaidCoststring

    按量成本等效值

    		0.06
    ImageTypestring

    操作系统

    		linux
    StartTimestring

    开始时间

    		2021-04-01 00:00:00
    Regionstring

    地域

    		华东1（杭州）
    DeductQuantityfloat

    抵扣量

    		1
    SavedCoststring

    节省净值

    		0.06
    Zonestring

    可用区

    		cn-hangzhou-i
    UserNamestring

    账号名称

    		test@aliyun.com
    Quantitylong

    资源数量

    		2

    示例

    正常返回示例

    JSON格式

    {
  "Code": "Success",
  "Message": "Successful!",
  "RequestId": "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F",
  "Success": true,
  "Data": {
    "NextToken": "eyJwYWdlTnVtIjoyLCJwYWdlU2l6ZSI6MTB9",
    "TotalCount": 10000,
    "MaxResults": 200,
    "Items": [
      {
        "Status": "Valid",
        "UsagePercentage": 0.5,
        "ResourceInstanceId": "ecsri-bp147nnfz21225k9mpix00",
        "TotalQuantity": 2,
        "ReservationCost": "0",
        "RegionNo": "cn-hangzhou-dg-a01",
        "UserId": "123745698925000",
        "StatusName": "生效",
        "CapacityUnit": "算力*小时",
        "PotentialSavedCost": "0.13",
        "Currency": "CNY",
        "ZoneName": "杭州 可用区I",
        "InstanceSpec": "ecs.t5-lc2m1.nano",
        "EndTime": "2021-04-01 01:00:00",
        "PostpaidCost": "0.06",
        "ImageType": "linux",
        "StartTime": "2021-04-01 00:00:00",
        "Region": "华东1（杭州）",
        "DeductQuantity": 1,
        "SavedCost": "0.06",
        "Zone": "cn-hangzhou-i",
        "UserName": "test@aliyun.com",
        "Quantity": 2
      }
    ]
  }
}

    错误码

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