# 23.1. ルートマップ

コマンド一覧

コマンド | コマンドの機能
--- | ---
match community | BGP の COMMUNITY属性条件
match interface | インタフェース条件
match ip address access-list | IPv4 アドレス条件(アクセスリスト)
match ip address prefix-list | IPv4 アドレス条件(プレフィックスリスト)
match ip next-hop prefix-list | IPv4 ネクストホップ条件
match ip url-offload | URL オフロードデータベース条件
match ipv6 address access-list | IPv6 アドレス条件(アクセスリスト)
match metric | メトリック条件
match tag | タグ条件
route-map | ルートマップ追加／設定
set as-path prepend | BGP の AS パス属性に AS(s) をプリペンド指定
set community | BGP の COMMUNITY 属性を指定
set default interface | デフォルトインタフェース指定
set interface | インタフェース指定
set ip default next-hop | IPv4 デフォルトネクストホップ指定
set ip next-hop | IPv4 ネクストホップ指定
set ipv6 default next-hop | IPv6 デフォルトネクストホップ指定
set ipv6 next-hop | IPv6 ネクストホップ指定
set local-preference | BGP のローカル・プリファレンス属性を指定
set metric | メトリック指定
set metric-type | メトリックタイプ指定
set origin | BGPのオリジン属性を指定
set tag | タグ指定
show route-map | ルートマップ状態表示
clear route-map | 統計情報のリセット

## 23.1.1. BGP の COMMUNITY属性条件

[入力形式]
  match community { COMMUNITY-NUMBER | no-advertise | no-export | no-export-subconfed } [ exact-match ]
  no match community
[パラメータ]

  COMMUNITY-NUMBER ．．．COMMUNITY値

  > - 範囲(32ビット整数)：0〜4294967295

  > - 範囲(16ビット整数)：0〜65535

  no-advertise ．．．Well-known Community NO_ADVERTISE (0xFFFFFF02)

  no-export ．．． Well-known Community NO_EXPORT (0xFFFFFF01)

  no-export-subconfed ．．．Well-known Community NO_EXPORT_SUBCONFED (0xFFFFFF03)

  exact-match ．．． COMMUNITY 属性完全一致

[説明]
  経路再配信の条件とするCOMMUNITY値を指定します(最大32件の指定が可能)。
  オプション exact-match を指定した場合はすべてのCOMMUNITY値の完全一致が条件となります。
