批量获取每日可用率¶

POST /api/v1/slo/availability/list

概述¶

批量获取当前 API Key 所属工作空间内 SLO 的每日可用率。

Body 请求参数¶

参数名	类型	必选	说明
window	object		预留字段；当前 OpenAPI 实现不使用该字段计算可用率，仍按 startDate、endDate 和 timezone 查询
window.startTime	integer	Y
window.endTime	integer	Y
sloUUIDs	array	Y	SLO UUID 列表，最多 100 个允许为空: False
startDate	string	Y	开始业务日期，格式 YYYY-MM-DD，闭区间允许为空: False
endDate	string	Y	结束业务日期，格式 YYYY-MM-DD，闭区间允许为空: False
timezone	string	Y	IANA 时区，例如 Asia/Shanghai 允许为空: False
interval	string		聚合粒度，当前只支持 1d 允许为空: False 可选值: ['1d']

参数补充说明¶

当前接口虽然接受 window 字段，但不会按该窗口查询或在响应中返回窗口汇总。请使用必填的日期范围与时区参数。

单次最多查询 100 个 SLO，日期范围最多包含 90 个自然日。
interval 当前只支持 1d。
每个自然日按请求 timezone 划分，并使用该自然日实际秒数计算可用率。
无指标数据的日期返回 availability=null、hasData=false 和 level=unknown。
level 根据 SLO 的 goal/minGoal 返回 normal、warning、critical 或 unknown。

请求例子¶

curl 'https://openapi.guance.com/api/v1/slo/availability/list' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{"sloUUIDs":["monitor_xxx"],"startDate":"2026-05-03","endDate":"2026-07-31","timezone":"Asia/Shanghai","interval":"1d"}'

响应¶

{
    "code": 200,
    "content": {
        "data": [
            {
                "sloUUID": "monitor_xxx",
                "name": "Metrics",
                "status": 0,
                "goal": 99.9,
                "minGoal": 99.5,
                "tagInfo": [
                    {
                        "name": "site:cn1"
                    }
                ],
                "points": [
                    {
                        "date": "2026-07-31",
                        "availability": 99.98,
                        "level": "normal",
                        "hasData": true
                    }
                ]
            }
        ]
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "TRACE-XXXX"
}