用户指南 | 发明者量化

GetNodeList

获取当前账号可以使用的托管者列表，包括自己的托管者和平台的公共托管者。

示例

列出全部托管者及其在线状态。


    python
    
    
# api() 见「签名验证」页面的Python示例
r = api('GetNodeList')
for node in r['data']['result']['nodes']:
    print(node['id'], node['name'], node['online'])

返回值

类型	描述
object	成功时`data.result`包含托管者总数`all`和托管者数组`nodes`，字段见下方属性表。

参数

名称	类型	必填	描述
offset	number	否	分页偏移，默认为0。
limit	number	否	每页数量；不传或小于等于0时返回全部。

属性

名称	类型	描述
all	number	托管者总数（包括公共托管者）。
nodes	array	托管者数组，每个元素的字段见下面几行（字面意思明显的字段不再列出）。
nodes[].id	number	托管者Id，即实盘配置中的`node`。
nodes[].build	string	版本号。
nodes[].version	string	托管者详细版本信息。
nodes[].online	bool	是否在线。
nodes[].is_owner	bool	`true`为私有托管者，`false`为公共托管者。
nodes[].public	number	`0`为私有托管者，`1`为公共托管者。
nodes[].loaded	number	负载，即运行在该托管者上的策略实例个数。
nodes[].city	string	所在城市。
nodes[].region	string	地理位置。
nodes[].wd	number	是否开启离线报警，`0`表示未开启。

备注

一键租用的托管者还有以ecs_、unit_开头的字段，记录服务器的运营商、配置、状态以及计费周期、价格等信息。

返回示例


            json
            
            
{
    "code": 0,
    "data": {
        "result": {
            "all": 1,
            "nodes": [{
                "build": "3.7",
                "city": "...",
                "created": "2024-11-08 09:21:08",
                "date": "2024-11-08 16:37:16",
                "forward": "...",
                "guid": "...",
                "host": "node.fmz.com:9902",
                "id": 123,
                "ip": "...",
                "is_owner": true,
                "loaded": 0,
                "name": "MacBook-Pro-2.local",
                "online": true,
                "os": "darwin/amd64",
                "peer": "...",
                "public": 0,
                "region": "...",
                "tunnel": false,
                "version": "...",
                "wd": 0
            }]
        },
        "error": null
    }
}