文档首页/ Web3节点引擎服务 NES/ API参考/ API/ 专享版/ 计费相关/ CBC回调, 更新节点资源状态
更新时间:2023-11-03 GMT+08:00

CBC回调, 更新节点资源状态

功能介绍

CBC调用, 更新资源状态, 包括冻结, 解冻等

URI

PUT /v1/node-provider/status

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

scene

String

云服务状态的业务场景(ARREAR(默认值):欠费场景;POLICE:公安冻结场景;ILLEGAL:违规冻结场景)

最小长度:1

最大长度:32

effect

Integer

在冻结/解冻等操作下,云服务需要达到的主要效果。(1:实现/去除 冻结可释放; 2:实现/去除 冻结不可释放;3:实现/去除 冻结后不可续费 )

最小值:1

最大值:3

status

Integer

云服务或资源实例的状态: 0:解冻/正常(云服务恢复正常,比如解冻操作);1:冻结(资源和数据会保留,但租户无法再正常使用云服务);2:删除/终止(资源和数据将清除)

最小值:0

最大值:2

resources

Array of ResourceInfos objects

资源列表

数组长度:0 - 65535

表2 ResourceInfos

参数

是否必选

参数类型

描述

resource_infos

Array of ResourceTypeItem objects

资源信息

数组长度:0 - 65535

tenant_id

String

租户的projectID

最小长度:1

最大长度:64

表3 ResourceTypeItem

参数

是否必选

参数类型

描述

resource_type

String

资源类型

最小长度:1

最大长度:64

resource_id

String

资源id

最小长度:1

最大长度:64

响应参数

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

请求成功

null

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

服务内部执行错误

错误码

请参见错误码