GET /v1/admin/system-backup-runs
Read persisted control-plane backup run history
说明（契约原文）
Reads only signed start and terminal facts persisted by the controlled backup runner. A missing terminal or an unverifiable fact is returned as an unknown outcome and is never inferred from plans, approvals, or audit events. With no backup runner bound it answers an empty page with unconfigured=true; a partial or invalid binding is unavailable.
参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
backup_id | query | string | 否 | — |
state | query | string: succeeded / failed / unknown | 否 | — |
from | query | string(date-time) | 否 | — |
to | query | string(date-time) | 否 | — |
limit | query | integer: 10 / 30 / 100 / 300 | 否 | — |
cursor | query | string | 否 | Signed continuation bound to the backup ID, state, and effective time range; omitted times retain the first page range. |
响应
| 状态码 | 说明 |
|---|---|
200 | Persisted backup run facts 字段： |
400 | Invalid query or cursor |
401 | Authentication required |
403 | Platform administrator permission required |
503 | Protected backup history capability unavailable |
失败时怎么办
400按字段说明修正参数或请求体再发；不要原样重试。401检查凭据格式、是否过期或被轮换。403检查 Key 范围与所有者当前权限、当前租户作用域；不要换更高权限账号绕过。503依赖暂不可用：稍后用原 Idempotency-Key 重试。