本文导读

展开导读

文档首页/ Web3节点引擎服务 NES/ API参考/ API/ 专享版/ 计费相关/ 获取计量话单

获取计量话单

更新时间：2023-11-03 GMT+08:00

查看PDF

功能介绍

获取计量话单

URI

GET /v1/node-provider/metering

表1 Query参数
参数	是否必选	参数类型	描述
limit	是	Integer	每页返回的条目数量最小值：1 最大值：1000
offset	是	Integer	分页查询的起始位置最小值：0 最大值：1000
start_time	是	String	起始的UTC时间最小长度：14 最大长度：14
end_time	是	String	结束的UTC时间最小长度：14 最大长度：14

请求参数

无

响应参数

状态码： 200

表2 响应Body参数
参数	参数类型	描述
source_data	Array of BillingTicket objects	话单列表数组长度：0 - 1000

表3 BillingTicket
参数	参数类型	描述
user_id	String	用户的ProjectID 最小长度：0 最大长度：100
region_id	String	RegionID 最小长度：0 最大长度：100
cloud_service_type	String	云服务类型最小长度：0 最大长度：100
resource_type	String	资源类型最小长度：0 最大长度：100
resource_spec_code	String	资源编码最小长度：0 最大长度：100
resource_id	String	资源ID 最小长度：0 最大长度：100
begin_time	String	起始时间的UTC字符串最小长度：14 最大长度：14
end_time	String	结束时间的UTC字符串最小长度：14 最大长度：14
accumulate_factor_name	String	计费因子ID 最小长度：0 最大长度：100
accumulate_factor_value	Integer	资源使用量最小值：0 最大值：10000000

状态码： 400

表4 响应Body参数
参数	参数类型	描述
code	String	状态码最小长度：3 最大长度：3
error_code	String	错误码最小长度：12 最大长度：12
error_msg	String	错误信息最小长度：1 最大长度：65535
message	String	错误详细信息最小长度：0 最大长度：65535

状态码： 401

表5 响应Body参数
参数	参数类型	描述
code	String	状态码最小长度：3 最大长度：3
error_code	String	错误码最小长度：12 最大长度：12
error_msg	String	错误信息最小长度：1 最大长度：65535
message	String	错误详细信息最小长度：0 最大长度：65535

状态码： 500

表6 响应Body参数
参数	参数类型	描述
code	String	状态码最小长度：3 最大长度：3
error_code	String	错误码最小长度：12 最大长度：12
error_msg	String	错误信息最小长度：1 最大长度：65535
message	String	错误详细信息最小长度：0 最大长度：65535

请求示例

无

响应示例

状态码： 200

请求成功

{
  "source_data" : [ {
    "user_id" : "4939f7d0301c4ec281f1ff9ee8bba760",
    "region_id" : "cn-north-7",
    "cloud_service_type" : "hws.service.type.bcs",
    "resource_type" : "hws.resource.type.pne",
    "resource_spec_code" : "nes.dedicatednode.fullnode.staking.storage.eth.2U8G",
    "resource_id" : "a11db18d-12fd-11ee-8522-fa163e6c5c5e",
    "begin_time" : "1688983800",
    "end_time" : "1688983800",
    "accumulate_factor_name" : "nodestoragecapacityduration",
    "accumulate_factor_value" : 351
  } ]
}

状态码： 400

请求失败

{
  "code" : 400,
  "error_code" : "BCS.03400001",
  "error_msg" : "Invalid request.",
  "message" : "unmarshal request data error"
}

状态码： 401

鉴权失败

{
  "code" : 401,
  "error_code" : "BCS.03401001",
  "error_msg" : "Authorization failed.",
  "message" : "request token is not valid"
}

状态码： 500

服务内部执行错误

{
  "code" : 500,
  "error_code" : "BCS.03500001",
  "error_msg" : "Internal error.",
  "message" : "project [xxx] node [xxx] get service bearer user token error"
}

状态码

状态码	描述
200	请求成功
400	请求失败
401	鉴权失败
500	服务内部执行错误

错误码

请参见错误码。

父主题： 计费相关

上一篇：创建/变更节点规格时的询价

下一篇：CBC回调, 更新节点资源状态

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

获取计量话单

功能介绍

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

意见反馈

文档内容是否对您有帮助？

文档反馈