Cisco Unified SIP Proxy Release 8.5 CLI コマンド リファレンス

Cisco Unified SIP Proxy トリガー コマンド

---

• trigger condition

• trigger post-normalization

• trigger pre-normalization

• trigger routing

• sequence（トリガー）

– header（トリガー シーケンス）

– in-network

– local-ip

– local-port

– message

– method（トリガー シーケンス）

– mid-dialog

– out-network

– protocol

– proxy-route header-param

– proxy-route uri-component

– proxy-route uri-param

– remote-ip

– remote-port

– request-uri uri-component

– request-uri uri-param

– response-code

– time

– user-agent-hdr

trigger condition

トリガー条件を作成し、Cisco Unified SIP Proxy トリガー コンフィギュレーション モードを開始するには、Cisco Unified SIP Proxy コンフィギュレーション モードで trigger condition コマンドを使用します。トリガー条件を削除するには、このコマンドの no 形式を使用します。

trigger condition trigger-condition-name

no trigger condition trigger-condition-name

 

コマンド モード

Cisco Unified SIP Proxy コンフィギュレーション（cusp-config）

 

使用上のガイドライン

このコマンドはトリガー条件を設定します。トリガー条件は、トリガーと特定の条件（SIP メッセージ内の特定のヘッダーまたはフィールドに対する一致ルールを含む）を関連付けます。

トリガーは、それぞれの受信された要求に対して真偽を評価される名前付き条件です。条件が真である場合、プリセットされた動作が起動されます。

モジュールを実行するには、サーバで次のことを行う必要があります。

1. 適切なトリガーを特定します。

2. シーケンス番号によってトリガーの順序を決定します。

3. 要求に対して名前付きトリガー条件を評価します。条件が真である場合、次の手順が実行されます。真でない場合は、次のトリガーが確認されます。

4. 一致したトリガー条件に対応する、モジュール トリガーのパラメータからモジュール実行の詳細を判断します。

trigger condition コマンドは、トリガー ポイントの名前を指定し、条件の真偽テストを指定し、評価するトリガー セットでの位置を特定します。トリガー ポイントとして評価できる条件の種類は次のとおりです。

• メッセージが要求または応答のいずれであるか

• 要求方式のタイプ

• 応答コード（明示的なコードまたはコードのクラスのいずれか）

• User Agent ヘッダーフィールド値

• Request-URI の一致部分

• Route ヘッダー フィールドの一致部分

• IP アドレスおよびポートの一致

これらのトリガー ポイントは、トリガー コンフィギュレーション モードでコマンドを使用して設定します。

trigger condition コマンドは、トリガーを発生させるために一致する必要のある条件の正規表現を入力値とします。正規表現の詳細については、http://java.sun.com/docs/books/tutorial/extra/regex/ を参照してください。

---

（注） すべてのトリガー条件では「response」または「request」のいずれかにしかならない、MESSAGE フィールドを除く正規表現をサポートします。

---

trigger post-normalization

特定の正規化ポリシーの発信 SIP メッセージの正規化後アルゴリズムを設定するには、Cisco Unified SIP Proxy コンフィギュレーション モードで trigger post-normalization コマンドを使用します。正規化ポリシーから正規化後ポリシー アルゴリズムを削除するには、このコマンドの no 形式を使用します。

trigger post-normalization sequence sequence-number { by-pass | policy policy } [ condition trigger-condition ]

no trigger post-normalization sequence sequence-number policy policy [ condition trigger-condition ]

 

コマンド モード

Cisco Unified SIP Proxy コンフィギュレーション（cusp-config）

trigger pre-normalization

着信 SIP メッセージの正規化前アルゴリズムを正規化ポリシーに設定するには、Cisco Unified SIP Proxy コンフィギュレーション モードで trigger pre-normalization コマンドを使用します。正規化前ポリシー アルゴリズムを正規化ポリシーから削除するには、このコマンドの no 形式を使用します。

