# ipv6 route

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

## 構文

コマンド構文

`(config)# ipv6 route [vrf VRFNAME] X:X::X:X/M {GATEWAY & IFNAME | null} [<1-255>] [description TEXTLINE]`

`(config)# no ipv6 route [vrf VRFNAME] X:X::X:X/M [{GATEWAY & IFNAME | null} [<1-255>]]`

## コマンド説明

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

## パラメーター

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

## 使用例

2001:db8:2::/48へのスタティック経路を登録する。

    awplus(config)# ipv6 route 2001:db8:2::/48 2001:db8:1:10::1

2001:db8:2::/48へのスタティック経路を登録する。ネクストホップをリンクローカルアドレスで指定するときは、送出インターフェースの指定が必須なので注意すること。

    awplus(config)# ipv6 route 2001:db8:2::/48 fe80::1 vlan10

デフォルト経路をvlan10上のfe80::2に向ける。

    awplus(config)# ipv6 route ::/0 fe80::2 vlan10

## 注意・補足事項

L2TPv3トンネルインターフェースを使用してルーティングを行う場合は、他のトンネルインターフェースと異なりネクストホップアドレスを明確にする必要がある。そのため、本コマンドでスタティック経路を登録するときは、L2TPv3トンネルインターフェースを送出インターフェースとして指定するのではなく、ネクストホップアドレスを明示的に指定すること。
経路追加時の書式には次のパターンがある。
Note

以下の説明において、「非ポイントツーポイントインターフェース」とは、次のインターフェースを指します（802.1Qサブインターフェースを含む）。

- VLANインターフェース
- Ethernetインターフェース
- ブリッジインターフェース
- L2TPv3トンネルインターフェース
- OpenVPN Tap(L2)トンネルインターフェース
- マルチポイントGREトンネルインターフェース

また、「ポイントツーポイントインターフェース」とは、次のインターフェースを指します。

- PPPoE/PPPインターフェース
- トンネルインターフェース（前記「非ポイントツーポイントインターフェース」に含まれるものを除く）

#### 非VRF環境

- ネクストホップ（転送先）が非ポイントツーポイントインターフェース上に存在する場合

  `ipv6 route X:X::X:X/M GATEWAY [<1-255>]`

  ネクストホップがリンクローカルアドレスの場合は出力インターフェース（IFNAME）も指定

  `ipv6 route X:X::X:X/M GATEWAY IFNAME [<1-255>]`

- ネクストホップ（転送先）がポイントツーポイントインターフェース（IFNAME）上に存在する場合

  `ipv6 route X:X::X:X/M IFNAME [<1-255>]`

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

  `ipv6 route X:X::X:X/M null [<1-255>]`

#### VRF環境

##### VRFインスタンス内経路

宛先（DESTINATION）が同一VRFインスタンス内にある場合は、vrfパラメーターを除き、非VRF環境と同じ。詳細はVRFの解説編を参照。

- ネクストホップ（転送先）が非ポイントツーポイントインターフェース上に存在する場合

  `ipv6 route [vrf VRFNAME] X:X::X:X/M GATEWAY [<1-255>]`

- ネクストホップ（転送先）がポイントツーポイントインターフェース（IFNAME）上に存在する場合

  `ipv6 route [vrf VRFNAME] X:X::X:X/M IFNAME [<1-255>]`

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

  `ipv6 route [vrf VRFNAME] X:X::X:X/M null [<1-255>]`

##### VRFインスタンス間経路

VRFインスタンスをまたぐスタティック経路、すなわち宛先（DESTINATION）が他のVRFインスタンスに存在する経路を登録する場合は、次のパターンがある。詳細はVRFの解説編を参照。

- 宛先ネットワークが自装置に直接接続されている場合（他のルーターを介さず、自装置内で転送が完了する場合）
  出力インターフェース（IFNAME）だけを指定。

  `ipv6 route [vrf VRFNAME] X:X::X:X/M IFNAME [<1-255>]`

- ネクストホップが他装置の場合（宛先ネットワークへのパケットを他のルーターに転送する必要がある場合）
  ネクストホップアドレス（GATEWAY）と出力インターフェース（IFNAME）の両方を指定。

  `ipv6 route [vrf VRFNAME] X:X::X:X/M GATEWAY IFNAME [<1-255>]`

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

  `ipv6 route [vrf VRFNAME] X:X::X:X/M null [<1-255>]`

## コマンドツリー

## 関連コマンド