用標準 HTTP 請求控制設備

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 爲已有鏈路設置單向 100 ms 時延

此示例對應多功能系列。先從目標引擎的虛擬鏈路列表中確認鏈路 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 錯誤與響應檢查。

python3 chaosbridge_api_example.py --url "$CHAOSBRIDGE_URL"

# 使用上一步響應中的實際引擎 ID，讀取該引擎的虛擬鏈路
python3 chaosbridge_api_example.py \
  --url "$CHAOSBRIDGE_URL" --engine-id YOUR_ENGINE_ID

將輸出重定向到 JSON 文件，即可保存本次設備發現結果，作爲自動化測試流程的起點。

從一次請求到自動化迴歸

連接設備 → 讀取目標鏈路 → 配置網絡條件 → 執行業務測試 → 採集統計與抓包 → 保存結果。可以使用 Python、Java、JavaScript、C#、Go 或其他支持 HTTP 的語言組織這一流程。

需要批量配置、循環測試、錯誤重試或 CSV 報告時，可以把測試步驟告訴網準通技術顧問。