Skip to content

Batch Retrieve Daily Availability


POST /api/v1/slo/availability/list

Overview

Batch retrieve the daily availability of SLOs in the workspace associated with the current API Key.

Body Request Parameters

Parameter Type Required Description
sloUUIDs array Y List of SLO UUIDs, up to 100 items
Nullable: False
startDate string Y Start business date, format YYYY-MM-DD, inclusive
Nullable: False
endDate string Y End business date, format YYYY-MM-DD, inclusive
Nullable: False
timezone string Y IANA timezone, e.g. Asia/Shanghai
Nullable: False
interval string Aggregation granularity, currently only supports 1d
Nullable: False
Optional values: ['1d']

Additional Notes on Parameters

  • A maximum of 100 SLOs can be queried in a single request, and the date range can cover up to 90 calendar days.
  • interval currently only supports 1d.
  • Each calendar day is divided according to the requested timezone, and availability is calculated based on the actual number of seconds in that calendar day.
  • For dates without metric data, the response returns availability=null, hasData=false, and level=unknown.
  • level returns normal, warning, critical, or unknown based on the SLO's goal/minGoal.

Request Example

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"}'

Response

{
    "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"
}

Feedback

Is this page helpful?