- Cisco Unified SIP Proxy ソフトウェアの 使用方法
- Cisco Unified SIP Proxy Release 8.5 の マニュアル ロードマップ
- Cisco Unified SIP Proxy モジュール EXEC コマンド
- Cisco Unified SIP Proxy EXEC コマンド
- Cisco Unified SIP Proxy コンフィギュレー ション コマンド
- Cisco Unified SIP Proxy SIP コマンド
- Cisco Unified SIP Proxy SIP サーバ コマンド
- Cisco Unified SIP Proxy RADIUS サーバ コマンド
- Cisco Unified SIP Proxy トリガー コマンド
- Cisco Unified SIP Proxy ルート コマンド
- Cisco Unified SIP Proxy ポリシー コマンド
- Cisco Unified SIP Proxy アカウンティング コマンド
- Cisco Unified SIP Proxy セキュリティ コマンド
- Cisco Unified SIP Proxy のモジュール コマンド
- 索引
Cisco Unified SIP Proxy Release 8.5 CLI コマンド リファレンス
偏向のない言語
この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
翻訳について
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
- Updated:
- 2017年5月28日
章のタイトル： Cisco Unified SIP Proxy ルート コマンド
Cisco Unified SIP Proxy ルート コマンド
–
key route-uri target-destination
route table file
ファイルからルート テーブルのルートをロードするには、Cisco Unified SIP Proxy コンフィギュレーション モードで route table ファイル コマンドを使用します。ファイルからロードしたルート テーブルとルートを削除するには、このコマンドの no 形式を使用します。
route table table_name file route-file
no route table table_name file route-file
構文の説明
ルート情報のロード元であるファイルを指定します。ファイル パスの先頭には pfs:/cusp/routes/ を指定する必要があります。 |
コマンド デフォルト
コマンド モード
Cisco Unified SIP Proxy コンフィギュレーション（cusp-config）
コマンド履歴
|
|
|
|---|---|
| • • |
使用上のガイドライン
– Cisco Unified SIP Proxy Release 1.1.x では、ルート テーブルは、このコマンドを使用してファイルからロードされるルート、または route table サブモード コマンドを使用して設定されるルートで構成されます。ただし、ルート テーブルでは、ファイルからロードされるルートと、システム上で設定されるルートは混在できません。
– Cisco Unified SIP Proxy Release 8.5 では、このコマンドを使用すると、ルート サブモードが開始されます。したがって、ファイルからルートをロードした後、ルート テーブルにさらに変更を加えることができます。ファイルからロードされたルートと、システム上に設定されているルートの両方で構成されるルート テーブルを使用できます。
– Cisco Unified SIP Proxy Release 1.1.x では、アップロードしたファイルはその場所に残す必要がありました。ファイルを残さないと、リブート時にシステムからルート設定が失われるためです。
– Cisco Unified SIP Proxy Release 8.5 では、アップロード後にファイルをその位置に残す必要はありません。
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。
例
次の例では、ファイル routes.txt のルートをルート テーブル t1 にロードする方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
route-URI をルーティング テーブルの検索キーに割り当て、宛先を発信 SIP 要求に指定された値に置き換えます。 |
|
route table
ルート テーブルを作成し、ルート テーブル コンフィギュレーション モードを開始するには、Cisco Unified SIP Proxy コンフィギュレーション モードで route table コマンドを使用します。ルート テーブルを削除するには、このコマンドの no 形式を使用します。
構文の説明
コマンド デフォルト
コマンド モード
Cisco Unified SIP Proxy コンフィギュレーション（cusp-config）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
このコマンドを入力してから、ルート テーブル コンフィギュレーション モードを開始します。ルート テーブルに追加するルートを設定するには、このコンフィギュレーション モードでコマンドを使用します。 key group 、 key target-destination 、 key response 、および key route-uri target-destination コマンドを使用して指定したルート テーブルのキーに基づいて、検索は実行されます。空白スペースを含むキーは、引用符を使用して指定する必要があります。
ルート テーブルは、このコマンドを使用してアクセスされるサブモード コマンドを使用して設定されるルート、または route table file コマンドを使用してファイルからロードされるルートで構成されます。ただし、ルート テーブルでは、システム上で設定されるルートと、ファイルからロードされるルートは混在できません。
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。
例
次の例では、ルート テーブル t1 を設定する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
route-URI をルーティング テーブルの検索キーに割り当て、宛先を発信 SIP 要求に指定された値に置き換えます。 |
|
key default-sip
RFC 3263 を使用して単純にルーティングされるようにルート テーブルのメッセージを設定するには、ルート コンフィギュレーション モードで key default-sip コマンドを使用します。ルート テーブルからキーを削除するには、このコマンドの no 形式を使用します。
構文の説明
（ sip network コマンドを使用して以前に設定された）このルートに関連付けられている SIP ネットワークの名前を指定します。 |
コマンド デフォルト
コマンド モード
ルート テーブル コンフィギュレーション（cusp-config-rt）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
検索キーは、一致している SIP メッセージの一部を表します。また、ルーティング テーブルに対して一意である必要があります。
例
次の例では、RFC 3263 を使用してルーティングされるようにルート テーブルのメッセージを設定する方法を示します。
次の例では、ルート テーブルから検索キーを削除する方法を示します。
関連コマンド
|
|
|
|---|---|
route-URI をルーティング テーブルの検索キーに割り当て、宛先を発信 SIP 要求に指定された値に置き換えます。 |
|
key group
ルート グループをルーティング テーブルに割り当て、それを検索キーの番号に関連付けるには、ルート テーブル コンフィギュレーション モードで key group コマンドを使用します。ルーティング テーブルの検索キーからルート グループの割り当てを削除するには、このコマンドの no 形式を使用します。
key key group route-group name
構文の説明
ルート テーブルの検索キーを指定します。検索キーは、一致している SIP メッセージの一部を表します。また、ルーティング テーブルに対して一意である必要があります。 |
|
コマンド デフォルト
コマンド モード
ルート テーブル コンフィギュレーション（cusp-config-rt）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
ルート グループと Request-URI を（ key target-destination コマンドを使用して）同じキー番号に割り当てることはできません。
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。
例
次の例では、以前に設定したルート グループをルーティング テーブルに割り当て、それにキー番号を割り当てる方法を示します。
次の例では、ルート テーブルから検索キーを削除する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
route-URI をルーティング テーブルの検索キーに割り当て、宛先を発信 SIP 要求に指定された値に置き換えます。 |
|
key policy
検索ポリシーをルーティング テーブルのキーに割り当てるには、ルート テーブル コンフィギュレーション モードで key policy コマンドを使用します。ルーティング テーブルのキーからルート ポリシーの割り当てを削除するには、このコマンドの no 形式を使用します。
no key key policy route-policy
構文の説明
ルート テーブルの検索キー番号を指定します。検索キーは、一致している SIP メッセージの一部を表します。また、ルーティング テーブルに対して一意である必要があります。 |
|
ルーティング テーブルで使用するルート検索ポリシー（ policy lookup コマンドで設定したポリシー）を指定します。 |
コマンド デフォルト
コマンド モード
ルート テーブル コンフィギュレーション（cusp-config-rt）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
指定したネクストホップのタプルが、ルート アドバンス処理によって使い尽くされた場合にルーティングする先の定義済みのルーティング ポリシーをこのコマンドを使用して設定します。このコマンドは、まず policy lookup コマンドを使用してポリシーを設定する必要があります。
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。
例
次の例では、以前に設定した検索ポリシーをルーティング テーブルに割り当て、それにキー番号を割り当てる方法を示します。
次の例では、ルート テーブルから検索キーを削除する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
route-URI をルーティング テーブルの検索キーに割り当て、宛先を発信 SIP 要求に指定された値に置き換えます。 |
|
key response
応答コードをルーティング テーブルの検索キーに割り当てるには、ルート テーブル コンフィギュレーション モードで key response コマンドを使用します。ルーティング テーブルの検索キーから応答コードの割り当てを削除するには、このコマンドの no 形式を使用します。
key key response response-code
no key key [response response-code]
構文の説明
ルート テーブルの検索キー番号を指定します。検索キーは、一致している SIP メッセージの一部を表します。また、ルーティング テーブルに対して一意である必要があります。 |
|
コマンド デフォルト
コマンド モード
ルート テーブル コンフィギュレーション（cusp-config-rt）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
このコマンドは、まず failover-resp-code コマンドを設定する必要があります。
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。
例
次の例では、応答コードをルーティング テーブルに割り当て、それにキー番号を割り当てる方法を示します。
次の例では、ルート テーブルから検索キーを削除する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
route-URI をルーティング テーブルの検索キーに割り当て、宛先を発信 SIP 要求に指定された値に置き換えます。 |
|
key route-uri target-destination
route-URI をルーティング テーブルの検索キーに割り当て、宛先を発信 SIP 要求に指定された値に置き換えるには、Cisco Unified SIP Proxy ルート テーブル コンフィギュレーション モードで key route-uri target-destination コマンドを使用します。ルーティング テーブルの検索キーから route-URI の割り当てを削除するには、このコマンドの no 形式を使用します。
key key route-uri route-uri target-destination target-destination network
no key key [ route-uri route-uri target-destination target-destination network ]
構文の説明
ルート テーブルの検索キー番号を指定します。検索キーは、一致している SIP メッセージの一部を表します。また、ルーティング テーブルに対して一意である必要があります。 |
|
request-URI のホストとポート、およびトランスポートを指定します。このフィールドの形式は host:port:transport です。port と transport は省略可能です。 |
|
コマンド デフォルト
コマンド モード
Cisco Unified SIP Proxy ルート テーブル コンフィギュレーション（cusp-config-rt）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
route-URI は、まず element route-uri コマンドを使用して設定する必要があります。
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。
例
次の例では、route-URI をルーティング テーブルに割り当て、それにキー番号を割り当てる方法を示します。
次の例では、ルート テーブルから検索キーを削除する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
route-URI ヘッダーを追加し、それをルート グループの request-URI ヘッダーに置き換え、要素コンフィギュレーション モードを開始します。 |
|
key target-destination
宛先を発信 SIP 要求に指定された値に置き換えるには、ルート テーブル コンフィギュレーション モードで key target-destination コマンドを使用します。ルーティング テーブルのキーから request-URI を削除するには、このコマンドの no 形式を使用します。
key key target-destination target-destination network
no key key [ target-destination request-uri-host-port network]
構文の説明
コマンド デフォルト
コマンド モード
ルート テーブル コンフィギュレーション（cusp-config-rt）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
request-URI はまず element target-destination コマンドを使用して設定する必要があります。
request-URI と（ key group コマンドを使用する）ルート グループは、同じキー番号を使用できません。
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。
例
次の例では、宛先をルーティング テーブルに割り当て、それにキー番号を割り当てる方法を示します。
次の例では、ルート テーブルから検索キーを削除する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
route-URI をルーティング テーブルの検索キーに割り当て、宛先を発信 SIP 要求に指定された値に置き換えます。 |
|
route group
ルート グループを作成し、ルート グループ コンフィギュレーション モードを開始するには、Cisco Unified SIP Proxy コンフィギュレーション モードで route group コマンドを使用します。ルート グループを削除するには、このコマンドの no 形式を使用します。
route group route-group-name [ time-policy ] [ weight ]
no route group route-group-name
構文の説明
コマンド デフォルト
コマンド モード
Cisco Unified SIP Proxy コンフィギュレーション（cusp-config）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
このコマンドはルート グループとそのルート グループ要素を設定します。ルート グループは、1 つまたは複数のルート グループ要素、またはネクストホップのタプル設定のセットです。ルート グループを使用すると、ネクストホップのデータ タプルの特定のセットを、複数のルート設定で再利用できます。
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。
例
次の例では、ルート グループ g1 を作成し、ルート グループ コンフィギュレーション モードを開始する方法を示します。
次の例では、重み付けに基づくルーティングを使用してルート グループを作成する方法を示します。
次の例では、時間に基づくルーティングと重み付けに基づくルーティングを使用してルート グループを作成する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
element route-uri
route-URI ヘッダーを追加し、それをルート グループの request-URI ヘッダーに置き換える場合、および要素コンフィギュレーション モードを開始する場合、Cisco Unified SIP Proxy ルート グループ コンフィギュレーション モードで element-route-uri コマンドを使用します。ルート グループからルート エントリを削除するには、このコマンドの no 形式を使用します。
element route-uri route-uri network [q_value]
no element route-uri route-uri network
構文の説明
（オプション）サーバ グループ内の他のサーバ グループ要素に対するサーバ グループ要素のプライオリティを指定する実際の数値を表します。有効な値は 0.0 ～ 1.0 です。デフォルトは 1.0 です。 |
コマンド デフォルト
コマンド モード
Cisco Unified SIP Proxy ルート グループ コンフィギュレーション（cusp-config-rg）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
特定のネットワークに複数の route-URI を割り当てることができます。
weight オプションの場合、サーバ グループの各要素に重み付けが割り当てられます。それによって、サーバ グループ内で同じプライオリティ（q-value）を持つ他の要素の重み付けに対して、重み付けに比例するトラフィックの負荷を各要素が受信します。
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。
例
次の例では、route-URI 要素をルート グループに追加する方法を示します。
次の例では、ルート グループから route-URI 要素を削除する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
重み付けに基づくルーティングを実装する場合にルート グループの request-URI または route-URI に割り当てる割合を設定します。 |
element route-uri target-destination
route-URI 要素をルート グループに追加し、要素コンフィギュレーション モードを開始するには、Cisco Unified SIP Proxy ルート グループ コンフィギュレーション モードで element-route-uri コマンドを使用します。ルート グループからルート エントリを削除するには、このコマンドの no 形式を使用します。
element route-uri route-uri request-uri-host-port request-uri-host-port network [q_value]
no element route-uri route-uri network
構文の説明
要求の Request-URI-host-port を指定します。このフィールドの形式は、host:port です。port は省略可能です。 |
|
（オプション）サーバ グループ内の他のサーバ グループ要素に対するサーバ グループ要素のプライオリティを指定する実際の数値を表します。有効な値は 0.0 ～ 1.0 です。デフォルトは 1.0 です。 |
コマンド デフォルト
コマンド モード
Cisco Unified SIP Proxy ルート グループ コンフィギュレーション（cusp-config-rg）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
特定のネットワークに複数の route-URI を割り当てることができます。
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。
例
次の例では、route-URI 要素をルート グループに追加する方法を示します。
次の例では、ルート グループから route-URI 要素を削除する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
重み付けに基づくルーティングを実装する場合にルート グループの request-URI または route-URI に割り当てる割合を設定します。 |
element target-destination
宛先要素をルート グループに追加し、要素コンフィギュレーション モードを開始するには、ルート グループ コンフィギュレーション モードで element target-destination コマンドを使用します。ルート グループからルート エントリを削除するには、このコマンドの no 形式を使用します。
element target-destination target-destination network [ q_value]
no element target-destination target-destination
構文の説明
要求の宛先に基づいて、ネクストホップのタプルを指定します。このフィールドの形式は、host:port です。port は省略可能です。 |
|
（オプション）サーバ グループ内の他のサーバ グループ要素に対するサーバ グループ要素のプライオリティを指定する実際の数値を表します。有効な値は 0.0 ～ 1.0 です。デフォルトは 1.0 です。 |
コマンド デフォルト
コマンド モード
Cisco Unified SIP Proxy ルート グループ コンフィギュレーション（cusp-config-rg）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。
例
次の例では、宛先要素をルート グループに追加する方法を示します。
次の例では、ルート グループから宛先要素を削除する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
重み付けに基づくルーティングを実装する場合にルート グループの request-URI または route-URI に割り当てる割合を設定します。 |
failover-codes
要素の request-URI または要素の route-URI のフェールオーバー コードを設定するには、要素の request-URI コンフィギュレーション モードまたは要素の route-URI コンフィギュレーション モードで failover-codes コマンドを使用します。フェールオーバー コードを削除するには、このコマンドの no 形式を使用します。
failover-codes codes [ - code ] [ , continue ]
構文の説明
SIP 応答コードをカンマ区切りで指定します。複数の範囲を示すために使用するカンマとダッシュの前後には、単一の空白スペースを入力する必要があります。 |
コマンド デフォルト
コマンド モード
要素コンフィギュレーション（cusp-config-rg-element）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
例
次の例では、ルート グループの route-URI 要素に応答コードを追加する方法を示します。
次の例では、ルート グループの route-URI 要素に応答コードを追加する方法を示します。
次の例では、route-URI 要素からフェールオーバー コードを削除する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
time-policy（要素）
要素の request-URI または要素の route-URI の時間ポリシーを設定するには、要素の request-URI コンフィギュレーション モードまたは要素の route-URI コンフィギュレーション モードで time-policy コマンドを使用します。時間ポリシーを削除するには、このコマンドの no 形式を使用します。
構文の説明
時間に基づくルーティングを実装する場合、 policy time コマンドを使用して以前に設定した時間ポリシーを指定します。このオプションが有効なのは、 time-policy オプションが route group コマンドで指定されている場合だけです。 |
コマンド デフォルト
コマンド モード
要素コンフィギュレーション（cusp-config-rg-element）
コマンド履歴
|
|
|
|---|---|
例
次の例では、route-URI 要素の時間ポリシーを設定する方法を示します。
次の例では、route-URI 要素から時間ポリシーを削除する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
weight
重み付けに基づくルーティングを実装する場合に request-URI または route-URI に割り当てる重み付けの割合を設定するには、要素コンフィギュレーション モードで weight コマンドを使用します。重み付けを削除するには、このコマンドの no 形式を使用します。
構文の説明
重み付けに基づくルーティングを実装する場合にルート グループの request-URI または route-URI に割り当てる割合を設定します。有効な範囲は 0 ～ 100 です。設定しない場合、デフォルトの重み付けは 50 です。このオプションが有効なのは、 weight オプションが route group コマンドで指定されている場合だけです。 |
コマンド デフォルト
コマンド モード
要素コンフィギュレーション（cusp-config-rg-element）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
例
次の例では、重み付けに基づくルーティングの 50% の重み付けがある route-URI 要素を設定する方法を示します。
次の例では、route-URI 要素から重み付け値を削除する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
フィードバック