node-ip-blacklist
データノードで制御ノードと同期されたアドレスグループ(IPブロックリスト)データを照会します。guid オプションを指定すると該当アドレスグループのIP項目を照会し、省略するとすべてのアドレスグループの一覧を照会します。
コマンドプロパティ
| 項目 | 説明 |
|---|---|
| コマンドタイプ | ドライバークエリ |
| 必要な権限 | 管理者 |
| ライセンス使用量 | なし |
| 並列実行 | 非対応 |
| 分散実行 | 非対応 |
構文
アドレスグループの一覧を照会するには
node-ip-blacklist
特定のアドレスグループのIP項目を照会するには
node-ip-blacklist guid=STR
オプション
guid=STR- 照会するアドレスグループのGUID。省略するとすべてのアドレスグループの一覧を照会します。
出力フィールド
guid オプションを省略した場合(アドレスグループ一覧):
| フィールド | 型 | 説明 |
|---|---|---|
| id | integer | アドレスグループID |
| guid | string | アドレスグループGUID |
| name | string | アドレスグループ名 |
| description | string | アドレスグループの説明 |
| count | long | IPアドレス項目数 |
| version | long | アドレスグループのバージョン |
| user_name | string | 作成したユーザー名 |
| user_guid | string | 作成したユーザーGUID |
guid オプションを指定した場合(IP項目一覧):
| フィールド | 型 | 説明 |
|---|---|---|
| ip | ipaddr | IPアドレス |
| description | string | IPアドレスの説明 |
エラーコード
パースエラー
| エラーコード | メッセージ | 説明 |
|---|---|---|
| 300330 | node-ip-blacklist을 실행할 권한이 없습니다. | 管理者権限のないセッションで実行した場合 |
| 300331 | node-ip-blacklist 명령의 guid 옵션이 유효한 형식이 아닙니다. | guid オプション値が有効なGUID形式でない場合 |
| 300332 | node-ip-blacklist에서 지정한 IP 블랙리스트 [guid]을 찾을 수 없습니다. | guid に対応するアドレスグループが存在しない場合 |
ランタイムエラー
該当なし
説明
node-ip-blacklist コマンドは、データノードに同期されたアドレスグループデータを照会します。このコマンドはデータノードでのみ使用可能であり、管理者権限が必要です。
guid オプションを指定すると、該当アドレスグループに登録された個別IPアドレスと説明を照会します。guid オプションを省略すると、データノードに同期されたすべてのアドレスグループのメタデータ一覧を照会します。
使用例
-
すべてのアドレスグループ一覧の照会
node-ip-blacklistデータノードに同期されたすべてのアドレスグループの一覧を照会します。
-
特定のアドレスグループのIP項目の照会
node-ip-blacklist guid=550e8400-e29b-41d4-a716-446655440000指定したGUIDに対応するアドレスグループのIPアドレス項目を照会します。
互換性
node-ip-blacklist コマンドはSonar 4.0以前のバージョンから提供されています。