文档首页/ Web3节点引擎服务/ API参考/ API/ 专享版/ 计费相关/ 创建/变更节点规格时的询价
更新时间：2023-11-03 GMT+08:00
查看PDF
分享

创建/变更节点规格时的询价

功能介绍

创建/变更节点规格时的询价

URI

POST /v1/{project_id}/node-provider/inquiry

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

最小长度：32

最大长度：32

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token

最小长度：1

最大长度：65535
表3 请求Body参数

参数

是否必选

参数类型

描述

subscribe_num

否

Integer

查询资源的数量

最小值：0

最大值：100

resource_specs

否

ResourceItem object

查询商品的信息列表
表4 ResourceItem

参数

是否必选

参数类型

描述

cpu

否

Long

CPU核数

最小值：1

最大值：1024

ram

否

Long

内存大小(MB)

最小值：0

最大值：1048576

framework_type

否

String

链类型

最小长度：0

最大长度：100

node_type

否

String

节点类型

最小长度：0

最大长度：100

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

currency

String

返回的货币单位

最小长度：0

最大长度：100

product_rating_result

Array of ProductRatingResult objects

询价商品的信息

数组长度：0 - 100
表6 ProductRatingResult

参数

参数类型

描述

id

String

返回的商品查询ID

最小长度：0

最大长度：100

amount

Number

商品价格

最小值：0

最大值：100

状态码： 400

表7 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度：3

最大长度：3

error_code

String

错误码

最小长度：12

最大长度：12

error_msg

String

错误信息

最小长度：1

最大长度：65535

message

String

错误详细信息

最小长度：0

最大长度：65535

状态码： 401

表8 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度：3

最大长度：3

error_code

String

错误码

最小长度：12

最大长度：12

error_msg

String

错误信息

最小长度：1

最大长度：65535

message

String

错误详细信息

最小长度：0

最大长度：65535

状态码： 500

表9 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度：3

最大长度：3

error_code

String

错误码

最小长度：12

最大长度：12

error_msg

String

错误信息

最小长度：1

最大长度：65535

message

String

错误详细信息

最小长度：0

最大长度：65535

请求示例

{
  "subscribe_num" : 1,
  "resource_specs" : {
    "cpu" : 8,
    "ram" : 32768,
    "framework_type" : "Ethereum",
    "node_type" : "Full node"
  }
}

响应示例

状态码： 200

请求成功

{
  "currency" : "USD",
  "product_rating_result" : [ {
    "id" : "instance",
    "amount" : 1.66
  } ]
}

状态码： 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

服务内部执行错误

错误码

请参见错误码。

父主题： 计费相关