# validator_list_sites

[[ソース]](https://github.com/XRPLF/rippled/blob/master/src/ripple/rpc/handlers/ValidatorListSites.cpp)

`validator_list_sites`コマンドは、バリデータリストを処理するサイトのステータス情報を返します。新規: rippled 0.80.1

*`validator_list_sites`リクエストは、権限のないユーザは実行できない[管理メソッド](/ja/docs/references/http-websocket-apis/admin-api-methods)です。*

### リクエストのフォーマット

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

WebSocket

```json
{
   "id": 1,
   "command": "validator_list_sites"
}
```

JSON-RPC

```json
{
   "method": "validator_list_sites",
   "params": [
       {}
   ]
}
```

コマンドライン

```sh
#Syntax: validator_list_sites
rippled validator_list_sites
```

リクエストにはパラメーターが含まれていません。

### レスポンスのフォーマット

処理が成功したレスポンスの例:

WebSocket

```json
{
   "id":5,
   "status":"success",
   "type":"response",
   "result": {
       "validator_sites": [
           {
               "last_refresh_status": "accepted",
               "last_refresh_time": "2017-Oct-13 21:26:37",
               "refresh_interval_min": 5,
               "uri": "http://127.0.0.1:51447/validators"
           }
       ]
   }
}
}
```

JSON-RPC

```json
200 OK

{
   "result": {
       "status": "success",
       "validator_sites": [
           {
               "last_refresh_status": "accepted",
               "last_refresh_time": "2017-Oct-13 21:26:37",
               "refresh_interval_min": 5,
               "uri": "http://127.0.0.1:51447/validators"
           }
       ]
   }
}
```

コマンドライン

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

{
   "result": {
       "status": "success",
       "validator_sites": [
           {
               "last_refresh_status": "accepted",
               "last_refresh_time": "2017-Oct-13 21:26:37",
               "refresh_interval_min": 5,
               "uri": "http://127.0.0.1:51447/validators"
           }
       ]
   }
}
```

レスポンスは[標準フォーマット](/ja/docs/references/http-websocket-apis/api-conventions/response-formatting)に従っており、正常に完了した場合は結果に次のフィールドが含まれています。

| `Field` | 型 | 説明 |
|  --- | --- | --- |
| `validator_sites` | 配列 | バリデータサイトオブジェクトからなる配列。 |


`validator_sites`フィールドの配列の各メンバーは、次のフィールドを有するオブジェクトです。

| `Field` | 型 | 説明 |
|  --- | --- | --- |
| `last_refresh_status` | 文字列 | 存在する場合は、サイトの最終更新の[`ListDisposition`](https://github.com/XRPLF/rippled/blob/master/src/ripple/app/misc/ValidatorList.h)です。存在しない場合は、サイトに対するクエリーがまだ成功していません。 |
| `last_refresh_time` | 文字列 | サイトの最終照会時刻を人間が読み取れる形式で表示します。存在しない場合は、サイトに対するクエリーがまだ成功していません。 |
| `refresh_interval_min` | 符号なし整数 | 更新試行間隔の分数。 |
| `uri` | 文字列 | サイトのURI。 |


### 考えられるエラー

* [汎用エラータイプ](/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)のすべて。