ナビゲーション

ナビゲーション プロパティは、コンソール ユーザ インターフェースに似ています。ナビゲーション プロパティ名の後には、必要に応じて /$count パス セグメントを指定し、必要に応じて関連するエンティティのフィルタリング、並べ替え、選択、ページング、展開などの、かっこ付きの展開オプション セットを指定できます。
nfa1000
ナビゲーション プロパティは、
Network Flow Analysis
コンソール ユーザ インターフェースに似ています。ナビゲーション プロパティ名の後には、必要に応じて
/$count
パス セグメントを指定し、必要に応じて関連するエンティティのフィルタリング、並べ替え、選択、ページング、展開などの、かっこ付きの展開オプション セットを指定できます。
ナビゲーションで使用可能なオプションのリストは、以下のとおりです。
単純なナビゲーション
NFA API で実行するアクションは、NFA Console と同じです。NFA Console のナビゲーションについて使用可能なシナリオのリストを以下の表に示します。
このインターフェース
(エンティティ名)
で表示する内容:
このインターフェースと <
前の列で選択したインターフェースの値
> で表示する内容
プロトコル(プロトコル)
ホスト
通信
ToS (toss)
プロトコル
ホスト
通信
ホスト(ホスト)
プロトコル
通信(通信)
プロトコル
asNums
asNextHop
リソース URL
http://<
nfa odata host
>:<
nfa odata port
>/odata/api/<
EntityType Name
>(<
PropertyRef Name
>)/<
EntityType Name
>(<
PropertyRef Name
>)
メソッド
GET
パラメータ
以下の表には、必須パラメータが含まれています。
パラメータ
Description
EntityType 名
エンティティ タイプの名前を示します。
有効な EntityType 名のリストの詳細については、「メタデータ」を参照してください。
PropertyRef 名
エンティティのプロパティ参照名を示します。
有効な PropertyRef 名のリストの詳細については、「メタデータ」を参照してください。
サンプル リクエスト
この例は、インターフェースからホストへのナビゲーションを示しています。
http://127.0.0.1:8981/odata/api/interfaces(9)/hosts?&startTime=1526891820&endTime=1526896858&resolution=min15
サンプル レスポンス
{
"@odata.context": "$metadata#hosts",
"value": [
{
"router": "127.0.0.1",
"interface": 9,
"timestamp": 1526892300,
"protocol": 0,
"host": "127.0.0.1",
"inoctets": 1200000,
"outoctets": 12000000
},
{
"router": "127.0.0.1",
"interface": 9,
"timestamp": 1526892300,
"protocol": 0,
"host": "127.0.0.1",
"inoctets": 12000000,
"outoctets": 1200000
},
{
"router": "127.0.0.1",
"interface": 9,
"timestamp": 1526892300,
"protocol": 0,
"host": "127.0.0.1",
"inoctets": 795000,
"outoctets": 7950000
},
{
"router": "127.0.0.1",
"interface": 9,
"timestamp": 1526892300,
"protocol": 0,
"host": "127.0.0.1",
"inoctets": 7950000,
"outoctets": 795000
}
]
}
ホスト フィルタを使用したナビゲーション
サンプル リクエスト
http://127.0.0.1:8981/odata/api/interfaces(79)/protocols(0)/hosts?$top=10&startTime=1536754500 &endTime=1537289100 &$filter=contains(host,'8.8.8.80')
通信フィルタを使用したナビゲーション
サンプル リクエスト
http://127.0.0.1:8981/odata/api/interfaces(79)/conversations?startTime=1536754500 &endTime=1537289100 &$filter=contains(DestHost,'80.80.80.80' )
プロトコル名を含むサンプル リクエスト
http://127.0.0.1:8981/odata/api/interfaces(79)/conversations?startTime=1536754500 &endTime=1537289100 &$filter=contains(DestHost,'80.80.80.80' )&protocolNames=true
プロトコル名プロパティの取得および追加はリソースを大量に消費し、応答時間が長くなることがあるため、必要な場合にのみ使用してください。
プロトコルへの通信を使用したナビゲーション
サンプル リクエスト
http://127.0.0.1:8981/odata/api/interfaces(79)/conversations(SrcHost='127.0.0.1',DestHost='127.0.0.1')/protocols?$top=10&$count=true&startTime=1536754500 &endTime=1537289100
プロトコル名を含むサンプル リクエスト
http://127.0.0.1:8981/odata/api/interfaces(79)/conversations(SrcHost='127.0.0.1',DestHost='127.0.0.1')/protocols?$top=10&$count=true&startTime=1536754500 &endTime=1537289100 &protocolNames=true
プロトコル名プロパティの取得および追加はリソースを大量に消費し、応答時間が長くなることがあるため、必要な場合にのみ使用してください。
asNum を使用したナビゲーション
サンプル リクエスト
http://127.0.0.1:8981/odata/api/interfaces(79)/asNums?&startTime=1536754500&endTime=1537289100&resolution=min15
asNextHop を使用したナビゲーション
サンプル リクエスト
http://127.0.0.1:8981/odata/api/interfaces(79)/asNextHop?&startTime=1536754500&endTime=1537289100&resolution=min15&$filter=contains(nexthop,'172.168.0.1')
asNextHop への asNum を使用したナビゲーション
サンプル リクエスト
http://127.0.0.1:8981/odata/api/interfaces(79)/asNums(0)/asNextHop?&startTime=1536754500&endTime=1537289100&resolution=min15