---
html: fetch_info.html
parent: status-and-debugging-methods.html
blurb: このサーバーが現在ネットワークからフェッチしているオブジェクトに関する情報を返します。
labels:
  - コアサーバー
---
# fetch_info
[[ソース]](https://github.com/ripple/rippled/blob/315a8b6b602798a4cff4d8e1911936011e12abdb/src/ripple/rpc/handlers/FetchInfo.cpp "Source")

`fetch_info`コマンドは、このサーバーが現在ネットワークからフェッチしているオブジェクトに関する情報と、その情報を所有しているピアの数を返します。これは現在の取得操作をリセットする場合にも使用できます。

_`fetch_info`メソッドは、権限のないユーザーは実行できない[管理メソッド](admin-rippled-methods.html)です。_

### 要求フォーマット
要求フォーマットの例:

<!-- MULTICODE_BLOCK_START -->

*WebSocket*

```json
{
   "id": 91,
   "command": "fetch_info",
   "clear": false
}
```

*JSON-RPC*

```json
{
   "method": "fetch_info",
   "params": [
       {
           "clear": false
       }
   ]
}
```

*コマンドライン*

```sh
#Syntax: fetch_info [clear]
rippled fetch_info
```

<!-- MULTICODE_BLOCK_END -->

要求には以下のパラメーターが含まれます。

| `Field` | 型    | 説明                                              |
|:--------|:--------|:---------------------------------------------------------|
| `clear` | ブール値 | `true`の場合、現在のフェッチ操作がリセットされます。それ以外の場合、進行中のフェッチ操作のステータスのみが取得されます。 |

### 応答フォーマット

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

<!-- MULTICODE_BLOCK_START -->

*JSON-RPC*

```json
{
  "result" : {
     "info" : {
        "348928" : {
           "hash" : "C26D432B06F84861BCACD7942EDC3FE0B2E1DEB966A9E516A0FD275A375C2010",
           "have_header" : true,
           "have_state" : false,
           "have_transactions" : true,
           "needed_state_hashes" : [
              "BF8DC6B1E10D1D3565BF0649075D22EBFD34F751AFCC0E53E81D74786BC88922",
              "34E37A71CB51A12C73A435250E6A6349F7884C7EEBA6B88FA31F0244E967E88F",
              "BFB7D3008A7D61FD6A0538D1C2E70CFB94CE8DC66606319C372F278A48629765",
              "41C0C61D701FB1EA586F0EF1FC7A91FEC476D979589DA60507F05C13F7C21975",
              "6DDE8840A2C3C7FF05E5FFEE4D06408694C16A8357338FE0C4581DC3D8A00BBA",
              "6C69D833B582C849917806FA009518832BB50E900E43716FD7CC1966428DD0CF",
              "1EDC020CFC4AF19B625C52E20B66D6AE672821CCC461E8A9C457A3B2955657F7",
              "FC0616A66A2B0589CA513F3341D4EA51E782C4601E5072308478E3CC19264640",
              "19FC607B5DE1B64681A676EC1ED5507B9555B0E098CD9D898320297DE1A64033",
              "5E128D3FC990074E35687387A14AA12D9FD287E5AB57CB9B2FD83DE635DF5CA9",
              "DE72820F3981770F2AA8770BC233B80661F1A452819D8529008875FF8DED87A9",
              "3ACB84BEE2C45556351FF60FD787D235C9CF5623FB8A35B01446B773598E7CC0",
              "0DD3A8DF69874148057F1F2BF305442FF2E89A76A08B4CC8C051E2ED69B874F3",
              "4AE9A9C4F12A5BD0355037DA40A0B145420A2168A9FEDE43E643BD13062F8ECE",
              "08CBF8CFFEC207F5AC4E4F24BC447011FD8C79D25B344281FBFB4732D7058ED4",
              "779B2577C5C4BAED6657421448EA506BBF50F86BE363E0924127C4EA17A58BBE"
           ],
           "peers" : 2,
           "timeouts" : 0
        }
     },
     "status" : "success"
  }
}
```

*コマンドライン*

```json
Loading: "/etc/rippled.cfg"
Connecting to 127.0.0.1:5005

{
  "result" : {
     "info" : {
        "348928" : {
           "hash" : "C26D432B06F84861BCACD7942EDC3FE0B2E1DEB966A9E516A0FD275A375C2010",
           "have_header" : true,
           "have_state" : false,
           "have_transactions" : true,
           "needed_state_hashes" : [
              "BF8DC6B1E10D1D3565BF0649075D22EBFD34F751AFCC0E53E81D74786BC88922",
              "34E37A71CB51A12C73A435250E6A6349F7884C7EEBA6B88FA31F0244E967E88F",
              "BFB7D3008A7D61FD6A0538D1C2E70CFB94CE8DC66606319C372F278A48629765",
              "41C0C61D701FB1EA586F0EF1FC7A91FEC476D979589DA60507F05C13F7C21975",
              "6DDE8840A2C3C7FF05E5FFEE4D06408694C16A8357338FE0C4581DC3D8A00BBA",
              "6C69D833B582C849917806FA009518832BB50E900E43716FD7CC1966428DD0CF",
              "1EDC020CFC4AF19B625C52E20B66D6AE672821CCC461E8A9C457A3B2955657F7",
              "FC0616A66A2B0589CA513F3341D4EA51E782C4601E5072308478E3CC19264640",
              "19FC607B5DE1B64681A676EC1ED5507B9555B0E098CD9D898320297DE1A64033",
              "5E128D3FC990074E35687387A14AA12D9FD287E5AB57CB9B2FD83DE635DF5CA9",
              "DE72820F3981770F2AA8770BC233B80661F1A452819D8529008875FF8DED87A9",
              "3ACB84BEE2C45556351FF60FD787D235C9CF5623FB8A35B01446B773598E7CC0",
              "0DD3A8DF69874148057F1F2BF305442FF2E89A76A08B4CC8C051E2ED69B874F3",
              "4AE9A9C4F12A5BD0355037DA40A0B145420A2168A9FEDE43E643BD13062F8ECE",
              "08CBF8CFFEC207F5AC4E4F24BC447011FD8C79D25B344281FBFB4732D7058ED4",
              "779B2577C5C4BAED6657421448EA506BBF50F86BE363E0924127C4EA17A58BBE"
           ],
           "peers" : 2,
           "timeouts" : 0
        }
     },
     "status" : "success"
  }
}
```

<!-- MULTICODE_BLOCK_END -->

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

| `Field` | 型   | 説明                                               |
|:--------|:-------|:----------------------------------------------------------|
| `info`  | オブジェクト | フェッチ対象のオブジェクトと、そのフェッチ対象オブジェクトのステータスのマップ。フェッチ対象のレジャーはその[レジャーインデックス]によって識別されます。フェッチ対象のレジャーとその他のオブジェクトがハッシュによって識別されることもあります。 |

進行中のフェッチ操作を記述するフィールドは、予告なく変更される可能性があります。以下のフィールドが含まれている可能性があります。

| `Field`               | 型                    | 説明                |
|:----------------------|:------------------------|:---------------------------|
| `hash`                | 文字列                  | フェッチ対象アイテムのハッシュ。 |
| `have_header`         | ブール値                 | レジャーの場合、このサーバーがすでにレジャーのヘッダーセクションを取得しているかどうか。 |
| `have_transactions`   | ブール値                 | レジャーの場合、このサーバーがすでにレジャーのトランザクションセクションを取得しているかどうか。 |
| `needed_state_hashes` | （ハッシュ）文字列の配列 | まだ必要とされる、このアイテムの状態オブジェクトのハッシュ値。必要なハッシュの数が16を超えている場合、応答には最初の16個のハッシュのみが含まれます。 |
| `peers`               | 数値                  | このアイテムが利用可能であるピアの数。 |
| `timeouts`            | 数値                  | このアイテムをフェッチしようとしてタイムアウトになった（2.5秒）回数。 |

### 考えられるエラー

* [汎用エラータイプ][]のすべて。

<!--{# common link defs #}-->
{% include '_snippets/rippled-api-links.md' %}
{% include '_snippets/tx-type-links.md' %}
{% include '_snippets/rippled_versions.md' %}
