node_to_shard

[ソース]

node_to_shardメソッドは、レジャーストアからシャードストアへのデータコピーを管理します。データコピーの開始、停止、状態チェックが可能です。

node_to_shardメソッドは、権限のないユーザーには実行できない管理メソッドです。

リクエストフォーマット

リクエストフォーマット例:

{
    "command": "node_to_shard",
    "action": "start"
}
{
    "method": "node_to_shard",
    "params": [{
        "action": "start"
    }]
}
#Syntax: node_to_shard start|stop|status
rippled node_to_shard start

リクエストは、以下のパラメータを含みます:

項目 説明
action String どのような動作をさせるかによって、 startstop または status のいずれかを指定します。

レスポンスフォーマット

正常レスポンス例:

{
  "result": {
    "message": "Database import initiated..."
  },
  "status": "success",
  "type": "response"
}
{
   "result" : {
      "message" : "Database import initiated...",
      "status" : "success"
   }
}
Loading: "/etc/rippled.cfg"
Connecting to 127.0.0.1:5005

{
   "result" : {
      "message" : "Database import initiated...",
      "status" : "success"
   }
}

レスポンスは、標準フォーマットに従っており、成功した場合は、以下の項目を含みます:

項目 説明
message 文字列 コマンドに応答して実行されたアクションを示す、可読性の高いメッセージ。

起こり得るエラー

  • いずれかの汎用エラータイプ
  • internal - コピーが実行されていない時にコピーの状態チェックをするといったような無効な操作の場合。
  • notEnabled - サーバが履歴シャードを保存するように環境設定されていない場合。
  • invalidParams - 1つ以上の項目が誤って定義されている、もしくは、1つ以上の必須項目が抜けている。