# ledger_request [[ソース]](https://github.com/XRPLF/rippled/blob/e980e69eca9ea843d200773eb1f43abe3848f1a0/src/ripple/rpc/handlers/LedgerRequest.cpp) `ledger_request`コマンドは、サーバに対し接続しているピアから特定のレジャーバージョンを取得するように指示します。これは、サーバが直接接続しているピアの1つにそのレジャーが存在している場合にのみ機能します。場合によっては、レジャーを完全に取得するにはこのコマンドを繰り返し実行する必要があります。 *`ledger_request`リクエストは、権限のないユーザは実行できない[管理メソッド](/ja/docs/references/http-websocket-apis/admin-api-methods)です。* ### リクエストのフォーマット リクエストのフォーマットの例: WebSocket ```json { "id": 102, "command": "ledger_request", "ledger_index": 13800000 } ``` コマンドライン ``` rippled ledger_request 13800000 ``` リクエストには以下のパラメーターが含まれます。 | `Field` | 型 | 説明 | | --- | --- | --- | | `ledger_index` | 数値 | *（省略可）*[レジャーインデックス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%82%A4%E3%83%B3%E3%83%87%E3%83%83%E3%82%AF%E3%82%B9)により指定されたレジャーを取得します。 | | `ledger_hash` | 文字列 | *（省略可）* 識別用[ハッシュ](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%8F%E3%83%83%E3%82%B7%E3%83%A5)により指定されたレジャーを取得します。 | `ledger_index`または`ledger_hash`のいずれかを指定する必要がありますが、両方は指定しないでください。 ### レスポンスのフォーマット レスポンスは[標準フォーマット](/ja/docs/references/http-websocket-apis/api-conventions/response-formatting)に従っています。ただし、*`rippled`サーバに対してレジャーの取得開始を正常に指示できた場合でも*、指定されたレジャーがない場合には失敗を示すレスポンスがリクエストから返されます。 レジャーを取得するには、rippledサーバのダイレクトピアの履歴にそのレジャーが含まれている必要があります。どのピアにもリクエストされたレジャーがない場合は、[connectメソッド](/ja/docs/references/http-websocket-apis/admin-api-methods/peer-management-methods/connect)または構成ファイルの`fixed_ips`セクションを使用して、`s2.ripple.com`にあるRippleのすべての履歴が記録されるサーバを追加すれば、`ledger_request`リクエストを再度実行できます。 失敗した場合のレスポンスには、レジャーの取得状況が示されます。成功した場合のレスポンスには、[ledgerメソッド](/ja/docs/references/http-websocket-apis/public-api-methods/ledger-methods/ledger)に類似したフォーマットでレジャーの情報が含まれます。 コマンドライン（失敗） ```json Loading: "/etc/rippled.cfg" Connecting to 127.0.0.1:5005 { "result" : { "acquiring" : { "hash" : "01DDD89B6605E20338B8EEB8EB2B0E0DD2F685A2B164F3790C4D634B5734CC26", "have_header" : false, "peers" : 2, "timeouts" : 0 }, "error" : "lgrNotFound", "error_code" : 20, "error_message" : "acquiring ledger containing requested index", "request" : { "command" : "ledger_request", "ledger_index" : 18851277 }, "status" : "error" } } ``` コマンドライン（進行中） ```json Loading: "/etc/rippled.cfg" Connecting to 127.0.0.1:5005 { "result" : { "hash" : "EB68B5B4F6F06BF59B6D7532BCB98BB98E2F10C2435D895217AA0AA7E910FBD5", "have_header" : true, "have_state" : false, "have_transactions" : false, "needed_state_hashes" : [ "C46F7B9E795135447AF24BAF999AB8FC1612A997F6EAAF8B784C226FF0BD8E25", "E48F528E4FC2A1DC492C6264B27B420E2285B2A3ECF3A253DB480DA5BFB7F858", "B62CD0B2E1277F78BC279FA037F3F747587299B60D23A551C3F63DD137DC0CF8", "30014C55701FB8426E496A47B297BEC9E8F5BFA47763CC22DBD9024CC81D39DD", "7EB59A853913898FCEA7B701637F33B1054BD36C32A0B910B612EFB9CDFF6334", "07ECAD3066D62583883979A2FADAADC8F7D89FA07375843C8A47452639AB2421", "97A87E5246AF78463485CB27E08D561E22AAF33D5E2F08FE2FACAE0D05CB5478", "50A0525E238629B32324C9F59B4ECBEFE3C21DC726DB9AB3B6758BD1838DFF68", "8C541B1ED47C9282E2A28F0B7F3DDFADF06644CAB71B15A3E67D04C5FAFE9BF4", "2C6CC536C778D8C0F601E35DA7DD9888C288897E4F603E76357CE2F47E8A7A9F", "309E78DEC67D5725476A59E114850556CC693FB6D92092997ADE97E3EFF473CC", "8EFF61B6A636AF6B4314CAC0C08F4FED0759E1F782178A822EDE98275E5E4B10", "9535645E5D249AC0B6126005B79BB981CBA00286E00154D20A3BCF65743EA3CA", "69F5D6FCB41D1E6CEA5ADD42CBD194086B45E957D497DF7AEE62ADAD485660CE", "07E93A95DBB0B8A00925DE0DF6D27E41CACC77EF75055A89815006109D82EAD3", "7FDF25F660235DCAD649676E3E6729DF920A9B0B4B6A3B090A3C64D7BDE2FB20" ], "needed_transaction_hashes" : [ "BA914854F2F5EDFCBD6E3E0B168E5D4CD0FC92927BEE408C6BD38D4F52505A34", "AE3A2DB537B01EB33BB3A677242DE52C9AE0A64BD9222EE55E52855276E7EA2A", "E145F737B255D93769673CBA6DEBA4F6AC7387A309DAACC72EA5B07ECF03C215", "073A118552AA60E1D3C6BE6F65E4AFA01C582D9C41CCC2887244C19D9BFA7741", "562DB8580CD3FE19AF5CEA61C2858C10091151B924DBF2AEB7CBB8722E683204", "437C0D1C2391057079E9539CF028823D29E6437A965284F6E54CEBF1D25C5D56", "1F069486AF5533883609E5C8DB907E97273D9A782DF26F5E5811F1C42ED63A3D", "CAA6B7DA68EBA71254C218C81A9EA029A179694BDD0D75A49FB03A7D57BCEE49" ], "peers" : 6, "status" : "success", "timeouts" : 1 } } ``` コマンドライン（成功） ```json Loading: "/etc/rippled.cfg" Connecting to 127.0.0.1:5005 { "result" : { "ledger" : { "accepted" : true, "account_hash" : "84EBB27D9510AD5B9A3A328201921B3FD418D4A349E85D3DC69E33C7B506407F", "close_time" : 486691300, "close_time_human" : "2015-Jun-04 00:01:40", "close_time_resolution" : 10, "closed" : true, "hash" : "DCF5D723ECEE1EF56D2B0024CD9BDFF2D8E3DC211BD2B9460165922564ACD863", "ledger_hash" : "DCF5D723ECEE1EF56D2B0024CD9BDFF2D8E3DC211BD2B9460165922564ACD863", "ledger_index" : "13840000", "parent_hash" : "8A3F6FBC62C11DE4538D969F9C7966234635FE6CEB1133DDC37220978F8100A9", "seqNum" : "13840000", "totalCoins" : "99999022883526403", "total_coins" : "99999022883526403", "transaction_hash" : "3D759EF3AF1AE2F78716A8CCB2460C3030F82687E54206E883703372B9E1770C" }, "ledger_index" : 13840000, "status" : "success" } } ``` 3つのレスポンスのフォーマットは次のとおりです。 1. `lgrNotFound`エラーが返された場合、レスポンスの`acquiring`フィールドには、ピアツーピアネットワークからのレジャー取得状況を示す[レジャーリクエストオブジェクト](#%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%82%AA%E3%83%96%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88)が指定されています。 2. サーバが現在データを取得中であるとレスポンスに示される場合、その結果の本文として、ピアツーピアネットワークからのレジャー取得状況を示す[レジャーリクエストオブジェクト](#%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%82%AA%E3%83%96%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88)が表示されます。 3. レジャーが完全に利用可能な場合、レスポンスには[レジャーヘッダー](/ja/docs/references/protocol/ledger-data/ledger-header)が表示されます。 ### レジャーリクエストオブジェクト サーバでレジャーの取得操作が進行中であり、まだ完了していない場合は、`rippled`サーバはレジャー取得状況を示すレジャーリクエストオブジェクトを返します。このオブジェクトのフィールドを次に示します。 | `Field` | 型 | 説明 | | --- | --- | --- | | `hash` | 文字列 | （省略される場合があります）リクエストされるレジャーの[ハッシュ](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%8F%E3%83%83%E3%82%B7%E3%83%A5)（サーバがこのハッシュを認識している場合）。 | | `have_header` | ブール値 | リクエストされたレジャーのヘッダーセクションがサーバにあるかどうか。 | | `have_state` | ブール値 | （省略される場合があります）リクエストされたレジャーの完全な状態データがサーバにあるかどうか。 | | `have_transactions` | ブール値 | （省略される場合があります）リクエストされたレジャーの完全なトランザクションセットがサーバにあるかどうか。 | | `needed_state_hashes` | 文字列の配列 | （省略される場合があります）サーバが取得する必要がある完全な状態データ内のオブジェクトのハッシュ（最大16個）。 | | `needed_transaction_hashes` | 文字列の配列 | （省略される場合があります）サーバが取得する必要があるトランザクションセットのオブジェクトのハッシュ（最大16個）。 | | `peers` | 数値 | このレジャーを見つけるためにサーバが照会するピアの数。 | | `timeouts` | 数値 | これまでにこのレジャーの取得操作がタイムアウトした回数。 | ### 考えられるエラー * [汎用エラータイプ](/ja/docs/references/http-websocket-apis/api-conventions/error-formatting#%E6%B1%8E%E7%94%A8%E3%82%A8%E3%83%A9%E3%83%BC)のすべて。 * `invalidParams` - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。このエラーは、指定したレジャーインデックスが現在進行中のレジャーのインデックス以上である場合にも発生します。 * `lgrNotFound` - レジャーがまだ利用可能ではない場合。これは、サーバがレジャーの取得を開始していますが、リクエストされたレジャーが接続されたどのピアにもない場合には失敗する可能性があることを意味します。（以前はこのエラーにはコード`ledgerNotFound`が使用されていました。）[更新: rippled 0.30.1][新規: rippled 0.30.1]