开发文档

peers

此篇内容尚无原站英文对应版本;切换语言后可浏览英文资料库。
该peers命令返回streamd当前连接到该服务器的所有其他服务器的列表,包括有关其连接和同步状态的信息。 该peers请求是一个不能由非特权用户运行的管理命令! 请求格式的示例:
{
    "id": 2,
    "command": "peers"
}
streamd peers
该请求不包含其他参数。 一个成功回应的例子:
{
  "id": 2,
  "status": "success",
  "type": "response",
  "result": {
    "cluster": {},
    "peers": [
      {
        "address": "1.1.1.1:51235",
        "complete_ledgers": "18828845 - 18828973",
        "latency": 99,
        "ledger": "50A2577CE6EB8A92847C443BDA45F5C5F0A22B9C6F4B47DBA0C12BDA75001D01",
        "load": 60,
        "public_key": "n9LDBRoqPYY7RdkNXbX1dqZXVtUKcSqzs2CZPhTH7ymA9X7Xzmpj",
        "uptime": 99625,
        "version": "streamd-0.30.1-rc4"
      }
    ]
  }
}
{
   "result" : {
      "cluster" : {},
      "peers" : [
         {
            "address" : "1.1.1.1:51235",
            "complete_ledgers" : "18828830 - 18828957",
            "latency" : 137,
            "ledger" : "9447480E351221123B1A454356435A66C188D9794B0197A060637E19F074B421",
            "load" : 54,
            "public_key" : "n9LDBRoqPYY7RdkNXbX1dqZXVtUKcSqzs2CZPhTH7ymA9X7Xzmpj",
            "uptime" : 99566,
            "version" : "streamd-0.30.1-rc4"
         }
      ],
      "status" : "success"
   }
}
Loading: "/etc/streamd.cfg"
Connecting to 127.0.0.1:5005
{
   "result" : {
      "cluster" : {},
      "peers" : [
         {
            "address" : "5.1.1.1:51235",
            "complete_ledgers" : "18850253 - 18851277",
            "latency" : 63,
            "ledger" : "592C723DDBB1C5119F0D8288894060C83C8C2975A061D7C9971427D6798098F5",
            "load" : 36,
            "public_key" : "n9MT5EjnV912KGuBUqPs4tpdhzMPGcnDBrTuWkD9sWQHJ1kDcUcz",
            "uptime" : 51,
            "version" : "streamd-0.30.1"
         }
      ],
      "status" : "success"
   }
}
响应遵循标准格式,成功结果包含带有以下字段的JSON对象:
Field 类型 描述
cluster Object streamd如果配置为群集,则同一群集中的其他服务器的摘要。
peers Array 同级对象数组。
cluster对象的每个字段都是该streamd服务器的标识密钥对的公钥。(这与服务器pubkey_node在server_info命令中返回的值相同。)该字段的内容是包含以下字段的对象:
Field 类型 描述
tag String 配置文件中定义的此集群成员的显示名称。
fee Number (可以省略)此集群成员应用于交易成本的负荷乘数
age Number 自该群集成员上次群集报告以来的秒数。
peers数组的每个成员都是具有以下字段的对等对象:
Field Type Description
address String 该对等体所连接的IP地址和端口
cluster Boolean (可以省略)如果true当前服务器和对等服务器是同一个streamd群集的一部分。
name String (可以省略)如果对等体是同一个群集的一部分,则这是该配置文件中定义的该服务器的显示名称。
complete_ledgers String 范围表达式指示对等streamd体可用的分类帐版本的序列号
inbound Boolean (可以省略)如果true,对等方正在连接到本地服务器。
latency Number 节点的网络延迟(以毫秒为单位)
ledger String 节点最近关闭的分类账的散列
load Number 衡量节点服务器加载到本地服务器的负载量。较大的数字表示更多的负载。(负载测量的单位没有正式定义。)
protocol String (可能会被忽略)节点正在使用的协议版本,如果与本地服务器不一样。
public_key String (可以省略)可用于验证节点消息完整性的公钥。这与用于验证的密钥不同,但它遵循相同的格式。
sanity String (可以省略)该对等体是否遵循与当前服务器相同的规则和总账顺序。值insane可能表示对等体是并行网络的一部分。该值unknown表示当前服务器不确定对等体是否兼容。
status String (可能省略)来自节点的最新状态消息。可能是connecting,connected,monitoring,validating,或shutting。
uptime Number 您的streamd服务器连续连接到此对等设备的秒数
version string (可能省略)streamd节点服务器的版本号
可能的错误:
  • 任何通用错误类型。
THE NEXT CONNECTION

下一次连接,从这里开始。

加入 Stream 社区,一起探索价值互联。

联系我们