コンテンツにスキップ

1日あたりの可用率を一括取得¶

POST /api/v1/slo/availability/list

概要¶

現在の API Key が所属するワークスペース内の SLO について、1日あたりの可用率を一括で取得します。

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']

パラメータ補足説明¶

1回のリクエストで最大 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"
}