[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  match community 65535:65535
  match community 0:0 65535:65535 exact-match
  no match community
[ノート]

  なし

## 23.1.2. インタフェース条件

[入力形式]
  match interface INTERFACE
  no match interface [ INTERFACE ]
[パラメータ]

  INTERFACE．．．出力先インタフェース

  > - インタフェース名

[説明]

  経路再配信の条件として出力先インタフェースを指定します。

[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  match interface GigaEthernet0.0
  no match interface
[ノート]

  なし

## 23.1.3. IPv4 アドレス条件(アクセスリスト)

[入力形式]
  match ip address access-list ACCESSLIST-NAME
  no match ip address access-list [ ACCESSLIST-NAME ]
[パラメータ]

  ACCESSLIST-NAME．．．IPv4 アクセスリスト名

  > - 15文字以内の文字列

[説明]
  受信パケットが指定されたアクセスリストに適合した場合にポリシールーティング対象パケットとなります。
[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  match ip address access-list pc100
  no match ip address access-list
[ノート]

  なし

## 23.1.4. IPv4 アドレス条件(プレフィックスリスト)

[入力形式]
  match ip address prefix-list PREFIXLIST-NAME
  no match ip address prefix-list [ PREFIXLIST-NAME ]

[パラメータ]

> PREFIXLIST-NAME．．． IPv4 プレフィックスリスト名

> > - 31文字以内の文字列

[説明]
  ルーティングテーブル上の経路情報がプレフィックスリストに適合した場合に再配信対象経路となります。
[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  match ip address prefix-list localnet
  no match ip address prefix-list
[ノート]

  なし

## 23.1.5. IPv4 ネクストホップ条件

[入力形式]
  match ip next-hop prefix-list PREFIXLIST-NAME
  no match ip next-hop prefix-list [ PREFIXLIST-NAME ]
[パラメータ]

  PREFIXLIST-NAME．．．IPv4 プレフィックスリスト名

  > - 31文字以内の文字列

[説明]

  ルーティングテーブル上の経路情報のネクストホップがプレフィックスリストに適合した場合に再配信対象経路となります。

[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  match ip next-hop prefix-list list2
  no match ip next-hop prefix-list
[ノート]

  なし

## 23.1.6. URL オフロードデータベース条件

[入力形式]
  match ip url-offload PROFILE-NAME [ { app APPLCATION-NAME | url-list { URLLIST-NAME | default } } ]
  no match ip url-offload [ PROFILE-NAME [ { app APPLCATION-NAME | url-list { URLLIST-NAME | default } } ] ]
[パラメータ]

  PROFILE-NAME．．．プロファイル名

  > - 31文字以内の文字列

  APPLCATION-NAME．．．アプリケーション名

  > - 128文字以内の文字列

  URLLIST-NAME．．．URLリスト名

  > - 31文字以内の文字列

[説明]
  受信パケットが指定されたURLオフロードデータベースに適合した場合、ポリシールーティング対象パケットとなります。
  アプリケーション名が指定された場合、受信パケットが指定されたプロファイルに対応するデータベースとAPLに適合した場合にポリシールーティング対象パケットとなります。
  URLリスト名が指定された場合、受信パケットが指定されたプロファイルに対応するURLリストに適合した場合にポリシールーティング対象パケットとなります。
  URLリスト名に default を指定した場合、受信パケットが以下のいずれかの条件に適合した場合にポリシールーティング対象パケットとなります。

  > - 指定されたプロファイルに対して、URLオフロードデータベースの指定コマンド (url) で指定された外部定義ファイルのデータベース内の定義に適合した場合

  > - プロキシコンフィグの設定コマンド (proxy-config) で指定されたPACファイルのURLに適合した場合

[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  match ip url-offload url-offload-1
  match ip url-offload url-offload-1 app Skype/Teams
  match ip url-offload url-offload-1 url-list my_list
  match ip url-offload url-offload-1 url-list default
[ノート]

  なし

## 23.1.7. IPv6 アドレス条件(アクセスリスト)

[入力形式]
  match ipv6 address access-list ACCESSLIST-NAME
  no match ipv6 address access-list [ ACCESSLIST-NAME ]
[パラメータ]

  ACCESSLIST-NAME．．． IPv6 アクセスリスト名

  > - 15文字以内の文字列

[説明]
  受信パケットが、指定されたアクセスリストに適合した場合にポリシールーティング対象パケットとなります。
[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  match ipv6 address access-list list2
  no match ipv6 address prefix-list
[ノート]

  なし

## 23.1.8. メトリック条件

[入力形式]
  match metric METRIC
  no match metric [ METRIC ]
[パラメータ]

  METRIC．．．条件とするメトリック値

  > - 範囲：0～4294967295

[説明]

  経路再配信の条件とするメトリック値を指定します。

  > - RIP 経路を再配信する場合は経路のコスト値と比較されます。

  > - スタティック経路を再配信する場合は経路のメトリック値と比較されます。

[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  match metric 5
  no match metric
[ノート]

  なし

## 23.1.9. タグ条件

[入力形式]
  match tag TAG
  no match tag [ TAG ]
[パラメータ]

  TAG．．．条件とするタグ値

  > - 範囲：0～4294967295

[説明]

  経路再配信の条件とするタグ値を指定します。

  > - RIP 経路を再配信する場合は経路のタグ値と比較されます。

  > - スタティック経路を再配信する場合は経路のタグ値と比較されます。

[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  match tag 200
  no match tag
[ノート]

  なし

## 23.1.10. ルートマップ追加／設定

[入力形式]
  route-map ROUTE-MAP-NAME [ permit | deny ] [ SEQUENCE ]
  no route-map ROUTE-MAP-NAME [ permit | deny ] [ SEQUENCE ]
[パラメータ]

  ROUTE-MAP-NAME．．．ルートマップ名

  > - 31文字以内の文字列

  permit．．． match条件に適合した場合にルートマップ適用対象とします。

  deny．．． match条件に適合した場合にルートマップ適用対象外とします。

  SEQUENCE．．．ルール適用順序、数値が小さい条件から比較します。

  > - 範囲：0〜65535

[説明]
  ルートマップは、ある情報（経路情報、パケット等）に対しmatchコマンドで設定された条件と比較し、条件に適合した場合にsetコマンドで設定された
  パラメータを適用する機能です。本コマンドを実行するとルートマップコンフィグモードへと移行し、setコマンド、matchコマンドが実行可能となります。
[デフォルト値]

  なし

[実行モード]

  グローバルコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  route-map map permit 10
  no route-map map permit 10
[ノート]

  なし

## 23.1.11. BGP の AS パス属性に AS(s) をプリペンド指定

[入力形式]
  set as-path prepend [ AS ]
  no set as-path prepend [ AS ]
[パラメータ]

  AS．．．AS番号

  > - 範囲： 1～65535

[説明]

  BGPのAS-PATH属性に任意のAS番号をプリペンドします。

[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  set as-path prepend 2000 2000 2000
  no set as-path prepend 2000 2000 2000
[ノート]

  なし

## 23.1.12. BGP の COMMUNITY 属性を指定

[入力形式]
  set community { COMMUNITY-NUMBER | no-advertise | no-export | no-export-subconfed } [ additive [ delete { COMMUNITY-NUMBER | no-advertise | no-export | no-export-subconfed } ]]
  set community delete { COMMUNITY-NUMBER | no-advertise | no-export | no-export-subconfed }
  set community none
[パラメータ]

  COMMUNITY-NUMBER ．．．COMMUNITY値

  > - 範囲(32ビット整数)： 0〜4294967295

  > - 範囲(16ビット整数)： 0〜65535

  no-advertise ．．．Well-known Community NO_ADVERTISE (0xFFFFFF02)

  no-export ．．．Well-known Community NO_EXPORT (0xFFFFFF01)

  no-export-subconfed ．．．Well-known Community NO_EXPORT_SUBCONFED (0xFFFFFF03)

  additive ．．．COMMUNITY値を追加

  delete ．．．COMMUNITY値を削除

  none ．．．COMMUNITY属性削除

[説明]
  BGPのCOMMUNITY属性に任意のCOMMUNITY値で上書きまたは、任意のCOMMUNITY値の追加削除を行います。
  オプション additive で指定されたCOMMUNITY値を追加、delete で指定したCOMMUNITY値を削除します。
  オプション none を指定した場合はCOMMUNITY属性そのものを削除します。
  これらのオプションを１つも指定しない場合は指定されたCOMMUNITY値で上書きします。
  COMMUNITY値は合計で最大32件までの指定が可能です。
[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  set community 65535:65535
  set community 0:0 65535:65535 additive
  no set community
[ノート]

  なし

## 23.1.13. デフォルトインタフェース指定

[入力形式]
  set default interface INTERFACE
  no set default interface [ INTERFACE ]
[パラメータ]

  INTERFACE．．．送信インタフェース

  > - インタフェース名

[説明]
  ポリシールーティングにおけるデフォルト送信インタフェースを指定します。
  これは、ルーティングテーブルに送信経路が存在しなかった場合に送信先とするインタフェースです。
[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  set default interface GigaEthernet0.0
  no set default interface
[ノート]

  なし

## 23.1.14. インタフェース指定

[入力形式]
  set interface INTERFACE
  no set interface [ INTERFACE ]
[パラメータ]

  INTERFACE．．．送信インタフェース

  > - インタフェース名

[説明]
  ポリシールーティングにおける送信インタフェースを指定します。
  ポリシールーティング関連のsetコマンドの優先順位は以下のとおりです。

  > - set interface

  > - set ip/ipv6 next-hop

  > - set default interface

  > - set ip/ipv6 default next-hop

  上から順に適用可能かどうか判断されます。
  interfaceについては対象インタフェースがリンクアップしていれば適用可能とし、
  next-hopについては対象アドレスへの経路が存在すれば適用可能とします。
  また後者２つについてはパケットの宛先アドレスへの経路がなかった場合に適用されます。
[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  set interface GigaEthernet0.0
  no set interface
[ノート]

  なし

## 23.1.15. IPv4 デフォルトネクストホップ指定

[入力形式]
  set ip default next-hop NEXTHOP
  no set ip default next-hop [ NEXTHOP ]
[パラメータ]

  NEXTHOP．．．ネクストホップアドレス

  > - IPv4アドレス

[説明]
  ポリシールーティングにおけるデフォルト送信先アドレスを指定します。
  これは、ルーティングテーブルに送信経路が存在しなかった場合に送信先とするネクストホップアドレスです。
[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  set ip default next-hop 192.168.1.254
  no set ip default next-hop 192.168.1.254
[ノート]

  なし

## 23.1.16. IPv4 ネクストホップ指定

[入力形式]
  set ip next-hop { NEXTHOP | self }
  no set ip next-hop
[パラメータ]

  NEXTHOP．．．ネクストホップアドレス

  > - IPv4アドレス

  self．．．自装置アドレス

[説明]
  ポリシールーティングにおける送信先アドレスを指定します。
  BGP経路フィルタ機能におけるNEXTHOP属性を指定します。
  パラメータ self は BGP経路フィルタ機能にのみ効果があります。
[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  set ip next-hop 192.168.1.254
  no set ip next-hop
[ノート]
  selfを設定すると、BGPの経路広告時に経路のネクストホップアドレスを自装置アドレスに書き換えます。
  その他の機能から参照した時の動作には影響しません。

## 23.1.17. IPv6 デフォルトネクストホップ指定

[入力形式]
  set ipv6 default next-hop NEXTHOP
  no set ipv6 default next-hop [ NEXTHOP ]
[パラメータ]

  NEXTHOP．．．ネクストホップアドレス

  > - IPv6アドレス

[説明]
  ポリシールーティングにおけるデフォルト送信先アドレスを指定します。
  これは、ルーティングテーブルに送信経路が存在しなかった場合に送信先とするネクストホップアドレスです。
[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  set ipv6 default next-hop 2001:db8::1
  no set ipv6 default next-hop
[ノート]

  なし

## 23.1.18. IPv6 ネクストホップ指定

[入力形式]
  set ipv6 next-hop NEXTHOP
  no set ipv6 next-hop [ NEXTHOP ]
[パラメータ]

  NEXTHOP．．．ネクストホップアドレス

  > - IPv6アドレス

[説明]

  ポリシールーティングにおける送信先アドレスを指定します。

[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  set ipv6 next-hop 2001:db8::1
  no set ipv6 next-hop
[ノート]

  なし

## 23.1.19. BGP のローカル・プリファレンス属性を指定

[入力形式]
  set local-preference LOCPREF
  no set local-preference [ LOCPREF ]
[パラメータ]

  LOCPREF．．．指定ローカル・プリファレンス値

  > - 範囲： 0～4294967295

[説明]

  BGPのローカル・プリファレンス属性を指定値に書き換えます。

[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  set local-preference 2000
  no set local-preference
[ノート]

  なし

## 23.1.20. メトリック指定

[入力形式]
  set metric METRIC
  no set metric [ METRIC ]
[パラメータ]

  METRIC．．．指定するメトリック値

  > - 範囲：0～4294967295

  > - +/-0～4294967295

[説明]

  経路再配信時のメトリック値を指定します。

  > - RIPの場合は経路のMED値を指定します。

  > - BGPの場合は経路のMED値を指定します。

[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  set metric 4
  no set metric
[ノート]

  なし

## 23.1.21. メトリックタイプ指定

[入力形式]
  set metric-type { type-1 | type-2 | internal }
  no set metric-type { type-1 | type-2 | internal }
[パラメータ]

  type-1．．．OSPF External Type-1 を指定します。

  type-2．．．OSPF External Type-2 を指定します。

  internal ．．．BGP へ再配信される時の MED 値に IGP メトリック値を指定します。

[説明]
  OSPF による経路再配信時のメトリックタイプを指定します。（type-1、type-2）
  BGP による経路再配信時の MED 値に IGP メトリック値を指定します。（internal）
[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  set metric-type type-1
  set metric-type internal
  no set metric-type type-2
  no set metric-type internal
[ノート]

  なし

## 23.1.22. BGPのオリジン属性を指定

[入力形式]
  set origin { igp | incomplete }
  no set origin { igp | incomplete }
[パラメータ]

  igp．．． オリジン属性をIGP指定します。

  incomplete ．．．オリジン属性を INCOMPLETE に指定します。

[説明]

  BGPのオリジン属性のタイプを指定します。

[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  set origin igp
  no set origin igp
[ノート]

  なし

## 23.1.23. タグ指定

[入力形式]
  set tag TAG
  no set tag [ TAG ]
[パラメータ]

  TAG．．．指定するタグ値

  > - 範囲：0～4294967295

[説明]

  経路再配信時のタグ値を指定します。

  > - RIPの場合は経路のタグ値を指定します。

[デフォルト値]

  なし

[実行モード]

  ルートマップコンフィグモード

[ユーザー権限]

  Administrator

[入力例]
  set tag 30
  no set tag
[ノート]

  なし

## 23.1.24. ルートマップ状態表示

[入力形式]

  show route-map [ ROUTE-MAP-NAME ]

[パラメータ]

  ROUTE-MAP-NAME．．．ルートマップ名

  > - 31文字以内の文字列

[説明]

  ルートマップの状態を表示します。

[デフォルト値]

  なし

[実行モード]
  グローバルコンフィグモード
  ルートマップコンフィグモード
[ユーザー権限]

  Administrator/Operator/Monitor

[入力例]

  show route-map

[ノート]
  グローバルコンフィグモードでルートマップ名の指定なしで実行された場合は、全ルートマップの情報を表示します。
  ルートマップコンフィグモードでルートマップ名の指定なしで実行された場合は、コンフィグ対象ルートマップの情報のみを表示します。

## 23.1.25. 統計情報のリセット

[入力形式]

  clear route-map [ ROUTE-MAP-NAME ]

[パラメータ]

  ROUTE-MAP-NAME．．．ルートマップ名

  > - 31文字以内の文字列

[説明]

  ルートマップの統計情報をリセットします。

[デフォルト値]

  なし

[実行モード]
  グローバルコンフィグモード
  ルートマップコンフィグモード
[ユーザー権限]

  Administrator

[入力例]

  clear route-map map

[ノート]
  グローバルコンフィグモードでルートマップ名の指定なしで実行された場合は、全ルートマップの統計情報をリセットします。
  ルートマップコンフィグモードでルートマップ名の指定なしで実行された場合は、コンフィグ対象ルートマップの統計情報のみをリセットします。

## 23.1.26. コマンド変更情報

### 23.1.26.1. Ver1.0 コマンド変更情報

> - 追加コマンド一覧

>   > match community
>   > match interface
>   > match ip address access-list
>   > match ip address prefix-list
>   > match ip next-hop prefix-list
>   > match metric
>   > match tag
>   > route-map
>   > set as-path prepend
>   > set community
>   > set default interface
>   > set interface
>   > set ip default next-hop
>   > set ip next-hop
>   > set local-preference
>   > set metric
>   > set metric-type
>   > set origin
>   > show route-map
>   > clear route-map

### 23.1.26.2. Ver1.1 コマンド変更情報

> - 追加コマンド一覧

>   > match ipv6 address access-list
>   > set ipv6 default next-hop
>   > set ipv6 next-hop

### 23.1.26.3. Ver1.2 コマンド変更情報

> - 追加コマンド一覧

>   > match ip url-offload

### 23.1.26.4. Ver1.3 コマンド変更情報

> - 追加コマンド一覧

>   > set tag

> - 変更コマンド一覧

>   > set metric-type