跳转到主要内容
API Explorer|API Explorer
基础设施相关接口/OTA 版本与策略
GETOTA起始版本 1.0同步需要认证

查询预检结果列表

列表预检结果。

调试可用性

在线调试

使用当前认证信息和示例参数提交 Mock 请求。

路径参数

查询参数

请求参数

路径参数

  • planIdString必填

    计划ID。

查询参数

  • pageSizeInteger

    每页返回的记录数。

    示例： 0

响应状态

200 OK

该 API 成功时返回以下响应结构。

  • itemsList

    条目列表。

    示例： (nested array)

    • planIdString

      计划ID。

      示例： plan-a1b2c3d4-e5f6-7890-abcd-ef1234567890

    • modeString

      已使用预检运行。

      示例： strict

    • totalAgentsInteger

      代理总数。

      示例： 20

    • healthyAgentsInteger

      健康代理。

      示例： 19

    • unhealthyAgentsInteger

      不健康代理。

      示例： 1

    • healthyPctLong

      健康百分比。

      示例： 95

    • decisionString

      处理决定。

      示例： proceed

    • excludedAgentIdsList

      排除代理ID。

      示例： item1,item2

    • agentResultsList

      代理结果。

      示例： (nested array)

      • agentIdString

        代理ID。

        示例： lca-node01.example.com

      • agentNameString

        显示名称代理节点。

        示例： node01

      • healthyBoolean

        代理已通过预检检查。

        示例： true

      • checkResultsLinkedHashMap

        预检检查结果条目。

        示例： (nested object)

      • failReasonsList

        失败原因。

        示例： item1,item2

    • checkedAtString

      检查时间。

      示例： 2026-01-15T08:00:00Z

    • durationMsString

      时长预检运行时间，单位为毫秒。

      示例： 4800

  • totalInteger

    返回结果总数。

    示例： 5

  • limitInteger

    最大返回条目数。

    示例： 10

  • offsetInteger

    查询起始偏移量。

    示例： 20

请求地址

GET/api/v1/ota/plans/{planId}/preflight/history

/api/v1/ota/plans/{planId}/preflight/history

操作 ID

ListPreflightResults

永久链接

请求示例

curl -X GET '{host}/api/v1/ota/plans/{planId}/preflight/history' -H 'Authorization: Bearer {token}'

响应示例

200
{"items": [{"planId": "plan-a1b2c3d4-e5f6-7890-abcd-ef1234567890", "mode": "strict", "totalAgents": 20, "healthyAgents": 19, "unhealthyAgents": 1, "healthyPct": 95.0, "decision": "proceed", "excludedAgentIds": ["value"]}], "total": 5, "limit": 10, "offset": 20}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史