pyGoEdge-UserPanel/reference/goedge 文档/NodeRegionService.md

NodeRegionService

节点区域相关服务

---

createNodeRegion

创建区域

• 角色：admin
• HTTP：POST https://backend.dooki.cloud/NodeRegionService/createNodeRegion
• RPC：rpc createNodeRegion (CreateNodeRegionRequest) returns (CreateNodeRegionResponse);

请求对象 (CreateNodeRegionRequest)

{
  "name": "string // 名称",
  "description": "string // 描述（备注）"
}

响应对象 (CreateNodeRegionResponse)

{
  "nodeRegionId": "int64"
}

调用示例

curl -X POST "https://backend.dooki.cloud/NodeRegionService/createNodeRegion" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---

deleteNodeRegion

删除区域

• 角色：admin
• HTTP：POST https://backend.dooki.cloud/NodeRegionService/deleteNodeRegion
• RPC：rpc deleteNodeRegion (DeleteNodeRegionRequest) returns (RPCSuccess);

请求对象 (DeleteNodeRegionRequest)

{
  "nodeRegionId": "int64"
}

响应对象 (RPCSuccess)

{}

调用示例

curl -X POST "https://backend.dooki.cloud/NodeRegionService/deleteNodeRegion" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---

findAllAvailableNodeRegions

查找所有启用的区域

• 角色：admin
• HTTP：POST https://backend.dooki.cloud/NodeRegionService/findAllAvailableNodeRegions
• RPC：rpc findAllAvailableNodeRegions (FindAllAvailableNodeRegionsRequest) returns (FindAllAvailableNodeRegionsResponse);

请求对象 (FindAllAvailableNodeRegionsRequest)

{}

响应对象 (FindAllAvailableNodeRegionsResponse)

{
  "nodeRegions": "[]NodeRegion"
}

调用示例

curl -X POST "https://backend.dooki.cloud/NodeRegionService/findAllAvailableNodeRegions" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---

findAllEnabledNodeRegions

查找所有区域

• 角色：admin
• HTTP：POST https://backend.dooki.cloud/NodeRegionService/findAllEnabledNodeRegions
• RPC：rpc findAllEnabledNodeRegions (FindAllEnabledNodeRegionsRequest) returns (FindAllEnabledNodeRegionsResponse);

请求对象 (FindAllEnabledNodeRegionsRequest)

{}

响应对象 (FindAllEnabledNodeRegionsResponse)

{
  "nodeRegions": "[]NodeRegion"
}

调用示例

curl -X POST "https://backend.dooki.cloud/NodeRegionService/findAllEnabledNodeRegions" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---

findEnabledNodeRegion

查找单个区域信息

• 角色：admin
• HTTP：POST https://backend.dooki.cloud/NodeRegionService/findEnabledNodeRegion
• RPC：rpc findEnabledNodeRegion (FindEnabledNodeRegionRequest) returns (FindEnabledNodeRegionResponse);

请求对象 (FindEnabledNodeRegionRequest)

{
  "nodeRegionId": "int64"
}

响应对象 (FindEnabledNodeRegionResponse)

{
  "nodeRegion": "NodeRegion"
}

调用示例

curl -X POST "https://backend.dooki.cloud/NodeRegionService/findEnabledNodeRegion" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---

updateNodeRegion

修改区域

• 角色：admin
• HTTP：POST https://backend.dooki.cloud/NodeRegionService/updateNodeRegion
• RPC：rpc updateNodeRegion (UpdateNodeRegionRequest) returns (RPCSuccess);

请求对象 (UpdateNodeRegionRequest)

{
  "nodeRegionId": "int64",
  "name": "string // 名称",
  "description": "string // 描述（备注）",
  "isOn": "bool // 是否启用"
}

响应对象 (RPCSuccess)

{}

调用示例

curl -X POST "https://backend.dooki.cloud/NodeRegionService/updateNodeRegion" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---

updateNodeRegionOrders

排序

• 角色：admin
• HTTP：POST https://backend.dooki.cloud/NodeRegionService/updateNodeRegionOrders
• RPC：rpc updateNodeRegionOrders (UpdateNodeRegionOrdersRequest) returns (RPCSuccess);

请求对象 (UpdateNodeRegionOrdersRequest)

{
  "nodeRegionIds": "[]int64"
}

响应对象 (RPCSuccess)

{}

调用示例

curl -X POST "https://backend.dooki.cloud/NodeRegionService/updateNodeRegionOrders" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---

updateNodeRegionPrice

修改价格项价格

• 角色：admin
• HTTP：POST https://backend.dooki.cloud/NodeRegionService/updateNodeRegionPrice
• RPC：rpc updateNodeRegionPrice (UpdateNodeRegionPriceRequest) returns (RPCSuccess);

请求对象 (UpdateNodeRegionPriceRequest)

{
  "nodeRegionId": "int64",
  "nodeItemId": "int64",
  "price": "float"
}

响应对象 (RPCSuccess)

{}

调用示例

curl -X POST "https://backend.dooki.cloud/NodeRegionService/updateNodeRegionPrice" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---