跳转到主要内容
ZStack
监控与采集相关接口/Grafana 仪表盘

检查仪表盘版本

检查客户端S预期版本匹配当前仪表盘版本阻止过期写入。

POST/api/v1/monitoring/dashboards/{dashboardId}/version-check

操作 ID

CheckDashboardVersion

起始版本

1.0.0

执行模式

同步

认证信息

需要认证

认证信息

调用该 API 时需要在请求头中携带以下认证信息。

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

application/json

路径参数

  • dashboardId
    String必填

    仪表盘ID。

请求体字段

  • expectedVersion
    Integer必填

    期望的版本号。

    示例： 5

响应状态

200 OK
200 OK

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

  • match
    Boolean

    匹配。

    示例： true

  • currentVersion
    Integer

    当前服务器端版本仪表盘。

    示例： 5

  • requestVersion
    Integer

    客户端提供预期版本。

    示例： 5

  • diffSummary
    String

    对比汇总。

    示例： 2 panels added, 1 removed

  • errorCode
    String

    LDAP错误分类编码。

    示例： INVALID_CONFIG