mirror of https://github.com/XRPLF/xrpl-dev-portal.git synced 2025-11-13 00:05:49 +00:00

Files

mDuo13 f130a7bc60 Update rippled repo URL

Fix #2070.

2023-09-15 15:21:58 -07:00

6.0 KiB

Raw Blame History

html, parent, blurb, labels

html

parent

blurb

labels

download_shard.html

logging-and-data-management-methods.html

レジャー履歴の特定のシャードをダウンロードします。

データ保持

download_shard

[ソース]

サーバーに対し、外部ソースから特定の履歴レジャーデータのシャードをダウンロードするように指示します。rippledサーバーで履歴シャードが保管されるように設定する必要があります。[新規: rippled 1.1.0][]

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

外部ソースからHTTPSを使用してシャードがlz4圧縮 tarアーカイブとして提供される必要があります。アーカイブには、NuDB形式のシャードディレクトリとデータファイルが含まれている必要があります。

通常、このメソッドを使用してシャードをダウンロードしてインポートすれば、ピアツーピアネットワークからシャードを個別に取得するよりも短い時間で取得できます。また、サーバーから提供される特定範囲のシャードまたはシャードのセットを選択する場合にもこのメソッドを使用できます。

要求フォーマット

要求フォーマットの例:

WebSocket

{
  "command": "download_shard",
  "shards": [
    {"index": 1, "url": "https://example.com/1.tar.lz4"},
    {"index": 2, "url": "https://example.com/2.tar.lz4"},
    {"index": 5, "url": "https://example.com/5.tar.lz4"}
  ]
}

JSON-RPC

{
  "method": "download_shard",
  "params": [
    {
      "shards": [
        {"index": 1, "url": "https://example.com/1.tar.lz4"},
        {"index": 2, "url": "https://example.com/2.tar.lz4"},
        {"index": 5, "url": "https://example.com/5.tar.lz4"}
      ]
    }
  ]
}

要求には以下のフィールドが含まれます。

`Field`	型	説明
`shards`	配列	ダウンロードするシャードとダウンロード元を記述したShard Descriptorオブジェクト（以下の説明を参照）のリスト。

validateのフィールドは廃止予定であり、今後予告なしに削除される可能性があります。rippledは全てのシャードの検証を実行します。[更新: rippled 1.6.0][]

shards配列の各Shard Descriptorオブジェクトには以下のフィールドが含まれています。

`Field`	型	説明
`index`	数値	取得するシャードのインデックス。本番環境のXRP Ledgerでは、最も古いシャードのインデックスは1であり、このシャードにはレジャー32750～32768が含まれています。次のシャードのインデックスは2であり、このシャードにはレジャー32769～49152が含まれています。
`url`	文字列	このシャードをダウンロードできるURL。このURLは`https://`か`http://`かで始まり`.tar.lz4`（大文字小文字の区別なし）で終わる必要があります。このダウンロードを提供するWebサーバーは、信頼できる認証局（CA）によって署名された有効なTLS証明書を使用する必要があります。（`rippled`はオペレーティングシステムのCAストアーを使用します。） [更新: rippled 1.7.0][]

応答フォーマット

処理が成功した応答の例:

WebSocket

{
  "result": {
    "message": "downloading shards 1-2,5"
  },
  "status": "success",
  "type": "response"
}

JSON-RPC

200 OK

{
  "result": {
    "message": "downloading shards 1-2,5",
    "status": "success"
  }
}

この応答は[標準フォーマット][]に従っており、正常に完了した場合は結果に次のフィールドが含まれます。

`Field`	型	説明
`message`	文字列	この要求に対応して実行されたアクションを説明するメッセージ。

ヒント: サーバーで使用可能なシャードを確認するには、[crawl_shardsメソッド[]を使用します。または、シャードストアーとして設定されたロケーションのサブフォルダー（rippled.cfgの[shard_db]のpathパラメーター）を調べます。フォルダーには、シャードの番号に対応する名前が付いています。これらのフォルダーの1つに、シャードが未完了であることを示すcontrol.txtファイルが含まれていることがあります。

考えられるエラー

いずれかの[汎用エラータイプ][]。
notEnabled - サーバーでシャードストアーを使用するように設定されていません。
tooBusy - サーバーはすでに、ピアツーピアネットワークから、または以前のdownload_shard要求の結果として、シャードをダウンロード中です。
invalidParams - 要求で1つ以上の必須フィールドが省略されていたか、または指定されたフィールドのデータタイプが誤っています。

{% include '_snippets/rippled-api-links.md' %} {% include '_snippets/tx-type-links.md' %} {% include '_snippets/rippled_versions.md' %}

6.0 KiB Raw Blame History Unescape Escape

download_shard

要求フォーマット

応答フォーマット

考えられるエラー

6.0 KiB

Raw Blame History