# ip route

モード
  グローバルコンフィグモード
カテゴリー
  IP / 経路制御

## 構文

コマンド構文

`(config)# ip route DESTINATION {GATEWAY | null} [<1-255>] [description TEXTLINE]`

`(config)# no ip route DESTINATION {GATEWAY | null} [<1-255>]`

## コマンド説明

IP経路表にスタティック経路を追加する。
no形式で実行した場合は指定したスタティック経路を削除する。
Note

本製品がスタートアップコンフィグなしで起動した場合、IPv4のデフォルト経路（宛先 0.0.0.0/0）は、AT-VST-APLのGUI設定画面で指定したIPv4デフォルトゲートウェイアドレスにしたがって自動的に設定され、その内容が本コマンドとしてランニングコンフィグに反映されます。
ただし、AT-VST-APLのGUI設定画面で指定した内容が動作に反映されるのは、本製品がコンフィグなしで起動したときだけです。
起動時にコンフィグが存在する場合は、コンフィグファイルの記述にしたがって設定が復元されますので、AT-VST-APLのGUIで初期設定したデフォルトゲートウェイアドレスを後から変更するときは、本製品のCLIからip routeコマンドを実行してください。

## パラメーター

`DESTINATION`
  宛先ネットワークアドレス。次のいずれかの形式で指定する。なお、デフォルト経路を追加する場合は、宛先ネットワークアドレスとして0.0.0.0/0または0.0.0.0 0.0.0.0を指定する
  `A.B.C.D/M`
    IPアドレスとプレフィックス長で指定する形式
  `A.B.C.D W.X.Y.Z`
    IPアドレスとサブネットマスクで指定する形式
`GATEWAY := A.B.C.D`
  転送先（ネクストホップ）のIPアドレス。詳細は書式パターンを参照
`null`
  ブラックホール経路を登録する場合に指定する特殊なインターフェース名。nullを指定した場合、該当経路宛てのパケットは転送されずに破棄される。詳細は書式パターンを参照
`<1-255>`
  管理距離（経路選択時の優先度）。同じサブネット長のスタティック経路を複数登録する場合に、それらの間で優先順位を付けたい場合に本値を使用可能（フローティングスタティックルートの利用）。値が小さいほど優先度が高い。省略時はスタティック経路のデフォルト値である1となる
`description TEXTLINE`
  説明文。TEXTLINEは行末までがその値と見なされるため、スペースを含んでいてもよい

## 使用例

172.20.53.0/24へのスタティック経路を登録する。

    AT-AMF-app(config)# ip route 172.20.53.0/24 172.17.28.254

サブネットマスクを使って次のように指定しても同じ。

    AT-AMF-app(config)# ip route 172.20.53.0 255.255.255.0 172.17.28.254

デフォルト経路を172.17.28.32に向ける。

    AT-AMF-app(config)# ip route 0.0.0.0/0 172.17.28.32

10.0.0.0/8宛てのパケットを転送せずに破棄するよう設定する。

    AT-AMF-app(config)# ip route 10.0.0.0/8 null

## 注意・補足事項

管理距離255を持つ経路は「信頼できない経路」と見なされ、FIB（IP転送表）に登録されない（IPパケットの転送には使われない）。
経路追加時の書式には次のパターンがある。

- ネクストホップ（転送先）を指定する場合

  `ip route DESTINATION GATEWAY [<1-255>]`

- 該当宛先のパケットを転送せずに破棄する場合

  `ip route DESTINATION null [<1-255>]`

## コマンドツリー

## 関連コマンド