---
title: "Test Switch"
method: POST
path: "/api/admin/switches/{switch_id}/test"
tags: ["Admin: Switches"]
---

# Test Switch

`POST /api/admin/switches/{switch_id}/test`

## Request

- Base URL: `https://api.fiber.ac` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fiber.ac/api/admin/switches/{switch_id}/test`
- Auth: none declared

gNMI Capabilities probe — 도달성 + vendor 자동 감지.

## Path parameters

- `switch_id` integer, required

## Response `200`

Successful Response

- ProbeResult: gNMI Capabilities probe 결과.
  - `reachable` boolean, required
  - `vendor_os` string, nullable
  - `vendor_os_ver` string, nullable
  - `adapter` string, nullable
  - `supported_models` string[]
  - `latency_ms` number, nullable
  - `error` string, nullable
  - `error_code` 'AUTH_REJECTED' | 'TLS_REQUIRED' | 'TIMEOUT' | 'MODEL_UNSUPPORTED' | 'DNS_FAIL' | 'REFUSED' | 'UNKNOWN', nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fiber-ac/apis/fiber-api.md) · [All operations](https://skmtc.dev/fiber-ac/apis/fiber-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fiber-ac/apis/fiber-api/revisions/58267250d793?raw)