콘텐츠로 이동

일일 가용률 일괄 조회¶

POST /api/v1/slo/availability/list

개요¶

현재 API Key가 속한 워크스페이스 내 SLO의 일일 가용률을 일괄 조회합니다.

Body 요청 매개변수¶

매개변수명	유형	필수	설명
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']

매개변수 추가 설명¶

한 번에 최대 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"
}