組み込みイベント マネージャ（EEM）ポリシーは、Python スクリプトをサポートします。Python スクリプトを EEM ポリシーとして登録し、対応するイベントが発生したときに、登録済みの Python スクリプトを実行することができます。EEM Python スクリプトには、EEM TCL ポリシーと同じイベント仕様の構文があります。

設定済みの EEM ポリシーは、ゲスト シェル内で実行します。ゲスト シェルは、仮想化された Linux ベースの環境であり、Cisco デバイスの自動制御と管理のための Python アプリケーションを含む、カスタム Linux アプリケーションを実行するように設計されています。ゲスト シェル コンテナは、Python インタープリタを提供します。

EEM Python パッケージを Python スクリプトにインポートすると、EEM に固有の拡張機能を実行できます。

（注）	EEM Python パッケージは、EEM Python スクリプト内でのみ使用できます（パッケージは EEM に登録でき、スクリプトの最初の行に EEM イベント仕様が記載されます）。標準的な Python スクリプト（Python スクリプト名を使用して実行される）では使用できません。

Python パッケージには、次のアプリケーション プログラミング インターフェイス（API）が含まれています。

• アクション API：EEM アクションを実行するもので、デフォルトのパラメータがあります。

• CLI 実行 API：IOS コマンドを実行し、出力を返します。次に、CLI 実行 API のリストを示します。

  • eem_cli_open()

  • eem_cli_exec()

  • eem_cli_read()

  • eem_cli_read_line()

  • eem_cli_run()

  • eem_cli_run_interactive()

  • eem_cli_read_pattern()

  • eem_cli_write()

  • eem_cli_close()

• 環境変数にアクセスする API：組み込みまたはユーザ定義の変数のリストを取得します。次に、環境変数にアクセスする API を示します。

  • eem_event_reqinfo ()：組み込み変数のリストを返します。

  • eem_user_variables()：引数の現在の値を返します。

Python パッケージ（EEM スクリプト内でのみ使用可能で、標準的な Python スクリプトでは使用不可）では、次の EEM アクションをサポートしています。

• Syslog メッセージの印刷

• SNMP トラップの送信

• ボックスのリロード

• スタンバイ デバイスへの切り替え

• ポリシーの実行

• トラック オブジェクトの読み取り

• トラック オブジェクト セット

• Cisco ネットワーキング サービスのイベントの生成

EEM Python パッケージは、EEM アクションを実行するため、インターフェイスを公開します。これらのアクションは Python スクリプトを使用して呼び出すことができ、Cisco Plug N Play（PnP）経由で Python パッケージからアクション ハンドラに転送されます。

EEM ポリシーは、次の種類の変数を持つことができます。

• イベント固有の組み込み変数：ポリシーをトリガーしたイベントの詳細が設定される事前定義の変数のセット。eem_event_reqinfo () API は、組み込み変数のリストを返します。これらの変数は、ローカル マシンに保存してローカル変数として使用することができます。ローカル変数に対する変更は、組み込み変数に反映されません。

• ユーザ定義の変数：定義およびポリシーでの使用が可能な変数。これらの変数の値は、Python スクリプト内で参照できます。スクリプトを実行する際に、変数の最新の値が使用可能であることを確認してください。eem_user_variables() API は、API で入力された引数の現在の値を返します。

EEM 内では、Python スクリプトを動作させるため、次の CLI ライブラリ コマンドを使用できます。

• eem_cli_close()：EXEC プロセスをクローズし、コマンドに接続された、VTY および指定されたチャネル ハンドラをリリースします。

• eem_cli_exec：指定されたチャネル ハンドラにコマンドを記述し、コマンドを実行します。次に、チャネルからコマンドの出力を読み取り、出力を返します。

• eem_cli_open：VTY を割り当て、EXEC CLI セッションを作成し、VTY をチャネル ハンドラに接続します。チャネル ハンドラを含む配列を返します。

• eem_cli_read()：読み取られている内容でデバイス プロンプトのパターンが発生するまで、指定された CLI のチャネル ハンドラからコマンド出力を読み取ります。一致するまで、読み取られたすべての内容を返します。

• eem_cli_read_line()：指定された CLI のチャネル ハンドラから、コマンド出力の 1 行を読み取ります。読み取られた行を返します。

• eem_cli_read_pattern()：読み取られている内容でパターンが発生するまで、指定された CLI のチャネル ハンドラからコマンド出力を読み取ります。一致するまで、読み取られたすべての内容を返します。

• eem_cli_run()：clist にある項目を繰り返し、それぞれが、イネーブル モードで実行されるコマンドであることを前提とします。正常に実行されると、実行されたすべてのコマンドの出力を返します。失敗すると、エラーを返します。

• eem_cli_run_interactive()：3 つの項目がある clist のサブリストを用意します。正常に実行されると、実行されたすべてのコマンドの出力を返します。失敗すると、エラーを返します。可能な場合には、配列も使用します。予測と応答を別々に保持することによって、より簡単に後で読み取ることができます。

• eem_cli_write()：指定された CLI チャネル ハンドラに対して実行されるコマンドを書き込みます。CLI チャネル ハンドラによって、コマンドが実行されます。

Python スクリプトが動作できるようにするには、ゲスト シェルを有効化する必要があります。詳細については、「ゲスト シェル」の章を参照してください。