# peer_reservations_list

[[ソース]](https://github.com/XRPLF/rippled/blob/4a1148eb2849513dd1e7ae080288fd47ab57a376/src/ripple/rpc/handlers/Reservations.cpp#L116)

メソッドは、[ピアリザベーション](/ja/docs/concepts/networks-and-servers/peer-protocol#%E5%9B%BA%E5%AE%9A%E3%83%94%E3%82%A2%E3%81%A8%E3%83%94%E3%82%A2%E3%83%AA%E3%82%B6%E3%83%99%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3)を一覧表示します。新規: rippled 1.4.0

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

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

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

WebSocket

```json
{
  "id": "peer_reservations_list_example_1",
  "command": ""
}
```

JSON-RPC

```json
{
    "method": ""
}
```

コマンドライン

```sh
#Syntax: 
rippled
```

このリクエストにはパラメーターは含まれません。

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

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

WebSocket

```json
{
  "id": "peer_reservations_list_example_1",
  "result": {
    "reservations": [
      {
        "description": "Ripple s1 server 'WOOL'",
        "node": "n9Jt8awsPzWLjBCNKVEEDQnw4bQEPjezfcQ4gttD1UzbLT1FoG99"
      },
      {
        "node": "n9MZRo92mzYjjsa5XcqnPC7GFYAnENo9VfJzKmpcS9EFZvw5fgwz"
      }
    ]
  },
  "status": "success",
  "type": "response"
}
```

JSON-RPC

```json
{
  "result" : {
    "reservations" : [
       {
          "description" : "Ripple s1 server 'WOOL'",
          "node" : "n9Jt8awsPzWLjBCNKVEEDQnw4bQEPjezfcQ4gttD1UzbLT1FoG99"
       },
       {
          "node" : "n9MZRo92mzYjjsa5XcqnPC7GFYAnENo9VfJzKmpcS9EFZvw5fgwz"
       }
    ],
    "status" : "success"
  }
}
```

コマンドライン

```json
Loading: "/etc/rippled.cfg"
2019-Dec-27 21:56:07.253260422 HTTPClient:NFO Connecting to 127.0.0.1:5005

{
  "result" : {
    "reservations" : [
       {
          "description" : "Ripple s1 server 'WOOL'",
          "node" : "n9Jt8awsPzWLjBCNKVEEDQnw4bQEPjezfcQ4gttD1UzbLT1FoG99"
       },
       {
          "node" : "n9MZRo92mzYjjsa5XcqnPC7GFYAnENo9VfJzKmpcS9EFZvw5fgwz"
       }
    ],
    "status" : "success"
  }
}
```

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

| `Field` | 型 | 説明 |
|  --- | --- | --- |
| `reservations` | 配列 | 既存の[ピアリザベーション](/ja/docs/concepts/networks-and-servers/peer-protocol#%E5%9B%BA%E5%AE%9A%E3%83%94%E3%82%A2%E3%81%A8%E3%83%94%E3%82%A2%E3%83%AA%E3%82%B6%E3%83%99%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3)のリスト。各メンバーはピアリザベーションオブジェクトです。詳細は以下のとおりです。 |


#### ピアリザベーションオブジェクト

`reservations`配列の各メンバーは、1つの[ピアリザベーション](/ja/docs/concepts/networks-and-servers/peer-protocol#%E5%9B%BA%E5%AE%9A%E3%83%94%E3%82%A2%E3%81%A8%E3%83%94%E3%82%A2%E3%83%AA%E3%82%B6%E3%83%99%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3)を表すJSONオブジェクトです。このオブジェクトのフィールドを次に示します。

| `Field` | 型 | 説明 |
|  --- | --- | --- |
| `node` | 文字列 | この予約の対象となるピアサーバの[ノード公開鍵][]（[base58][]）。 |
| `description` | 文字列 | *（省略される場合があります）* このピアリザベーションの説明（ある場合）。 |


### 考えられるエラー

- いずれかの[汎用エラータイプ](/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)。