文档首页/ 合作伙伴中心/ API参考/ 管理交易/ 管理资源包/ 查询资源包使用量
更新时间：2023-11-01 GMT+08:00
查看PDF
分享

查询资源包使用量

功能介绍

客户在伙伴销售平台根据资源项维度查询客户的资源包使用量。

接口约束

该接口只允许使用客户AK/SK或者Token调用，不允许使用合作伙伴AK/SK或者Token调用。

资源包失效时间超过18个月则无法查询其信息。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v2/payments/free-resources/usages/details/query

表1 Header参数

参数

是否必选

取值范围

描述

X-Language

否

最大长度：8

语言。

  • 中文：zh_CN
  • 英文：en_US

缺省为zh_CN。

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

free_resource_ids

是

List<string>

最大个数：100

资源项ID列表，每个最大64字节。

资源项ID，一个资源包中会含有多个资源项，一个使用量类型对应一个资源项。资源项ID来自查询资源包列表接口的响应。

请求示例

POST https://bss-intl.myhuaweicloud.com/v2/payments/free-resources/usages/details/query HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

{
    "free_resource_ids": [
        "d4463497-991b-439d-9ab6-23f9ed197fe9"
    ]
}

响应消息

响应参数

参数

参数类型

取值范围

描述

error_code

String

20

状态码。

具体请参考状态码。只有失败才返回该字段。

error_msg

String

1000

错误描述信息。

只有失败才返回该字段。

free_resources

List<FreeResourceDetail>

-

资源套餐内的资源项信息（资源项ID级的详情），具体参见表2。
表2 FreeResourceDetail

参数

参数类型

取值范围

描述

free_resource_id

String

最大长度：64

资源项ID，一个资源包中会含有多个资源项，一个使用量类型对应一个资源项。

free_resource_type_name

String

-

资源项类型名称。

quota_reuse_cycle

Integer

-

重置周期，只有quota_reuse_mode为可重置，该字段才有意义。

  • 1：小时
  • 2：天
  • 3：周
  • 4：月
  • 5：年

quota_reuse_cycle_type

Integer

-

重置周期类别，只有quota_reuse_mode为可重置，该字段才有意义。

  • 1：按自然周期重置

    是指重置周期是按照自然月/年来重置，例如如果周期是月，按自然周期重置，表示每个月的1号重置。

  • 2：按订购周期重置。

    是指重置周期是按照订购时间来重置，例如如果周期是月，按订购周期重置，15号订购了该套餐，表示每个月的15号重置。

usage_type_name

String

-

使用量类型名称。

start_time

String

-

开始时间，格式UTC。

  • 如果quota_reuse_mode为可重置，则此时间为当前时间所在的重置周期的开始时间。
  • 如果quota_reuse_mode为不可重置，则此时间为订购实例的生效时间。

end_time

String

-

结束时间，格式UTC。

  • 如果quota_reuse_mode为可重置，则此时间为当前时间所在的重置周期的结束时间。
  • 如果quota_reuse_mode为不可重置，则此时间为订购实例的失效时间。

amount

BigDecimal

-

资源剩余额度，针对可重置资源包，是指当前重置周期内的剩余量。

original_amount

BigDecimal

-

资源原始额度，针对可重置资源包，是指每个重置周期内的总量。

measure_id

Integer

-

度量单位，免费资源套餐额度度量单位。您可以调用查询度量单位列表接口获取。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time 
{
    "free_resources": [
        {
            "free_resource_id": "d4463497-991b-439d-9ab6-23f9ed197fe9",
            "free_resource_type_name": "test1",
            "quota_reuse_cycle": 4,
            "quota_reuse_cycle_type": 1,
            "usage_type_name": "时长",
            "start_time": "2021-04-30T03:30:56Z",
            "end_time": "2021-05-31T15:59:59Z",
            "amount": 100,
            "original_amount": 100,
            "measure_id": 37
        }
    ]
}

状态码

  • 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
  • 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。

HTTP状态码

错误码

错误描述

400

CBC.0100

参数错误。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。
父主题： 管理资源包