- FutureNet製品活用ガイド
- FutureNet NXR,VXRシリーズ
- REST-API編
FutureNet
NXR,VXRシリーズ
REST-API編
9. ネットイベント設定
9-1. ネットイベント設定（netevent）
処理概要
ネットイベント設定に関する処理を実行します。
URIおよびメソッド
| 機能 | Version | URI | メソッド | |||
| POST | PUT | GET | DELETE | |||
| Netevent | v2 | /api/v2/netevent | － | － | － | － |
| /api/v2/netevent/snmp-trap | － | 〇 | ● | 〇 | ||
| /api/v2/netevent/send_mail | － | 〇 | ● | 〇 | ||
| /api/v2/netevent/track | 〇 | － | ● | － | ||
| /api/v2/netevent/track/{TRACK_ID} | － | 〇 | ● | 〇 | ||
凡例：
● : 読み取り専用ユーザも含めアクセス可
〇 : 読み取り専用ユーザはアクセス不可
－ : 未対応
実行例
トラック設定ステータス遷移時のSNMPトラップ設定の更新
| メソッド | URI |
| PUT | /api/v2/netevent/snmp-trap |
JSON
リクエスト
PUT /api/v2/netevent/snmp-trap
Content-Type: application/json
{
"snmp-trap": "enable"
}
レスポンス
204 No content
XML
リクエスト
PUT /api/v2/netevent/snmp-trap
Content-Type: application/xml
<netevent>
<snmp-trap>enable</snmp-trap>
</netevent>
レスポンス
204 No content
トラック設定ステータス遷移時のSNMPトラップ設定の取得
| メソッド | URI |
| GET | /api/v2/netevent/snmp-trap |
JSON
リクエスト
GET /api/v2/netevent/snmp-trap
Accept: application/json
レスポンス
200 OK
Content-Type: application/json
{
"snmp-trap": "enable"
}
XML
リクエスト
GET /api/v2/netevent/snmp-trap
Accept: application/xml
レスポンス
200 OK
Content-Type: application/xml
<netevent>
<snmp-trap>enable</snmp-trap>
</netevent>
TEXT/PLAIN
リクエスト
GET /api/v2/netevent/snmp-trap
Accept: text/plain
レスポンス
200 OK
Content-Type: text/plain
track snmp trap
トラック設定ステータス遷移時のSNMPトラップ設定の削除
| メソッド | URI |
| DELETE | /api/v2/netevent/snmp-trap |
リクエスト
DELETE /api/v2/netevent/snmp-trap
レスポンス
204 No content
トラック設定ステータス遷移時のメール送信設定の更新
| メソッド | URI |
| PUT | /api/v2/netevent/send_mail |
JSON
リクエスト
PUT /api/v2/netevent/send_mail
Content-Type: application/json
{
"send_mail": {
"server": 1
}
}
レスポンス
204 No content
XML
リクエスト
PUT /api/v2/netevent/send_mail
Content-Type: application/xml
<netevent>
<send_mail>
<server>1</server>
</send_mail>
</netevent>
レスポンス
204 No content
トラック設定ステータス遷移時のメール送信設定の取得
| メソッド | URI |
| GET | /api/v2/netevent/send_mail |
JSON
リクエスト
GET /api/v2/netevent/send_mail
Accept: application/json
レスポンス
200 OK
Content-Type: application/json
{
"send_mail": {
"server": 1
}
}
XML
リクエスト
GET /api/v2/netevent/send_mail
Accept: application/xml
レスポンス
200 OK
Content-Type: application/xml
<netevent>
<send_mail>
<server>1</server>
</send_mail>
</netevent>
TEXT/PLAIN
リクエスト
GET /api/v2/netevent/send_mail
Accept: text/plain
レスポンス
200 OK
Content-Type: text/plain
track mail send server 1
トラック設定ステータス遷移時のメール送信設定の削除
| メソッド | URI |
| DELETE | /api/v2/netevent/send_mail |
リクエスト
DELETE /api/v2/netevent/send_mail
レスポンス
204 No content
トラック設定の作成
| メソッド | URI |
| POST | /api/v2/netevent/track |
JSON
リクエスト
POST /api/v2/netevent/track
Content-Type: application/json
{
"track": {
"track-id": 1,
"method": "ip",
"keepalive": {
"destination": "192.168.0.1"
}
}
}
レスポンス
201 Created
XML
リクエスト
POST /api/v2/netevent/track
Content-Type: application/xml
<netevent>
<track>
<track-id>1</track-id>
<method>ip</method>
<keepalive>
<destination>192.168.0.1</destination>
</keepalive>
</track>
</netevent>
レスポンス
201 Created
全トラック設定の取得
| メソッド | URI |
| GET | /api/v2/netevent/track |
JSON
リクエスト
GET /api/v2/netevent/track
Accept: application/json
レスポンス
200 OK
Content-Type: application/json
{
"track": [
{
"track-id": 1,
"method": "ip",
"keepalive": {
"destination": "192.168.0.1"
}
},
{
"track-id": 2,
・・・・・
XML
リクエスト
GET /api/v2/netevent/track
Accept: application/xml
レスポンス
200 OK
Content-Type: application/xml
<netevent>
<track>
<track-id>1</track-id>
<method>ip</method>
<keepalive>
<destination>192.168.0.1</destination>
</keepalive>
</track>
<track>
<track-id>2</track-id>
・・・・・
TEXT/PLAIN
リクエスト
GET /api/v2/netevent/track
Accept: text/plain
レスポンス
200 OK
Content-Type: text/plain
track 1 ip reachability 192.168.0.1
・・・・・
トラック設定の更新
| メソッド | URI |
| PUT | /api/v2/netevent/track/{TRACK_ID} |
JSON
リクエスト
PUT /api/v2/netevent/track/1
Content-Type: application/json
{
"track-id": 1,
"method": "ip",
"keepalive": {
"interval": 30,
"destination": "192.168.0.1"
}
}
レスポンス
204 No content
XML
リクエスト
PUT /api/v2/netevent/track/1
Content-Type: application/xml
<track>
<track-id>1</track-id>
<method>ip</method>
<keepalive>
<interval>30</interval>
<destination>192.168.0.1</destination>
</keepalive>
</track>
レスポンス
204 No content
トラック設定の取得
| メソッド | URI |
| GET | /api/v2/netevent/track/{TRACK_ID} |
JSON
リクエスト
GET /api/v2/netevent/track/1
Accept: application/json
レスポンス
200 OK
Content-Type: application/json
{
"track-id": 1,
"method": "ip",
"keepalive": {
"interval": 30,
"destination": "192.168.0.1"
}
}
XML
リクエスト
GET /api/v2/netevent/track/1
Accept: application/xml
レスポンス
200 OK
Content-Type: application/xml
<track>
<track-id>1</track-id>
<method>ip</method>
<keepalive>
<interval>30</interval>
<destination>192.168.0.1</destination>
</keepalive>
</track>
TEXT/PLAIN
リクエスト
GET /api/v2/netevent/track/1
Accept: text/plain
レスポンス
200 OK
Content-Type: text/plain
track 1 ip reachability 192.168.0.1 30 3
トラック設定の削除
| メソッド | URI |
| DELETE | /api/v2/netevent/track/{TRACK_ID} |
リクエスト
DELETE /api/v2/netevent/track/1
レスポンス
204 No content
パラメータ
指定可能なパラメータは下記の通りです。
なお、指定可能なパラメータは製品およびファームウェアのバージョンにより異なりますので、各パラメータの詳細については各製品のユーザーズガイド（CLI版）も合わせてご参照ください。
- パラメータ表の説明文中の記号について
< > … 括弧内の値の範囲から選択することを示しています。
[ ] … 括弧内の値のどれかを選択することを示しています。
数字,文字列 … 初期値 - パラメータ表の説明文中のデータタイプについて
A.B.C.D … IPv4アドレス
X:X::X:X … IPv6アドレス
FQDN … FQDN名
| パラメータおよびレベル | 説明 | ||||
|---|---|---|---|---|---|
| Lv.1 | Lv.2 | Lv.3 | Lv.4 | Lv.5 | |
| netevent | snmp-trap | SNMPトラップ通知 … [ enable | disable ] | |||
| send_mail | server | メール送信サーバ設定番号 | |||
| subject | 件名 | ||||
| track | track-id | トラックID | |||
| method | 監視対象 … [ bgp | dio-input | interface | ip | ipv6 | isakmp | list | ndisc | ndisc6 | ospf | resume | vrrp ] | ||||
| interface | インタフェース名 | ||||
| number | number …
|
||||
| router-id | OSPFルータID/BGPピアIP …
|
||||
| keepalive | destination | 宛先アドレス …
|
|||
| source | 送信元アドレス/インタフェース名 …
|
||||
| interval | インターバル … <10-32767(60)>(sec) | ||||
| retry | リトライ … <0-255(3)> | ||||
| delay | ディレイ … <10-32767>(sec) | ||||
| variable | variable … [ enable | disable ] | ||||
| recovery | リカバリー … <1-255> | ||||
| rtt | Round Trip Time … <1-5000>(msec) | ||||
| rtt-normal | RTTノーマルカウント … <1-255(3)> | ||||
| rtt-delay | RTTディレイカウント … <1-255(3)> | ||||
| df | DFビット … [ enable | disable ] | ||||
| ttl | TTLまたはHop Limit… <1-255(64)> | ||||
| length | ペイロード長 … <56-1500(56)> | ||||
| vrrp | id | VRRP ID | |||
| interface | インタフェース名（ex. ethernet0） | ||||
| log-type | モニタログによるロギング … [ 0 | 1 ] | ||||
| timeout | イニシャルタイムアウト … <10-3600>(sec) | ||||
| delay | ディレイタイマ … <10-3600>(sec) ※ip/ipv6 reachability以外で使用 |
||||
| track-list | object | トラックID | |||
目次
更新情報
→ 一覧へカテゴリ
タグ
- CRG
- DDNS
- DHCP
- DNAT
- DNSインターセプト
- Ethernet
- IIJモバイル
- IKE Modeconfig
- IKEv2 Configuration Payload
- IPinIP
- IPoE
- IPv6
- KDDI
- L2TPv3
- MAP-E
- NGN
- NTTドコモ
- PBR
- Policy Based IPsec
- PPP
- PPPoE
- QoS
- RADIUS連携
- RAシリーズ
- Route Based IPsec
- SMS
- SNAT
- SoftBank
- UPnP
- URL転送
- VLAN
- VRRP
- Web認証
- WiMAX
- コンフィグロールバック
- ネットイベント
- フィルタ
- ブリッジ
- モニタログ
- ワイモバイル
- 仮想スイッチ
- 冗長化
- 無線LAN