调用DescribeResourceUsageDetail查询预留实例与SCU使用率明细-费用与成本-阿里云

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

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

bssapi:DescribeResourceUsageDetail

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
StartPeriod	string	是	格式：yyyy-MM-dd HH:mm:ss；查询逻辑为包括该时间	2021-01-01 00:00:00
EndPeriod	string	否	格式：yyyy-MM-dd HH:mm:ss；查询逻辑为不包括该时间；为空表示截止到当前时间	2021-01-02 00:00:00
PeriodType	string	是	MONTH：月维度； DAY：天维度； HOUR：小时维度；	HOUR
NextToken	string	否	分页 token，首页查询时传空，查询结果中返回下一页 token 地址。当结果 token 为空时表示全部查完。	eyJwYWdlTnVtIjoyLCJwYWdlU2l6ZSI6MTB9
MaxResults	integer	否	本次读取的最大数据记录数量。默认值：20，最大值：300。	200
BillOwnerId	integer	否	如果为空查询当前账号及其托管子账号的数据，可传入托管子账号 ID，明确查询该子账号数据。	123745698925000
ResourceType	string	是	资源包类型。枚举值：RI：预留实例；SCU：存储容量单位包。	RI

返回参数

名称	类型	描述	示例值
	object
Code	string	状态码	Success
Message	string	错误信息	Successful!
RequestId	string	请求标识	79EE7556-0CFD-44EB-9CD6-B3B526E3A85F
Success	boolean	是否成功	true
Data	object	返回数据
NextToken	string	下一页的 token	eyJwYWdlTnVtIjoyLCJwYWdlU2l6ZSI6MTB9
TotalCount	integer	总条数	10000
MaxResults	integer	本次读取的最大数据记录数量。默认值：20，最大值：300	200
Items	array<object>	数据条目
	object
Status	string	状态	Valid
UsagePercentage	number	使用率	0.5
ResourceInstanceId	string	资源实例 ID	ecsri-bp147nnfz21225k9mpix00
TotalQuantity	number	资源总量	2
ReservationCost	string	资源购买费用	0
RegionNo	string	地域 Code	cn-hangzhou-dg-a01
UserId	string	账号 ID	123745698925000
StatusName	string	状态名称	生效
CapacityUnit	string	抵扣单位	算力*小时
PotentialSavedCost	string	潜在节省净值	0.13
Currency	string	币种	CNY
ZoneName	string	可用区 Code	杭州可用区I
InstanceSpec	string	规格	ecs.t5-lc2m1.nano
EndTime	string	结束时间	2021-04-01 01:00:00
PostpaidCost	string	按量成本等效值	0.06
ImageType	string	操作系统	linux
StartTime	string	开始时间	2021-04-01 00:00:00
Region	string	地域	华东1（杭州）
DeductQuantity	number	抵扣量	1
SavedCost	string	节省净值	0.06
Zone	string	可用区	cn-hangzhou-i
UserName	string	账号名称	test@aliyun.com
Quantity	integer	资源数量	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
      }
    ]
  }
}

错误码

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

变更历史

更多信息，参考变更详情。