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 | no permission for node-ip-blacklist | 管理者権限のないセッションで実行した場合 |
| 300331 | invalid guid format for node-ip-blacklist | guid オプション値が有効なGUID形式でない場合 |
| 300332 | IP blacklist [guid] not found for node-ip-blacklist | 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以前のバージョンから提供されています。