NetAccura · ChaosBridge

標準HTTPリクエストで機器を制御

HTTPとJSONを使用し、専用API SDKは不要。機器の検出から多機能シリーズの固定遅延設定までを紹介します。

APIドキュメントApifox

今後の各バージョンのAPIドキュメントもここで公開します。

ドキュメントのアクセスパスワードNetAccura

01 機器アドレスとAPI Tokenを取得

管理画面のセキュリティ設定でAPI Tokenを作成。YOUR_DEVICEとYOUR_API_TOKENを実際の管理アドレスとTokenに置き換え、機器に設定されたHTTPまたはHTTPSを使用してください。

Authorization: Bearerで認証します。リクエスト本文はapplication/jsonです。

export CHAOSBRIDGE_URL="https://YOUR_DEVICE"
export CHAOSBRIDGE_TOKEN="YOUR_API_TOKEN"

curl --fail-with-body \
  -H "Authorization: Bearer $CHAOSBRIDGE_TOKEN" \
  "$CHAOSBRIDGE_URL/api/v1/engines"

HTTPステータスコードと応答のsuccessを確認。エンジン照会応答に含まれるエンジン、ポート、機能情報から実際の識別子を使用します。

02 既存リンクに片方向100msの遅延を設定

多機能シリーズ向けの例です。対象エンジンの仮想リンク一覧でIDを確認し、YOUR_LINK_IDを置き換えます。A → B方向の固定遅延のみ更新し、未送信の項目は元の設定を維持します。

export LINK_ID="YOUR_LINK_ID"

curl --fail-with-body -X PATCH \
  "$CHAOSBRIDGE_URL/api/v1/virtual-links/$LINK_ID" \
  -H "Authorization: Bearer $CHAOSBRIDGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "config": {
      "direction_a_to_b": {
        "enabled": true,
        "delay": {"mode": 1, "value_ms": 100}
      }
    }
  }'

PATCH成功は設定要求の完了を示します。マッチング規則、エミュレーション有効状態、実際のトラフィックと統計で効果を確認してください。FPGAシリーズは専用の設定フィールドを使用します。サンプルは技術アドバイザーへご相談ください。

03 Python接続サンプルをダウンロード

Python 3のurllib、jsonなど標準ライブラリのみを使用。エンジンと仮想リンクを照会し、タイムアウト、HTTPエラー、応答チェックを処理します。

Pythonサンプルスクリプトをダウンロード

python3 chaosbridge_api_example.py --url "$CHAOSBRIDGE_URL"

# 前の応答に含まれる実際のエンジンIDを使い、仮想リンクを取得
python3 chaosbridge_api_example.py \
  --url "$CHAOSBRIDGE_URL" --engine-id YOUR_ENGINE_ID

出力をJSONファイルにリダイレクトすると、機器検出結果を保存し、自動テストの起点にできます。

1回のリクエストから自動回帰試験へ

機器に接続 → 対象リンクを取得 → 条件を設定 → 業務試験 → 統計・キャプチャー取得 → 結果保存。HTTP対応のPython、Java、JavaScript、C#、Goなどで実装できます。

一括設定、繰り返し試験、エラー時の再試行、CSVレポートが必要な場合は、試験手順をNetAccuraの技術アドバイザーにお知らせください。