---
title: "Patch Switch"
method: PATCH
path: "/api/admin/switches/{switch_id}"
tags: ["Admin: Switches"]
---

# Patch Switch

`PATCH /api/admin/switches/{switch_id}`

## 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}`
- Auth: none declared

## Path parameters

- `switch_id` integer, required

## Request body

- SwitchPatch: 부분 업데이트 — None 인 필드는 변경하지 않음.
  - `vendor` 'arista' | 'cisco' | 'nvidia' | 'juniper' | 'unknown', nullable
  - `model` string, nullable
  - `role` string, nullable
  - `rack_id` string, nullable
  - `pod_id` string, nullable
  - `mgmt_ip` string, nullable
  - `gnmi_port` integer, nullable
  - `tenant_id` string, nullable
  - `username` string, nullable
  - `password` string, nullable
  - `ssh_key` string, nullable
  - `auth_method` 'password' | 'ssh_key' | 'mtls', nullable
  - `poll_interval_s` integer, nullable
  - `tls_insecure` boolean, nullable
  - `enabled` boolean, nullable

## Response `200`

Successful Response

- SwitchOut: 관리자 응답 — 비밀 필드 없음.
  - `id` integer, required
  - `name` string, required
  - `vendor` string, required
  - `model` string, nullable
  - `role` string, required
  - `rack_id` string, nullable
  - `pod_id` string, nullable
  - `mgmt_ip` string, nullable
  - `gnmi_port` integer, required
  - `tenant_id` string, required
  - `enabled` boolean, required
  - `onboarded_at` string, date-time, nullable
  - `last_seen_at` string, date-time, nullable
  - `last_probe_ok` boolean, nullable
  - `last_probe_err` string, nullable
  - `vendor_os` string, nullable
  - `vendor_os_ver` string, nullable
  - `source` string, required
  - `source_ref` string, nullable
  - `poll_interval_s` integer, required
  - `tls_insecure` boolean, required
  - `config_version` integer, required
  - `has_password` boolean
  - `has_ssh_key` boolean
  - `auth_method` string, nullable
  - `username` string, 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)