action (アクション)
内容
casp1032jp
内容
アクション リソースを使用して、
SpectroSERVER
に対するアクション要求を発行します。内部アクション コードは、アクションによって実行される操作を決定します。- ベース URLhttp://<hostname><:portnumber>/spectrum/restful/action
GET アクション
GET アクションは、
SpectroSERVER
に対するアクション要求を発行します。HTTP GET として開始され、データの変更など、SpectroSERVER
で実行されるアクションは、アクション コードによって指定されます。すべてのアクションは、要求されたアクションによって異なる結果を返します。- URLhttp://<hostname><:portnumber>/spectrum/restful/action/<action_code>[?mh=<model_handle>][&attr=<attr_ID>&val=<num>][&throttlesize=<num>]
- HTTP メソッドGET
- ボディなし
- ボディ コンテンツ使用されません
- ヘッダapplication/xml、application/json
- 出力XML または JSON のリストです。コンテンツは、要求されたアクションに応じて異なります。
URL パラメータ
- action_codeSpectroSERVER上で実行するアクションを指定します。以下の表には、一般的なアクションが含まれています。
アクション | ターゲット モデル | Description |
0x1000e | device | モデルを再設定します(再設定) |
0x480003 | watch | ウォッチをアクティブ化します(アクティブ化) |
0x480004 | watch | ウォッチを非アクティブ化します(非アクティブ化) |
0x210008 | device | Cisco および Wellfleet デバイス上でアプリケーション モデルを再設定します(reconfigure_apps) |
0x100a2 | VNM | SpectroSERVER を EventDisp および AlertMap ファイルの変更で更新します(reload_event_disp) |
0x100f6 | グローバル コレクション | 定期的な検索ベース グローバル コレクションのメンバシップを更新します |
0x10274 | VNM | EMS のデバッグをオンにします |
0x10275 | VNM | EMS のデバッグをオフにします |
0x10301 | VNM またはグローバル コレクション | 宛先が VNM モデルの場合はすべての検索に対して検索デバッグをオンにし、宛先がグローバル コレクションの場合は単一のグローバル コレクションに対して検索デバッグをオンにします |
0x10300 | VNM またはグローバル コレクション | 宛先が VNM モデルの場合はすべての検索に対して検索デバッグをオフにし、宛先がグローバル コレクションの場合は単一のグローバル コレクションに対して検索デバッグをオフにします |
0xbc614d | RFC2790App | ファイル システム監視のデバッグを切り替えます |
0xbd6146 | RFC2790App | プロセス監視のデバッグを切り替えます |
- &mh=<model_handle>(オプション)アクションのターゲットを指定します。
- &attr=<attr_ID>&val=<num>(オプション)アクションへの入力として属性値を指定します。複数の属性値のペアを指定することができます。
- &throttlesize=<num>(オプション)スロットル サイズを指定します。
例
以下の URL は、SearchManager モデル(0x400018)に対して「FIND_DEV_MODELS_BY_IP」アクション(0x10093)を開始します。
http://<hostname><:portnumber>/spectrum/restful/action/0x10093?mh=0x400018&attr=0&val=172.22.96.11&attr=1&val=172.22.96.5
注:
- SearchManager モデル ハンドルは、SpectroSERVERとSpectroSERVERの間で異なります。
- GET モデルの POST 本文に正しいロケータ検索を埋め込むことで、デバイスモデルを IP で検索することもできます。