文档首页/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

服务内部执行错误

错误码

请参见错误码。

父主题：计费相关