19 lines
991 B
Markdown
19 lines
991 B
Markdown
# Admin API
|
||
|
||
Admin API 使用独立监听器与权限，契约位于 `api/openapi/admin.yaml`。公网部署
|
||
不得与 Distribution 复用认证 Token；推荐只绑定管理网段或回环地址。
|
||
|
||
## 端点
|
||
|
||
- `GET /api/v1/status`：返回配置/快照版本、Upstream 聚合计数和 Worker 状态。
|
||
- `POST /api/v1/upstreams/{name}/enable`：启用 Upstream。
|
||
- `POST /api/v1/upstreams/{name}/disable`：停止新 Fetch/分配并自然 Drain。
|
||
- `POST /api/v1/routing/{name}/switch`：用 expectedCurrent 做 CAS 手工切换。
|
||
- `POST /api/v1/config/reload`：严格解析并原子发布新配置。
|
||
|
||
所有写操作写审计记录并返回最终 Request ID 与版本。Enable/Disable 对目标状态
|
||
幂等；Routing Switch 必须携带 `expectedCurrent`，避免并发操作跳过多个供应商。
|
||
|
||
配置重载校验失败返回 422，旧配置继续运行。Status 只返回低基数聚合信息，
|
||
不得返回 Proxy 地址、凭据、Client 标识或完整 Provider URL。
|