| 方法 | 路径 | 摘要 | 认证 |
|---|---|---|---|
| GET | /v1/nodes | List platform nodes with explicit inventory order and keyset pagination | 登录会话 |
| POST | /v1/nodes | Create a pending platform node | 登录会话 |
| POST | /v1/nodes/batch-admin-state | Update one administrative state across a batch of nodes | 登录会话 |
| GET | /v1/nodes/metrics/latest | Get latest durable load samples for a bounded set of platform nodes | 登录会话 |
| GET | /v1/nodes/monitoring/latest | 批量读取节点本机 TCP 探测事实与当前生效策略 | 登录会话 |
| GET | /v1/nodes/registration-credential | Get the reusable node registration credential | 登录会话 |
| POST | /v1/nodes/registration-credential/reset | Reset the node registration credential | 登录会话 |
| GET | /v1/nodes/{id} | Get one platform node | 登录会话 |
| PATCH | /v1/nodes/{id} | Update node inventory metadata or administrative state | 登录会话 |
| POST | /v1/nodes/{id}/enrollment-tokens | Issue a one-time enrollment token | 登录会话 |
| POST | /v1/nodes/{id}/gateway-port-transitions | Start a versioned Agent Gateway communication-port transition | 登录会话 |
| GET | /v1/nodes/{id}/gateway-port-transitions/{transition_id} | Get the durable communication-port transition state | 登录会话 |
| POST | /v1/nodes/{id}/gateway-port-transitions/{transition_id}/finalize | Finalize a switched Agent Gateway communication port | 登录会话 |
| POST | /v1/nodes/{id}/gateway-port-transitions/{transition_id}/rollback | Roll back an Agent Gateway communication-port transition | 登录会话 |
| GET | /v1/nodes/{id}/metrics/latest | Get the latest durable load sample for one platform node | 登录会话 |
契约文件：api/openapi/v1/control.yaml api/node-monitoring-latest.openapi.yaml