trigger pre-normalization sequence sequence-number { by-pass | policy policy } [ condition trigger-condition ]

no trigger pre-normalization sequence sequence-number { by-pass | policy policy } [ condition trigger-condition ]

 

コマンド モード

Cisco Unified SIP Proxy コンフィギュレーション（cusp-config）

trigger routing

ルーティング ポリシーをトリガー条件と関連付けるには、Cisco Unified SIP Proxy コンフィギュレーション モードで trigger routing コマンドを使用します。ルーティング ポリシーと条件の間の関連付けを削除するには、このコマンドの no 形式を使用します。

trigger routing sequence sequence-number { by-pass | policy policy } [ condition trigger-condition ]

no trigger routing sequence sequence-number { by-pass | policy policy } [ condition trigger-condition ]

 

コマンド モード

Cisco Unified SIP Proxy コンフィギュレーション（cusp-config）

sequence（トリガー）

既存のトリガー条件のシーケンス番号を設定し、トリガー シーケンス コンフィギュレーション モードを開始するには、トリガー コンフィギュレーション モードで sequence コマンドを使用します。シーケンス番号をトリガー条件から削除するには、このコマンドの no 形式を使用します。

sequence sequence

no sequence sequence

 

コマンド モード

Trigger コンフィギュレーション（cusp-config-trigger）

header（トリガー シーケンス）

このヘッダーの正規表現と一致する場合に発生するトリガーを設定するには、トリガー シーケンス コンフィギュレーション モードで header コマンドを使用します。トリガーを削除するには、このコマンドの no 形式を使用します。

header header-name { first | last | all } header-value

no header header-name { first | last | all } header-value

 

コマンド モード

トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

in-network

サーバ側トランザクションに対するトリガー条件の着信ネットワークを設定するには、トリガー シーケンス コンフィギュレーション モードで in-network コマンドを使用します。トリガー条件を削除するには、このコマンドの no 形式を使用します。

in-network network-name

no in-network

 

コマンド モード

トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

local-ip

特定のローカル IP アドレスでトリガーが発生する、トリガー条件を設定するには、Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション モードで local-ip コマンドを使用します。ローカル IP アドレスをトリガー条件から削除するには、このコマンドの no 形式を使用します。

local-ip local-listen-ip

no local-ip

 

コマンド モード

Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

local-port

特定のローカル リッスン ポートでトリガーが発生する、トリガー条件を設定するには、Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション モードで local-port コマンドを使用します。トリガー条件からローカルリッスン ポートを削除するには、このコマンドの no 形式を使用します。

local-port local-listen-port

no local-port

 

コマンド モード

トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

message

SIP メッセージのヘッダーが要求ヘッダーか応答ヘッダーかに基づいて、トリガー条件が発生するかどうかを決定するには、トリガー シーケンス コンフィギュレーション モードで message コマンドを使用します。トリガー条件からメッセージ トリガーを削除するには、このコマンドの no 形式を使用します。

message { request | response }

no message

 

コマンド モード

トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

method（トリガー シーケンス）

要求に含まれる特定の SIP メソッド名でトリガーが発生するトリガー条件を設定するには、Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション モードで method コマンドを使用します。トリガー条件を削除するには、このコマンドの no 形式を使用します。

method method-name

no method

 

コマンド モード

トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

mid-dialog

ダイアログ中の応答で発生するトリガーを設定するには、Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション モードで mid-dialog コマンドを使用します。トリガー条件を削除するには、このコマンドの no 形式を使用します。

mid-dialog

no mid-dialog

 

コマンド モード

トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

out-network

クライアント側トランザクションのトリガー条件として発信ネットワークを設定するには、トリガー シーケンス コンフィギュレーション モードで out-network コマンドを使用します。トリガー条件を削除するには、このコマンドの no 形式を使用します。

out-network network-name

no out-network

 

