创建节点
功能介绍
根据规格信息创建节点
URI
POST /v1/{project_id}/node-provider/networks/{network_id}/nodes
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID 最小长度:32 最大长度:32 |
| network_id | 是 | String | 网络ID 最小长度:36 最大长度:36 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token 最小长度:1 最大长度:65535 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| cpu | 是 | Long | CPU核数 最小值:1 最大值:1024 |
| ram | 是 | Integer | ram大小 最小值:1 最大值:1048576 |
| node_type | 是 | String | 节点类型(全节点:Full node或支持质押节点:Full node (Staking supported)) 最小长度:0 最大长度:100 |
| eps_id | 否 | String | 企业项目id 最小长度:0 最大长度:36 |
| consensus_client | 否 | String | 共识层客户端类型(共识层客户端:Prysm) 最小长度:0 最大长度:100 |
| charge_mode | 是 | String | 计费模式(按需:postPaid 或周期:prePaid) 最小长度:0 最大长度:100 |
| node_mode | 是 | String | 节点模式(单节点single或高可用HA) 最小长度:0 最大长度:100 |
| node_num | 是 | Integer | 节点数量(最多支持一次性创建5个) 最小值:1 最大值:5 |
| mev_enable | 否 | Boolean | 是否开启对接MEV 最小长度:1 最大长度:5 |
| mev_boost_relays | 否 | Array of strings | new relays 最小长度:1 最大长度:1000 数组长度:0 - 100 |
| is_nonrequired_validator_api_open | 否 | Boolean | 质押节点是否打开Validator非必需接口。该字段仅对质押节点有效,为true时质押节点可以使用full node节点常用方法,为false则无法使用。 最小长度:1 最大长度:5 |
响应参数
状态码: 200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| jobs | Array of strings | 任务列表 数组长度:0 - 100 |
状态码: 400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | String | 状态码 最小长度:3 最大长度:3 |
| error_code | String | 错误码 最小长度:12 最大长度:12 |
| error_msg | String | 错误信息 最小长度:1 最大长度:65535 |
| message | String | 错误详细信息 最小长度:0 最大长度:65535 |
状态码: 401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | String | 状态码 最小长度:3 最大长度:3 |
| error_code | String | 错误码 最小长度:12 最大长度:12 |
| error_msg | String | 错误信息 最小长度:1 最大长度:65535 |
| message | String | 错误详细信息 最小长度:0 最大长度:65535 |
状态码: 500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | String | 状态码 最小长度:3 最大长度:3 |
| error_code | String | 错误码 最小长度:12 最大长度:12 |
| error_msg | String | 错误信息 最小长度:1 最大长度:65535 |
| message | String | 错误详细信息 最小长度:0 最大长度:65535 |
请求示例
{
"cpu" : 2,
"ram" : 8192,
"node_type" : "Full node",
"charge_mode" : "postPaid",
"node_mode" : "single",
"node_num" : 1,
"eps_id" : 0
} 响应示例
状态码: 200
请求成功
{
"jobs" : [ "c85f549f-7c80-11ed-b1f5-0242a9fe1e03" ]
} 状态码: 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 | 服务内部执行错误 |
错误码
请参见错误码。