查询资源包(包含RI、scu)的使用量情况。
接口说明
限制：
- 仅支持查询最近 1 年的用量记录
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| bss:FrDeductLogQueryRequest | Read |
|
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| InstanceId | string | 否 | 筛选查询的实例 ID，为空时返回所有的使用的实例明细。 | oss-123123 |
| InstanceSpec | string | 否 | 实例对应的规格。 | Instancetyp |
| CommodityCode | string | 否 | 商品 code，如 ecsRi、scu_bag 等。如果填写该字段，则 prodCode 字段不生效 | ecsRi |
| DeductedInstanceId | string | 否 | 被抵扣实例的 ID，为空时返回所有实例的明细数据。 | oss-123123 |
| StartTime | string | 是 | 开始时间，格式：YYYY-MM-dd HH:mm:ss。 | 2019-05-23 12:00:00 |
| EndTime | string | 是 | 结束时间，格式：YYYY-MM-dd HH:mm:ss。 | 2019-05-23 12:00:00 |
| LastToken | string | 否 | 查询从 LastToken 之后开始返回。第一次查询填 null，之后的从结果 NextToken 获取 | CAESF***zNTAw |
| Limit | integer | 否 | 每次查询条数，默认为 20，最大值为 300。 | 20 |
| IncludeShare | boolean | 是 | 是否包含财务云子账号的资源包用量
| true |
| ProdCode | string | 否 | 产品 code，如：ecs | oss |
返回参数
示例
正常返回示例
JSON格式
{
"Code": "Success",
"Message": "Successful！",
"RequestId": "DF58589C-A06C-4224-8615-7797E6474FA3",
"Success": true,
"Data": {
"NextToken": "CAESF***zNTAw",
"DetailList": {
"DetailList": [
{
"DeductedInstanceId": "oss-123123",
"InstanceId": "oss-123123",
"DeductHours": 24,
"ShareUid": 1111111111,
"DeductDate": "2019/5/23 12:00",
"InstanceSpec": "rds.mysql.s3.large",
"DeductedCommodityCode": "rds",
"DeductedProductDetail": "云数据库RDS",
"DeductMeasure": 1,
"Region": "cn-hangzhou ",
"DeductQuantity": 1,
"DeductFactorTotal": 1,
"ResCode": "PutRequest",
"Uid": 1111111111
}
]
}
}
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 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无效 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|
暂无变更历史