コマンド モード

トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

protocol

特定のプロトコル名で発生するトリガーのトリガー条件を設定するには、Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション モードで protocol コマンドを使用します。トリガー条件を削除するには、このコマンドの no 形式を使用します。

protocol { tcp | tls | udp }

no protocol

 

コマンド モード

Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

proxy-route header-param

指定したヘッダー パラメータの正規表現に一致する場合に発生するトリガーを設定するには、Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション モードで proxy-route header-param コマンドを使用します。トリガー条件を削除するには、このコマンドの no 形式を使用します。

proxy-route header-param header-param-name match-string

no proxy-route header-param header-param-name

 

コマンド モード

Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

proxy-route uri-component

指定した URI コンポーネントの正規表現に一致する場合に発生するトリガーを設定するには、Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション モードで proxy-route uri-component コマンドを使用します。トリガー条件を削除するには、このコマンドの no 形式を使用します。

proxy-route uri-component host host | port port | scheme scheme | uri uri | user user

no proxy-route uri-component host host | port port | scheme scheme | uri uri | user user

 

コマンド モード

Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

proxy-route uri-param

指定した URI パラメータの正規表現に一致する場合に発生するトリガーを設定するには、Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション モードで proxy-route uri-param コマンドを使用します。トリガー条件を削除するには、このコマンドの no 形式を使用します。

proxy-route uri-param uri-param-name match-string

no proxy-route uri-param uri-param-name

 

コマンド モード

Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

remote-ip

ピア要素の特定のリモート IP アドレスでトリガーが発生するトリガー条件を設定するには、Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション モードで remote-ip コマンドを使用します。トリガー条件からリモート IP アドレスを削除するには、このコマンドの no 形式を使用します。

remote-ip remote-ip

no remote-ip [ remote-ip ]

 

コマンド モード

Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

remote-port

ピア要素の特定のリモート ポート番号でトリガーが発生するトリガー条件を設定するには、Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション モードで remote-port コマンドを使用します。トリガー条件からリモート ポートを削除するには、このコマンドの no 形式を使用します。

remote-port remote-port

no remote-port remote-port

 

コマンド モード

Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

request-uri uri-component

指定した URI コンポーネントの正規表現に一致する場合に発生するトリガーを設定するには、Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション モードで request-uri uri-component コマンドを使用します。トリガー条件を削除するには、このコマンドの no 形式を使用します。

request-uri uri-component host host | port port | scheme scheme | uri uri | user user

no request-uri uri-component host host | port port | scheme scheme | uri uri | user user

 

コマンド モード

Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

request-uri uri-param

指定した URI パラメータの正規表現に一致する場合に発生するトリガーを設定するには、Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション モードで request-uri uri-param コマンドを使用します。トリガー条件を削除するには、このコマンドの no 形式を使用します。

request-uri uri-param uri-param-name match-string

no request-uri uri-param uri-param-name

 

コマンド モード

Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

response-code

特定の応答で発生するトリガー条件を設定するには、Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション モードで response-code コマンドを使用します。トリガー条件から応答コードを削除するには、このコマンドの no 形式を使用します。

response-code code

no response-code code

 

コマンド モード

Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

time

指定した時間ポリシーを満たす場合に発生するトリガーを設定するには、Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション モードで time コマンドを使用します。時間ポリシーを削除するには、このコマンドの no 形式を使用します。

time policy

no time

 

コマンド モード

Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション（cusp-config-trigger-seq）

user-agent-hdr

User Agent ヘッダーフィールドの値で発生するトリガー条件を設定するには、Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション モードで user-agent-hdr コマンドを使用します。トリガー条件を削除するには、このコマンドの no 形式を使用します。

user agent-hdr user-agent-hdr-value

no user agent-hdr user-agent-hdr-value

 

コマンド モード

Cisco Unified SIP Proxy トリガー シーケンス コンフィギュレーション（cusp-config-trigger）