GET /v1/admin/maintenance-upgrade-status
Read authoritative maintenance upgrade status
说明（契约原文）
Requires a platform identity with control.upgrades.read. Repeated node_id parameters additionally require nodes.read. Membership and permissions are checked against current database state. Duplicate IDs, noncanonical UUIDs, more than 100 IDs and unknown query parameters are rejected. Nodes are sorted by ID and missing or foreign-scope nodes return 404. The main version comes from the running Control API build, never rollout history or configured version. Candidate metadata is verified against installation-bound signatures, current entitlement and release policy; it does not authorize execution. No grants, plans, reservations or audit records are written by this request.
参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
node_id | query | array<string(uuid)> | 否 | Optional inventory batch; requires nodes.read. |
响应
| 状态码 | 说明 |
|---|---|
200 | Fresh read-only status; unavailable dependencies are explicit states. 字段： |
400 | Invalid query or node IDs. |
401 | Authentication required. |
403 | Platform scope or current permissions denied. |
404 | A requested node is not visible in this scope. |
503 | Required local runtime is unavailable. |
失败时怎么办
400按字段说明修正参数或请求体再发；不要原样重试。401检查凭据格式、是否过期或被轮换。403检查 Key 范围与所有者当前权限、当前租户作用域；不要换更高权限账号绕过。404资源不存在或不属于当前租户。503依赖暂不可用：稍后用原 Idempotency-Key 重试。