此篇内容尚无原站英文对应版本;切换语言后可浏览英文资料库。
该
可能的错误:
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节点服务器的版本号 |
- 任何通用错误类型。
