@leaflow/sdk 0.0.0-dev.11.g7f2d603

package/dist/monitoring/v1/schema.d.ts

@@ -0,0 +1,2292 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/api/v1/incidents": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 列出告警
+         * @description `incident_status` 表示监控系统是否判定已恢复，`closed` 表示是否有人完成了处理。两者相互独立，可分别筛选。
+         */
+        get: operations["list-incidents"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/incidents/{incidentId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 查一条告警 */
+        get: operations["get-incident"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/incidents/{incidentId}/acknowledge": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 确认这条告警
+         * @description 同时会在监控系统中标记为已确认，便于其他渠道也能看到该告警已有人处理。
+         */
+        post: operations["acknowledge-incident"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/incidents/{incidentId}/assignee": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * 把这条告警交给谁，或者收回来
+         * @description `assignee_user_id` 留空即取消指派。
+         *
+         *     **这里不校验被指派的人在不在这个项目里**——那要问 IAM，而这个服务的准入还没接。
+         */
+        put: operations["assign-incident"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/incidents/{incidentId}/close": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 了结这条告警
+         * @description 了结的是**平台上的处理流程**，不是告警本身的状态：尚未恢复的告警也可以按「已接受的风险」了结，它在监控系统中仍为未恢复。
+         */
+        post: operations["close-incident"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/incidents/{incidentId}/comments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** 在时间线上写一条备注 */
+        post: operations["add-incident-comment"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/incidents/{incidentId}/following": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * 关注这条告警，或者取消关注
+         * @description 关注的是**自己**：操作者就是被加进关注列表的那个人。
+         */
+        put: operations["set-incident-following"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/incidents/{incidentId}/reopen": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** 重新打开一条已经了结的告警 */
+        post: operations["reopen-incident"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/incidents/{incidentId}/timeline": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 列出这条告警的时间线
+         * @description 游标翻页而不是偏移量：时间线是只增的，用偏移量翻页会在新记录写入时漏行和重行。
+         */
+        get: operations["list-incident-timeline"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/maintenance-windows": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 列出维护窗口 */
+        get: operations["list-maintenance-windows"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/maintenance-windows/{windowId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 查一个维护窗口 */
+        get: operations["get-maintenance-window"];
+        /**
+         * 开一个维护窗口，或者按同一个 id 覆盖它
+         * @description **创建即覆盖**：延长一个正在进行的窗口就是用同一个 id 再调一次。
+         *
+         *     窗口期内这些机器的问题不告警，也不扣 SLA 的可用率。`server_ids` 留空表示整个项目，包括窗口开着的时候新接进来的机器。
+         */
+        put: operations["put-maintenance-window"];
+        post?: never;
+        /**
+         * 撤掉一个维护窗口
+         * @description 立刻恢复告警，哪怕窗口还没到期。
+         */
+        delete: operations["delete-maintenance-window"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/overview": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 项目总览
+         * @description 项目下还没有任何机器时返回各项均为零的总览，而不是 404——空项目是一个正常状态。
+         */
+        get: operations["get-project-overview"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/servers/{serverId}/items": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 列出一台机器的监控项
+         * @description 原样返回采集到的监控项，不做筛选或重命名。哪些属于重要指标，由调用方依据监控项自带的标签自行判断。
+         */
+        get: operations["list-server-items"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/servers/{serverId}/metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 取一个监控项的时间序列
+         * @description `item_key` 是**前缀匹配**：按分区、按网卡发现出来的监控项 key 带参数（`vfs.fs.size[/var,pused]`），所以 `vfs.fs.size` 这一个请求就能画出每个挂载点一条线。
+         */
+        get: operations["get-server-metric"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/servers/{serverId}/resources": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 一台机器的硬件与接口 */
+        get: operations["get-server-resources"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/servers/{serverId}/snapshot": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 一台机器此刻的状态 */
+        get: operations["get-server-snapshot"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/top-items": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 某个指标最高的前几台 */
+        get: operations["list-project-top-items"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/servers": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 列出项目里的机器 */
+        get: operations["list-servers"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/servers/{serverId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 查一台机器的接入情况 */
+        get: operations["get-server"];
+        /**
+         * 把一台机器接入监控
+         * @description **同一个 server id 重复调用是幂等的**：参数一致时返回已接入的那台，不会重复创建监控主机，因此接入失败可以安全重试。
+         *
+         *     修改接入参数请改用 PATCH。本接口在参数不一致时会返回错误，不会更新已有配置。
+         *
+         *     响应中的 `tls_psk` **只返回这一次**，请及时保存；遗失后需要轮换。
+         */
+        put: operations["enable-server-monitoring"];
+        post?: never;
+        /**
+         * 删掉这台机器
+         * @description **不可逆**：监控主机、历史数据和这台机器名下的告警会一并删除。若只是想暂时停止采集，改用 /disable。
+         */
+        delete: operations["delete-server"];
+        options?: never;
+        head?: never;
+        /**
+         * 改一台机器的接入参数
+         * @description 只更新请求体中出现的字段。`address` 与 `address_kind` 必须一并提供：只改其中一个会得到互相矛盾的接入配置，该错误不会被报出，表现为 agent 连不上。
+         */
+        patch: operations["update-server"];
+        trace?: never;
+    };
+    "/api/v1/servers/{serverId}/disable": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 停止监控这台机器
+         * @description 可逆操作：监控主机保留，仅停止采集，历史数据不受影响。重新接入即可恢复采集。如需连同历史数据一并删除，改用 DELETE。
+         */
+        post: operations["disable-server-monitoring"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/servers/{serverId}/psk": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 换一把 agent 的 PSK
+         * @description 换完要同步改 agent 侧的配置，否则那台机器立刻失联。新密钥同样**只在这个响应里明文出现一次**。
+         */
+        post: operations["rotate-agent-psk"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/servers/{serverId}/web-checks/{checkId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 查一个网页检查 */
+        get: operations["get-web-check"];
+        /**
+         * 建一个网页检查，或者按同一个 id 覆盖它
+         * @description **创建即覆盖**：修改一个检查即用同一个 id 再次调用本接口，无需先判断它是否已存在。
+         */
+        put: operations["put-web-check"];
+        post?: never;
+        /**
+         * 删掉一个网页检查
+         * @description 同时删除监控系统中对应的检查任务和触发器，不会遗留永远无法恢复的告警。
+         */
+        delete: operations["delete-web-check"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/web-checks": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 列出网页检查 */
+        get: operations["list-web-checks"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/sli-report": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 查实测的达成情况
+         * @description SLI 是测出来的数，SLO 是定下来的目标——这里返回的是前者。
+         *
+         *     `server_id` 为空的那一行是项目整体。
+         */
+        get: operations["get-sli-report"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/slo": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 查这个项目的可用率目标
+         * @description 没定过就是 404，而不是一份默认目标：没承诺过和承诺了 99.9% 是两回事。
+         */
+        get: operations["get-slo"];
+        /**
+         * 定下这个项目的可用率目标，或者改它
+         * @description 一个项目一条 SLO，**创建即覆盖**。
+         *
+         *     `min_severity` 必须显式选：它决定什么算「不可用」，是这条承诺的一半内容。
+         */
+        put: operations["put-slo"];
+        post?: never;
+        /**
+         * 撤掉这个项目的可用率目标
+         * @description 同时移除监控系统中对应的服务树，此后不再统计可用率。
+         */
+        delete: operations["delete-slo"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        Error: {
+            code?: string;
+            message: string;
+            meta?: {
+                [key: string]: unknown;
+            };
+            /** Format: int64 */
+            status: number;
+        };
+        IncidentFollowerResource: {
+            display_name: string;
+            /** Format: date-time */
+            followed_at: string;
+            user_id: string;
+        };
+        MonitoringItemResource: {
+            /** @description last / avg / min / max 之类 */
+            aggregation_function: string;
+            /** Format: int64 */
+            evaluation_window_seconds: number;
+            item_id: string;
+            key: string;
+            name: string;
+            operator: string;
+            /**
+             * Format: double
+             * @description 只有 threshold_status 为 RESOLVED 时才有
+             */
+            threshold: number | null;
+            threshold_status: string;
+            /** @description 触发那一刻的值，原样存下来的 */
+            value: string;
+        };
+        TagResource: {
+            tag: string;
+            value: string;
+        };
+        IncidentResource: {
+            acknowledge_message: string;
+            acknowledged: boolean;
+            /** Format: date-time */
+            acknowledged_at: string | null;
+            acknowledged_by_display_name: string;
+            acknowledged_by_user_id: string;
+            /** Format: date-time */
+            assigned_at: string | null;
+            assignee_display_name: string;
+            assignee_user_id: string;
+            close_message: string;
+            close_reason: string;
+            /** Format: date-time */
+            closed_at: string | null;
+            closed_by_display_name: string;
+            closed_by_user_id: string;
+            /** Format: int64 */
+            duration_seconds: number;
+            followers: components["schemas"]["IncidentFollowerResource"][] | null;
+            host_connection: string;
+            host_display_name: string;
+            /** Format: uuid */
+            id: string;
+            /**
+             * @description 监控系统是否判定已恢复。它与是否有人了结这条告警是两件事
+             * @enum {string}
+             */
+            incident_status: "PROBLEM" | "RESOLVED";
+            items: components["schemas"]["MonitoringItemResource"][] | null;
+            name: string;
+            /** @description 触发器配的那行现场数据 */
+            operational_data: string;
+            /** Format: uuid */
+            project_id: string;
+            /** Format: date-time */
+            resolved_at: string | null;
+            resolved_trigger_expression: string;
+            /** Format: uuid */
+            server_id: string;
+            server_name: string;
+            /** @enum {string} */
+            severity: "NOT_CLASSIFIED" | "INFORMATION" | "WARNING" | "AVERAGE" | "HIGH" | "DISASTER";
+            /** Format: date-time */
+            started_at: string;
+            tags: components["schemas"]["TagResource"][] | null;
+            trigger_expression: string;
+            zabbix_event_id: string;
+        };
+        LengthAwarePageIncidentResource: {
+            /** @description 这一页的内容 */
+            items: components["schemas"]["IncidentResource"][];
+            /**
+             * Format: int64
+             * @description 这一页最多几条，回显请求里的值
+             */
+            limit: number;
+            /**
+             * Format: int64
+             * @description 跳过了多少条，回显请求里的值
+             */
+            offset: number;
+            /**
+             * Format: int64
+             * @description 命中的总条数，不只是这一页
+             */
+            total: number;
+        };
+        AcknowledgeIncidentRequestBody: {
+            /** @description 会一并写入监控系统的确认记录 */
+            message?: string;
+        };
+        AssignIncidentRequestBody: {
+            /** @description 不给就用 user id：时间线上要留一个当时的人名副本 */
+            assignee_display_name?: string;
+            assignee_user_id?: string;
+        };
+        CloseIncidentRequestBody: {
+            /** @description reason 为 OTHER 时必填，否则请求会被拒绝 */
+            message?: string;
+            /** @enum {string} */
+            reason: "RECOVERED" | "FIXED" | "FALSE_POSITIVE" | "DUPLICATE" | "NO_ACTION_REQUIRED" | "ACCEPTED_RISK" | "OTHER";
+        };
+        AddCommentRequestBody: {
+            message: string;
+        };
+        IncidentActivityResource: {
+            /** @enum {string} */
+            activity_type: "OPENED" | "RECOVERED" | "ACKNOWLEDGED" | "ASSIGNED" | "UNASSIGNED" | "FOLLOWER_ADDED" | "FOLLOWER_REMOVED" | "COMMENT" | "CLOSED" | "REOPENED";
+            actor_display_name: string;
+            /** @description 操作者；来源为 SYSTEM 或 ZABBIX 时为空 */
+            actor_user_id: string;
+            close_reason: string;
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            incident_id: string;
+            message: string;
+            /** Format: date-time */
+            occurred_at: string;
+            /** @enum {string} */
+            source: "SYSTEM" | "OPERATOR" | "ZABBIX";
+            subject_display_name: string;
+            /** @description 被指派 / 被取消关注的那个人 */
+            subject_user_id: string;
+        };
+        SetFollowingRequestBody: {
+            following: boolean;
+        };
+        CursorPageIncidentActivityResource: {
+            /** @description 这一页的内容 */
+            items: components["schemas"]["IncidentActivityResource"][];
+            /** @description 下一页的游标；为空表示已经到底 */
+            next_cursor: string;
+        };
+        MaintenancePeriodResource: {
+            /** Format: int64 */
+            duration_seconds: number;
+            /**
+             * Format: int64
+             * @description DAILY / WEEKLY：每 N 天 / 每 N 周
+             */
+            every: number;
+            /** @enum {string} */
+            kind: "ONCE" | "DAILY" | "WEEKLY";
+            /**
+             * Format: int64
+             * @description DAILY / WEEKLY：当天零点起的秒数，按窗口自己的时区算
+             */
+            start_time_seconds: number;
+            /**
+             * Format: date-time
+             * @description 只有 ONCE 有
+             */
+            starts_at: string | null;
+            /**
+             * Format: int64
+             * @description WEEKLY：星期几的位图，**周一是最低位**
+             */
+            weekdays: number;
+        };
+        MaintenanceWindowResource: {
+            /** Format: date-time */
+            active_since: string;
+            /** Format: date-time */
+            active_till: string;
+            description: string;
+            last_error: string;
+            name: string;
+            period: components["schemas"]["MaintenancePeriodResource"];
+            /** Format: uuid */
+            project_id: string;
+            /** @description 空表示**整个项目** */
+            server_ids: string[] | null;
+            /** @enum {string} */
+            sync_status: "PENDING" | "ACTIVE" | "FAILED" | "EXPIRED";
+            timezone: string;
+            /** Format: uuid */
+            window_id: string;
+        };
+        MaintenanceWindowListResponseBody: {
+            items: components["schemas"]["MaintenanceWindowResource"][] | null;
+        };
+        MaintenancePeriodRequest: {
+            /** Format: int64 */
+            duration_seconds?: number;
+            /**
+             * Format: int64
+             * @description DAILY / WEEKLY：每 N 天 / 每 N 周
+             */
+            every?: number;
+            /** @enum {string} */
+            kind: "ONCE" | "DAILY" | "WEEKLY";
+            /**
+             * Format: int64
+             * @description DAILY / WEEKLY：当天零点起的秒数，按窗口自己的时区算
+             */
+            start_time_seconds?: number;
+            /**
+             * Format: date-time
+             * @description 只有 ONCE 用得上
+             */
+            starts_at?: string;
+            /**
+             * Format: int64
+             * @description WEEKLY：星期几的位图，**周一是最低位**
+             */
+            weekdays?: number;
+        };
+        PutMaintenanceWindowRequestBody: {
+            /**
+             * Format: date-time
+             * @description 整条规则的生效区间起点
+             */
+            active_since: string;
+            /** Format: date-time */
+            active_till: string;
+            description?: string;
+            name: string;
+            period: components["schemas"]["MaintenancePeriodRequest"];
+            server_ids?: string[] | null;
+            /** @description IANA 名字，比如 Asia/Shanghai；空即用部署配的默认 */
+            timezone?: string;
+        };
+        CountResource: {
+            /** Format: int64 */
+            count: number;
+            key: string;
+        };
+        ProjectOverviewResource: {
+            /** Format: int64 */
+            monitored_servers: number;
+            problem_counts: components["schemas"]["CountResource"][] | null;
+            reachability_counts: components["schemas"]["CountResource"][] | null;
+            /** Format: int64 */
+            total_servers: number;
+        };
+        ItemResource: {
+            item_id: string;
+            key: string;
+            /** Format: date-time */
+            last_collected_at: string | null;
+            last_value: string;
+            name: string;
+            tags: components["schemas"]["TagResource"][] | null;
+            units: string;
+            /** @enum {string} */
+            value_type: "FLOAT" | "CHARACTER" | "LOG" | "UNSIGNED" | "TEXT";
+        };
+        ItemListResponseBody: {
+            items: components["schemas"]["ItemResource"][] | null;
+        };
+        MetricPointResource: {
+            /** Format: double */
+            max_value: number;
+            /** Format: double */
+            min_value: number;
+            /** Format: date-time */
+            timestamp: string;
+            /** Format: double */
+            value: number;
+        };
+        MetricSeriesResource: {
+            item_id: string;
+            item_key: string;
+            item_name: string;
+            points: components["schemas"]["MetricPointResource"][] | null;
+            units: string;
+        };
+        ItemThresholdResource: {
+            aggregation_function: string;
+            /** Format: int64 */
+            evaluation_window_seconds: number;
+            item_id: string;
+            operator: string;
+            severity: string;
+            /** Format: double */
+            threshold: number;
+            /** @description 图例上说明这条线是什么 */
+            trigger_name: string;
+        };
+        MetricResponseBody: {
+            downsampled: boolean;
+            /** Format: date-time */
+            effective_from: string;
+            /** Format: date-time */
+            effective_to: string;
+            /** @description 数据来自趋势表，每个点是一小时的聚合 */
+            from_trends: boolean;
+            series: components["schemas"]["MetricSeriesResource"][] | null;
+            thresholds: components["schemas"]["ItemThresholdResource"][] | null;
+            truncated: boolean;
+        };
+        HostInterfaceResource: {
+            available: boolean;
+            dns: string;
+            ip: string;
+            /** Format: int64 */
+            port: number;
+            use_ip: boolean;
+        };
+        ServerResourcesResource: {
+            interfaces: components["schemas"]["HostInterfaceResource"][] | null;
+            /** @description 自动采集的硬件与系统清单：CPU、内存、操作系统等 */
+            inventory: {
+                [key: string]: string;
+            };
+            tags: components["schemas"]["TagResource"][] | null;
+        };
+        SnapshotResource: {
+            agent_error: string;
+            /**
+             * @description AGENT_DOWN 是 agent 不通但机器还活着；UNREACHABLE 是连这一点都说不上
+             * @enum {string}
+             */
+            agent_reachability: "UNKNOWN" | "REACHABLE" | "AGENT_DOWN" | "UNREACHABLE";
+            /** Format: date-time */
+            last_collected_at: string | null;
+            monitoring_enabled: boolean;
+            problem_counts: components["schemas"]["CountResource"][] | null;
+        };
+        TopItemResource: {
+            item_key: string;
+            /** Format: uuid */
+            server_id: string;
+            units: string;
+            /** Format: double */
+            value: number;
+        };
+        TopItemListResponseBody: {
+            items: components["schemas"]["TopItemResource"][] | null;
+        };
+        ServerTemplateResource: {
+            configured_secret_parameters: string[] | null;
+            parameters: {
+                [key: string]: string;
+            };
+            template_key: string;
+            zabbix_template_id: string;
+            zabbix_template_name: string;
+        };
+        ServerResource: {
+            address: string;
+            /** @enum {string} */
+            address_kind: "ip" | "dns";
+            /** @enum {string} */
+            agent_mode: "PASSIVE" | "ACTIVE";
+            /** Format: int64 */
+            agent_port: number;
+            /** Format: date-time */
+            created_at: string;
+            description: string;
+            /** Format: uuid */
+            id: string;
+            last_error: string;
+            /**
+             * @description FAILED 时看 last_error
+             * @enum {string}
+             */
+            monitoring_status: "PENDING" | "ACTIVE" | "DISABLED" | "FAILED";
+            name: string;
+            /** Format: uuid */
+            project_id: string;
+            templates: components["schemas"]["ServerTemplateResource"][] | null;
+            /** Format: date-time */
+            updated_at: string;
+            /** @description agent 配置里的 Hostname 必须与它一致，主动式采集靠它认人 */
+            zabbix_host_name: string;
+        };
+        LengthAwarePageServerResource: {
+            /** @description 这一页的内容 */
+            items: components["schemas"]["ServerResource"][];
+            /**
+             * Format: int64
+             * @description 这一页最多几条，回显请求里的值
+             */
+            limit: number;
+            /**
+             * Format: int64
+             * @description 跳过了多少条，回显请求里的值
+             */
+            offset: number;
+            /**
+             * Format: int64
+             * @description 命中的总条数，不只是这一页
+             */
+            total: number;
+        };
+        TemplateBindingRequest: {
+            /** @description 模板自己声明的参数，密钥参数写明文，返回时只报名字 */
+            parameters?: {
+                [key: string]: string;
+            };
+            /** @enum {string} */
+            template_key: "LINUX" | "SYSTEMD" | "DOCKER" | "ICMP_PING" | "NGINX" | "PHP_FPM" | "WEBSITE_CERTIFICATE" | "WINDOWS" | "SMART" | "NVIDIA" | "PROXMOX_VE";
+        };
+        EnableMonitoringRequestBody: {
+            address: string;
+            /** @enum {string} */
+            address_kind: "ip" | "dns";
+            /**
+             * @description 空即被动式：它对 agent 侧配置要求最少
+             * @enum {string}
+             */
+            agent_mode?: "PASSIVE" | "ACTIVE";
+            /**
+             * Format: int64
+             * @description 0 表示用默认的 10050
+             */
+            agent_port?: number;
+            description?: string;
+            name: string;
+            template_bindings?: components["schemas"]["TemplateBindingRequest"][] | null;
+        };
+        EnrollmentResource: {
+            /** @description 含 PSK，与 tls_psk 一样只出现这一次 */
+            install_command: string;
+            install_script_url: string;
+            /** @description **只出现这一次** */
+            tls_psk: string;
+            tls_psk_identity: string;
+            zabbix_host_name: string;
+            /** @description agent 配置里的 Server / ServerActive */
+            zabbix_server_address: string;
+        };
+        ServerEnrollmentResponseBody: {
+            enrollment: components["schemas"]["EnrollmentResource"];
+            server: components["schemas"]["ServerResource"];
+        };
+        UpdateServerRequestBody: {
+            address?: string;
+            /**
+             * @description 要改地址就必须和 address 一起给
+             * @enum {string}
+             */
+            address_kind?: "ip" | "dns";
+            /**
+             * @description 改采集模式会把全部模板换成另一个变体
+             * @enum {string}
+             */
+            agent_mode?: "PASSIVE" | "ACTIVE";
+            /** Format: int64 */
+            agent_port?: number;
+            description?: string;
+            name?: string;
+            template_bindings?: components["schemas"]["TemplateBindingRequest"][];
+        };
+        WebCheckResultResource: {
+            /** Format: date-time */
+            checked_at: string;
+            error: string;
+            /**
+             * Format: int64
+             * @description 第几步失败的，从 1 数；healthy 时为 0
+             */
+            failed_step: number;
+            healthy: boolean;
+            /** Format: int64 */
+            response_code: number;
+            /** Format: double */
+            response_time_seconds: number;
+        };
+        WebCheckStepResource: {
+            /** @description 状态码表达式，比如 200 或者 200,301-302 */
+            expected_status_codes: string;
+            follow_redirects: boolean;
+            name: string;
+            required_pattern: string;
+            url: string;
+        };
+        WebCheckResource: {
+            /** Format: uuid */
+            check_id: string;
+            /** Format: int64 */
+            interval_seconds: number;
+            last_error: string;
+            /** Format: int64 */
+            response_time_threshold_seconds: number;
+            /** @description null 表示这个检查还一轮都没跑过。零值会把「还不知道」显示成「响应 0 秒、状态码 0」 */
+            result: components["schemas"]["WebCheckResultResource"] | null;
+            /** Format: int64 */
+            retries: number;
+            /** Format: uuid */
+            server_id: string;
+            steps: components["schemas"]["WebCheckStepResource"][] | null;
+            /** @enum {string} */
+            sync_status: "PENDING" | "ACTIVE" | "FAILED";
+            /** Format: int64 */
+            timeout_seconds: number;
+        };
+        WebCheckStepRequest: {
+            /** @description 状态码表达式，比如 200 或者 200,301-302；留空表示不检查状态码 */
+            expected_status_codes?: string;
+            follow_redirects?: boolean;
+            name: string;
+            /** @description 响应体里必须出现的字符串 */
+            required_pattern?: string;
+            url: string;
+        };
+        PutWebCheckRequestBody: {
+            /**
+             * Format: int64
+             * @description 0 表示用默认
+             */
+            interval_seconds?: number;
+            /**
+             * Format: int64
+             * @description 超过它算慢，0 表示不看响应时间
+             */
+            response_time_threshold_seconds?: number;
+            /** Format: int64 */
+            retries?: number;
+            steps: components["schemas"]["WebCheckStepRequest"][] | null;
+            /** Format: int64 */
+            timeout_seconds?: number;
+        };
+        WebCheckListResponseBody: {
+            items: components["schemas"]["WebCheckResource"][] | null;
+        };
+        SLIReportRowResource: {
+            /** Format: int64 */
+            downtime_seconds: number;
+            /**
+             * Format: int64
+             * @description 为负表示这个周期的额度已经超支
+             */
+            error_budget_seconds: number;
+            /**
+             * Format: int64
+             * @description 被计划内维护排除掉的那部分
+             */
+            excluded_downtime_seconds: number;
+            /** Format: date-time */
+            period_from: string;
+            /** Format: date-time */
+            period_to: string;
+            /** @description 空表示这一行是项目整体 */
+            server_id: string;
+            /** Format: double */
+            sli_percent: number;
+            /** Format: int64 */
+            uptime_seconds: number;
+        };
+        SLIReportResponseBody: {
+            rows: components["schemas"]["SLIReportRowResource"][] | null;
+        };
+        ScheduleWindowResource: {
+            /** Format: int64 */
+            end_time_seconds: number;
+            /** Format: int64 */
+            start_time_seconds: number;
+            /**
+             * Format: int64
+             * @description 星期几的位图，**周一是最低位**，与维护窗口同一套编码
+             */
+            weekdays: number;
+        };
+        SLOResource: {
+            /** Format: date-time */
+            effective_from: string;
+            last_error: string;
+            /** @enum {string} */
+            min_severity: "ANY" | "INFORMATION" | "WARNING" | "AVERAGE" | "HIGH" | "DISASTER";
+            name: string;
+            /** @enum {string} */
+            period: "DAILY" | "WEEKLY" | "MONTHLY" | "QUARTERLY" | "ANNUALLY";
+            /** Format: uuid */
+            project_id: string;
+            /** @description 空表示 7×24 全天候承诺 */
+            schedule: components["schemas"]["ScheduleWindowResource"][] | null;
+            /** Format: uuid */
+            slo_id: string;
+            /**
+             * Format: double
+             * @description 目标可用率，比如 99.9
+             */
+            slo_percent: number;
+            /** @enum {string} */
+            sync_status: "PENDING" | "ACTIVE" | "FAILED";
+            timezone: string;
+        };
+        ScheduleWindowRequest: {
+            /** Format: int64 */
+            end_time_seconds?: number;
+            /** Format: int64 */
+            start_time_seconds?: number;
+            /**
+             * Format: int64
+             * @description 星期几的位图，**周一是最低位**（1=周一 … 64=周日）
+             */
+            weekdays: number;
+        };
+        PutSLORequestBody: {
+            /** Format: date-time */
+            effective_from?: string;
+            /** @enum {string} */
+            min_severity: "ANY" | "INFORMATION" | "WARNING" | "AVERAGE" | "HIGH" | "DISASTER";
+            name: string;
+            /**
+             * @description 空即按月
+             * @enum {string}
+             */
+            period?: "DAILY" | "WEEKLY" | "MONTHLY" | "QUARTERLY" | "ANNUALLY";
+            schedule?: components["schemas"]["ScheduleWindowRequest"][] | null;
+            /** Format: uuid */
+            slo_id: string;
+            /**
+             * Format: double
+             * @description 目标可用率，比如 99.9；最多四位小数
+             */
+            slo_percent: number;
+            /** @description 决定统计周期的边界，即每个周期从哪一刻开始 */
+            timezone?: string;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    "list-incidents": {
+        parameters: {
+            query?: {
+                /** @description 这一页最多返回多少条 */
+                limit?: number;
+                /** @description 跳过多少条。要翻得更深请改用游标翻页的接口 */
+                offset?: number;
+                /** @description 只看某一台机器的 */
+                server_id?: string;
+                incident_status?: "PROBLEM" | "RESOLVED";
+                /** @description 按不低于该等级匹配，而非精确匹配 */
+                min_severity?: "NOT_CLASSIFIED" | "INFORMATION" | "WARNING" | "AVERAGE" | "HIGH" | "DISASTER";
+                started_after?: string;
+                started_before?: string;
+                /** @description 与 [active_from, active_to] **有交集**的告警，给指标图叠加故障区间要的是这个 */
+                active_from?: string;
+                active_to?: string;
+                /** @description 形如 key 或 key=value，可重复；多个标签之间是与关系 */
+                tag?: string[] | null;
+                assignee_user_id?: string;
+                /** @description 有没有人在这边把它处理完，与 incident_status 无关 */
+                closed?: "true" | "false";
+                acknowledged?: "true" | "false";
+                unassigned?: "true" | "false";
+                keyword?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LengthAwarePageIncidentResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-incident": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                incidentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IncidentResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "acknowledge-incident": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                incidentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AcknowledgeIncidentRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IncidentResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "assign-incident": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                incidentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AssignIncidentRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IncidentResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "close-incident": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                incidentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CloseIncidentRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IncidentResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "add-incident-comment": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                incidentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AddCommentRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IncidentActivityResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "set-incident-following": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                incidentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SetFollowingRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IncidentResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "reopen-incident": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                incidentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IncidentResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-incident-timeline": {
+        parameters: {
+            query?: {
+                limit?: number;
+                /** @description 上一页返回的 next_cursor，空即从头开始 */
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                incidentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CursorPageIncidentActivityResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-maintenance-windows": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MaintenanceWindowListResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-maintenance-window": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                windowId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MaintenanceWindowResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "put-maintenance-window": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                windowId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PutMaintenanceWindowRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MaintenanceWindowResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "delete-maintenance-window": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                windowId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description No Content */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-project-overview": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProjectOverviewResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-server-items": {
+        parameters: {
+            query?: {
+                /** @description 按 key 或名字模糊匹配 */
+                keyword?: string;
+                /** @description 形如 key 或 key=value，可重复。官方模板打好的 component 标签（cpu / memory / filesystem…）就是靠它筛 */
+                tag?: string[] | null;
+            };
+            header?: never;
+            path: {
+                serverId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ItemListResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-server-metric": {
+        parameters: {
+            query?: {
+                /** @description **前缀匹配**：vfs.fs.size 一次拿回每个挂载点一条线。与 item_id 至少给一个 */
+                item_key?: string;
+                item_id?: string;
+                /** @description 不给就是一小时前 */
+                from?: string;
+                to?: string;
+                /** @description 降采样的桶数，0 表示原样返回采集到的数据点 */
+                max_points?: number;
+                /** @description 顺带取这些监控项当前生效的阈值线 */
+                include_thresholds?: boolean;
+            };
+            header?: never;
+            path: {
+                serverId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MetricResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-server-resources": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                serverId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ServerResourcesResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-server-snapshot": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                serverId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SnapshotResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-project-top-items": {
+        parameters: {
+            query: {
+                kind: "CPU_UTILIZATION" | "MEMORY_UTILIZATION" | "ROOT_FILESYSTEM_USED";
+                /** @description 0 表示用默认 */
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TopItemListResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-servers": {
+        parameters: {
+            query?: {
+                /** @description 这一页最多返回多少条 */
+                limit?: number;
+                /** @description 跳过多少条。要翻得更深请改用游标翻页的接口 */
+                offset?: number;
+                /** @description 按名字或地址模糊匹配 */
+                keyword?: string;
+                monitoring_status?: "PENDING" | "ACTIVE" | "DISABLED" | "FAILED";
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LengthAwarePageServerResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-server": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                serverId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ServerResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "enable-server-monitoring": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                serverId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["EnableMonitoringRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ServerEnrollmentResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "delete-server": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                serverId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description No Content */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "update-server": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                serverId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateServerRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ServerResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "disable-server-monitoring": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                serverId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description No Content */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "rotate-agent-psk": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                serverId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EnrollmentResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-web-check": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                serverId: string;
+                checkId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebCheckResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "put-web-check": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                serverId: string;
+                checkId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PutWebCheckRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebCheckResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "delete-web-check": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                serverId: string;
+                checkId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description No Content */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-web-checks": {
+        parameters: {
+            query?: {
+                /** @description 只看某一台机器的检查；不给就是整个项目的 */
+                server_id?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebCheckListResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-sli-report": {
+        parameters: {
+            query?: {
+                from?: string;
+                to?: string;
+                /** @description 取最近 N 个完整周期，与 from/to 二选一 */
+                periods?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SLIReportResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-slo": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SLOResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "put-slo": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PutSLORequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SLOResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "delete-slo": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description No Content */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+}