@leaflow/sdk 0.1.3 → 0.3.0

package/openapi/monitoring.yaml

@@ -1,6 +1,6 @@
 components:
   schemas:
-    AcknowledgeIncidentInputBody:
+    AcknowledgeIncidentRequestBody:
       additionalProperties: false
       properties:
         message:
@@ -8,7 +8,7 @@ components:
           maxLength: 2000
           type: string
       type: object
-    AddCommentInputBody:
+    AddCommentRequestBody:
       additionalProperties: false
       properties:
         message:
@@ -18,7 +18,7 @@ components:
       required:
         - message
       type: object
-    AssignIncidentInputBody:
+    AssignIncidentRequestBody:
       additionalProperties: false
       properties:
         assignee_display_name:
@@ -29,7 +29,7 @@ components:
           maxLength: 255
           type: string
       type: object
-    CloseIncidentInputBody:
+    CloseIncidentRequestBody:
       additionalProperties: false
       properties:
         message:
@@ -49,7 +49,7 @@ components:
       required:
         - reason
       type: object
-    CountView:
+    CountResource:
       additionalProperties: false
       properties:
         count:
@@ -61,7 +61,22 @@ components:
         - key
         - count
       type: object
-    EnableMonitoringInputBody:
+    CursorPageIncidentActivityResource:
+      additionalProperties: false
+      properties:
+        items:
+          description: 这一页的内容
+          items:
+            $ref: "#/components/schemas/IncidentActivityResource"
+          type: array
+        next_cursor:
+          description: 下一页的游标；为空表示已经到底
+          type: string
+      required:
+        - items
+        - next_cursor
+      type: object
+    EnableMonitoringRequestBody:
       additionalProperties: false
       properties:
         address:
@@ -93,7 +108,7 @@ components:
           type: string
         template_bindings:
           items:
-            $ref: "#/components/schemas/TemplateBindingInput"
+            $ref: "#/components/schemas/TemplateBindingRequest"
           type:
             - array
             - "null"
@@ -102,20 +117,14 @@ components:
         - address_kind
         - address
       type: object
-    EnableMonitoringOutputBody:
-      additionalProperties: false
-      properties:
-        enrollment:
-          $ref: "#/components/schemas/EnrollmentView"
-        server:
-          $ref: "#/components/schemas/ServerView"
-      required:
-        - server
-        - enrollment
-      type: object
-    EnrollmentView:
+    EnrollmentResource:
       additionalProperties: false
       properties:
+        install_command:
+          description: 含 PSK，与 tls_psk 一样只出现这一次
+          type: string
+        install_script_url:
+          type: string
         tls_psk:
           description: "**只出现这一次**"
           type: string
@@ -131,6 +140,8 @@ components:
         - zabbix_server_address
         - tls_psk_identity
         - tls_psk
+        - install_script_url
+        - install_command
       type: object
     Error:
       additionalProperties: false
@@ -149,44 +160,7 @@ components:
         - status
         - message
       type: object
-    GetMetricOutputBody:
-      additionalProperties: false
-      properties:
-        downsampled:
-          type: boolean
-        effective_from:
-          format: date-time
-          type: string
-        effective_to:
-          format: date-time
-          type: string
-        from_trends:
-          description: 数据来自趋势表，每个点是一小时的聚合
-          type: boolean
-        series:
-          items:
-            $ref: "#/components/schemas/MetricSeriesView"
-          type:
-            - array
-            - "null"
-        thresholds:
-          items:
-            $ref: "#/components/schemas/ItemThresholdView"
-          type:
-            - array
-            - "null"
-        truncated:
-          type: boolean
-      required:
-        - series
-        - from_trends
-        - truncated
-        - downsampled
-        - effective_from
-        - effective_to
-        - thresholds
-      type: object
-    HostInterfaceView:
+    HostInterfaceResource:
       additionalProperties: false
       properties:
         available:
@@ -207,7 +181,7 @@ components:
         - use_ip
         - available
       type: object
-    IncidentActivityView:
+    IncidentActivityResource:
       additionalProperties: false
       properties:
         activity_type:
@@ -265,7 +239,7 @@ components:
         - close_reason
         - occurred_at
       type: object
-    IncidentFollowerView:
+    IncidentFollowerResource:
       additionalProperties: false
       properties:
         display_name:
@@ -280,7 +254,7 @@ components:
         - display_name
         - followed_at
       type: object
-    IncidentView:
+    IncidentResource:
       additionalProperties: false
       properties:
         acknowledge_message:
@@ -323,7 +297,7 @@ components:
           type: integer
         followers:
           items:
-            $ref: "#/components/schemas/IncidentFollowerView"
+            $ref: "#/components/schemas/IncidentFollowerResource"
           type:
             - array
             - "null"
@@ -342,7 +316,7 @@ components:
           type: string
         items:
           items:
-            $ref: "#/components/schemas/MonitoringItemView"
+            $ref: "#/components/schemas/MonitoringItemResource"
           type:
             - array
             - "null"
@@ -380,7 +354,7 @@ components:
           type: string
         tags:
           items:
-            $ref: "#/components/schemas/TagView"
+            $ref: "#/components/schemas/TagResource"
           type:
             - array
             - "null"
@@ -422,36 +396,19 @@ components:
         - tags
         - followers
       type: object
-    ItemThresholdView:
+    ItemListResponseBody:
       additionalProperties: false
       properties:
-        aggregation_function:
-          type: string
-        evaluation_window_seconds:
-          format: int64
-          type: integer
-        item_id:
-          type: string
-        operator:
-          type: string
-        severity:
-          type: string
-        threshold:
-          format: double
-          type: number
-        trigger_name:
-          description: 图例上说明这条线是什么
-          type: string
+        items:
+          items:
+            $ref: "#/components/schemas/ItemResource"
+          type:
+            - array
+            - "null"
       required:
-        - item_id
-        - threshold
-        - operator
-        - severity
-        - trigger_name
-        - aggregation_function
-        - evaluation_window_seconds
+        - items
       type: object
-    ItemView:
+    ItemResource:
       additionalProperties: false
       properties:
         item_id:
@@ -469,7 +426,7 @@ components:
           type: string
         tags:
           items:
-            $ref: "#/components/schemas/TagView"
+            $ref: "#/components/schemas/TagResource"
           type:
             - array
             - "null"
@@ -493,90 +450,88 @@ components:
         - last_collected_at
         - tags
       type: object
-    ListIncidentsOutputBody:
+    ItemThresholdResource:
       additionalProperties: false
       properties:
-        items:
-          items:
-            $ref: "#/components/schemas/IncidentView"
-          type:
-            - array
-            - "null"
-        total:
+        aggregation_function:
+          type: string
+        evaluation_window_seconds:
           format: int64
           type: integer
+        item_id:
+          type: string
+        operator:
+          type: string
+        severity:
+          type: string
+        threshold:
+          format: double
+          type: number
+        trigger_name:
+          description: 图例上说明这条线是什么
+          type: string
       required:
-        - items
-        - total
-      type: object
-    ListItemsOutputBody:
-      additionalProperties: false
-      properties:
-        items:
-          items:
-            $ref: "#/components/schemas/ItemView"
-          type:
-            - array
-            - "null"
-      required:
-        - items
-      type: object
-    ListMaintenanceWindowsOutputBody:
-      additionalProperties: false
-      properties:
-        items:
-          items:
-            $ref: "#/components/schemas/MaintenanceWindowView"
-          type:
-            - array
-            - "null"
-      required:
-        - items
+        - item_id
+        - threshold
+        - operator
+        - severity
+        - trigger_name
+        - aggregation_function
+        - evaluation_window_seconds
       type: object
-    ListServersOutputBody:
+    LengthAwarePageIncidentResource:
       additionalProperties: false
       properties:
         items:
+          description: 这一页的内容
           items:
-            $ref: "#/components/schemas/ServerView"
-          type:
-            - array
-            - "null"
+            $ref: "#/components/schemas/IncidentResource"
+          type: array
+        limit:
+          description: 这一页最多几条，回显请求里的值
+          format: int64
+          type: integer
+        offset:
+          description: 跳过了多少条，回显请求里的值
+          format: int64
+          type: integer
         total:
+          description: 命中的总条数，不只是这一页
           format: int64
           type: integer
       required:
         - items
         - total
+        - limit
+        - offset
       type: object
-    ListTimelineOutputBody:
+    LengthAwarePageServerResource:
       additionalProperties: false
       properties:
         items:
+          description: 这一页的内容
           items:
-            $ref: "#/components/schemas/IncidentActivityView"
-          type:
-            - array
-            - "null"
-        next_cursor:
-          type: string
-      required:
-        - items
-        - next_cursor
-      type: object
-    ListWebChecksOutputBody:
-      additionalProperties: false
-      properties:
-        items:
-          items:
-            $ref: "#/components/schemas/WebCheckView"
-          type:
-            - array
-            - "null"
+            $ref: "#/components/schemas/ServerResource"
+          type: array
+        limit:
+          description: 这一页最多几条，回显请求里的值
+          format: int64
+          type: integer
+        offset:
+          description: 跳过了多少条，回显请求里的值
+          format: int64
+          type: integer
+        total:
+          description: 命中的总条数，不只是这一页
+          format: int64
+          type: integer
       required:
         - items
+        - total
+        - limit
+        - offset
       type: object
-    MaintenancePeriodInput:
+    MaintenancePeriodRequest:
       additionalProperties: false
       properties:
         duration_seconds:
@@ -613,7 +568,7 @@ components:
       required:
         - kind
       type: object
-    MaintenancePeriodView:
+    MaintenancePeriodResource:
       additionalProperties: false
       properties:
         duration_seconds:
@@ -651,7 +606,19 @@ components:
         - every
         - weekdays
       type: object
-    MaintenanceWindowView:
+    MaintenanceWindowListResponseBody:
+      additionalProperties: false
+      properties:
+        items:
+          items:
+            $ref: "#/components/schemas/MaintenanceWindowResource"
+          type:
+            - array
+            - "null"
+      required:
+        - items
+      type: object
+    MaintenanceWindowResource:
       additionalProperties: false
       properties:
         active_since:
@@ -667,7 +634,7 @@ components:
         name:
           type: string
         period:
-          $ref: "#/components/schemas/MaintenancePeriodView"
+          $ref: "#/components/schemas/MaintenancePeriodResource"
         project_id:
           format: uuid
           type: string
@@ -703,7 +670,7 @@ components:
         - sync_status
         - last_error
       type: object
-    MetricPointView:
+    MetricPointResource:
       additionalProperties: false
       properties:
         max_value:
@@ -724,7 +691,44 @@ components:
         - min_value
         - max_value
       type: object
-    MetricSeriesView:
+    MetricResponseBody:
+      additionalProperties: false
+      properties:
+        downsampled:
+          type: boolean
+        effective_from:
+          format: date-time
+          type: string
+        effective_to:
+          format: date-time
+          type: string
+        from_trends:
+          description: 数据来自趋势表，每个点是一小时的聚合
+          type: boolean
+        series:
+          items:
+            $ref: "#/components/schemas/MetricSeriesResource"
+          type:
+            - array
+            - "null"
+        thresholds:
+          items:
+            $ref: "#/components/schemas/ItemThresholdResource"
+          type:
+            - array
+            - "null"
+        truncated:
+          type: boolean
+      required:
+        - series
+        - from_trends
+        - truncated
+        - downsampled
+        - effective_from
+        - effective_to
+        - thresholds
+      type: object
+    MetricSeriesResource:
       additionalProperties: false
       properties:
         item_id:
@@ -735,7 +739,7 @@ components:
           type: string
         points:
           items:
-            $ref: "#/components/schemas/MetricPointView"
+            $ref: "#/components/schemas/MetricPointResource"
           type:
             - array
             - "null"
@@ -748,7 +752,7 @@ components:
         - units
         - points
       type: object
-    MonitoringItemView:
+    MonitoringItemResource:
       additionalProperties: false
       properties:
         aggregation_function:
@@ -787,7 +791,7 @@ components:
         - aggregation_function
         - evaluation_window_seconds
       type: object
-    ProjectOverviewView:
+    ProjectOverviewResource:
       additionalProperties: false
       properties:
         monitored_servers:
@@ -795,13 +799,13 @@ components:
           type: integer
         problem_counts:
           items:
-            $ref: "#/components/schemas/CountView"
+            $ref: "#/components/schemas/CountResource"
           type:
             - array
             - "null"
         reachability_counts:
           items:
-            $ref: "#/components/schemas/CountView"
+            $ref: "#/components/schemas/CountResource"
           type:
             - array
             - "null"
@@ -814,7 +818,7 @@ components:
         - reachability_counts
         - problem_counts
       type: object
-    PutMaintenanceWindowInputBody:
+    PutMaintenanceWindowRequestBody:
       additionalProperties: false
       properties:
         active_since:
@@ -832,7 +836,7 @@ components:
           minLength: 1
           type: string
         period:
-          $ref: "#/components/schemas/MaintenancePeriodInput"
+          $ref: "#/components/schemas/MaintenancePeriodRequest"
         server_ids:
           items:
             type: string
@@ -849,7 +853,7 @@ components:
         - active_till
         - period
       type: object
-    PutSLOInputBody:
+    PutSLORequestBody:
       additionalProperties: false
       properties:
         effective_from:
@@ -879,7 +883,7 @@ components:
           type: string
         schedule:
           items:
-            $ref: "#/components/schemas/ScheduleWindowInput"
+            $ref: "#/components/schemas/ScheduleWindowRequest"
           type:
             - array
             - "null"
@@ -902,7 +906,7 @@ components:
         - slo_percent
         - min_severity
       type: object
-    PutWebCheckInputBody:
+    PutWebCheckRequestBody:
       additionalProperties: false
       properties:
         interval_seconds:
@@ -921,7 +925,7 @@ components:
           type: integer
         steps:
           items:
-            $ref: "#/components/schemas/WebCheckStepInput"
+            $ref: "#/components/schemas/WebCheckStepRequest"
           minItems: 1
           type:
             - array
@@ -933,7 +937,19 @@ components:
       required:
         - steps
       type: object
-    SLIReportRowView:
+    SLIReportResponseBody:
+      additionalProperties: false
+      properties:
+        rows:
+          items:
+            $ref: "#/components/schemas/SLIReportRowResource"
+          type:
+            - array
+            - "null"
+      required:
+        - rows
+      type: object
+    SLIReportRowResource:
       additionalProperties: false
       properties:
         downtime_seconds:
@@ -972,7 +988,7 @@ components:
         - error_budget_seconds
         - excluded_downtime_seconds
       type: object
-    SLOView:
+    SLOResource:
       additionalProperties: false
       properties:
         effective_from:
@@ -1005,7 +1021,7 @@ components:
         schedule:
           description: 空表示 7×24 全天候承诺
           items:
-            $ref: "#/components/schemas/ScheduleWindowView"
+            $ref: "#/components/schemas/ScheduleWindowResource"
           type:
             - array
             - "null"
@@ -1037,7 +1053,7 @@ components:
         - sync_status
         - last_error
       type: object
-    ScheduleWindowInput:
+    ScheduleWindowRequest:
       additionalProperties: false
       properties:
         end_time_seconds:
@@ -1059,7 +1075,7 @@ components:
       required:
         - weekdays
       type: object
-    ScheduleWindowView:
+    ScheduleWindowResource:
       additionalProperties: false
       properties:
         end_time_seconds:
@@ -1077,58 +1093,18 @@ components:
         - start_time_seconds
         - end_time_seconds
       type: object
-    ServerResourcesView:
+    ServerEnrollmentResponseBody:
       additionalProperties: false
       properties:
-        interfaces:
-          items:
-            $ref: "#/components/schemas/HostInterfaceView"
-          type:
-            - array
-            - "null"
-        inventory:
-          additionalProperties:
-            type: string
-          description: 自动采集的硬件与系统清单：CPU、内存、操作系统等
-          type: object
-        tags:
-          items:
-            $ref: "#/components/schemas/TagView"
-          type:
-            - array
-            - "null"
-      required:
-        - inventory
-        - interfaces
-        - tags
-      type: object
-    ServerTemplateView:
-      additionalProperties: false
-      properties:
-        configured_secret_parameters:
-          items:
-            type: string
-          type:
-            - array
-            - "null"
-        parameters:
-          additionalProperties:
-            type: string
-          type: object
-        template_key:
-          type: string
-        zabbix_template_id:
-          type: string
-        zabbix_template_name:
-          type: string
+        enrollment:
+          $ref: "#/components/schemas/EnrollmentResource"
+        server:
+          $ref: "#/components/schemas/ServerResource"
       required:
-        - template_key
-        - zabbix_template_id
-        - zabbix_template_name
-        - parameters
-        - configured_secret_parameters
+        - server
+        - enrollment
       type: object
-    ServerView:
+    ServerResource:
       additionalProperties: false
       properties:
         address:
@@ -1171,7 +1147,7 @@ components:
           type: string
         templates:
           items:
-            $ref: "#/components/schemas/ServerTemplateView"
+            $ref: "#/components/schemas/ServerTemplateResource"
           type:
             - array
             - "null"
@@ -1197,7 +1173,58 @@ components:
         - created_at
         - updated_at
       type: object
-    SetFollowingInputBody:
+    ServerResourcesResource:
+      additionalProperties: false
+      properties:
+        interfaces:
+          items:
+            $ref: "#/components/schemas/HostInterfaceResource"
+          type:
+            - array
+            - "null"
+        inventory:
+          additionalProperties:
+            type: string
+          description: 自动采集的硬件与系统清单：CPU、内存、操作系统等
+          type: object
+        tags:
+          items:
+            $ref: "#/components/schemas/TagResource"
+          type:
+            - array
+            - "null"
+      required:
+        - inventory
+        - interfaces
+        - tags
+      type: object
+    ServerTemplateResource:
+      additionalProperties: false
+      properties:
+        configured_secret_parameters:
+          items:
+            type: string
+          type:
+            - array
+            - "null"
+        parameters:
+          additionalProperties:
+            type: string
+          type: object
+        template_key:
+          type: string
+        zabbix_template_id:
+          type: string
+        zabbix_template_name:
+          type: string
+      required:
+        - template_key
+        - zabbix_template_id
+        - zabbix_template_name
+        - parameters
+        - configured_secret_parameters
+      type: object
+    SetFollowingRequestBody:
       additionalProperties: false
       properties:
         following:
@@ -1205,19 +1232,7 @@ components:
       required:
         - following
       type: object
-    SliReportOutputBody:
-      additionalProperties: false
-      properties:
-        rows:
-          items:
-            $ref: "#/components/schemas/SLIReportRowView"
-          type:
-            - array
-            - "null"
-      required:
-        - rows
-      type: object
-    SnapshotView:
+    SnapshotResource:
       additionalProperties: false
       properties:
         agent_error:
@@ -1239,7 +1254,7 @@ components:
           type: boolean
         problem_counts:
           items:
-            $ref: "#/components/schemas/CountView"
+            $ref: "#/components/schemas/CountResource"
           type:
             - array
             - "null"
@@ -1250,7 +1265,7 @@ components:
         - last_collected_at
         - problem_counts
       type: object
-    TagView:
+    TagResource:
       additionalProperties: false
       properties:
         tag:
@@ -1261,7 +1276,7 @@ components:
         - tag
         - value
       type: object
-    TemplateBindingInput:
+    TemplateBindingRequest:
       additionalProperties: false
       properties:
         parameters:
@@ -1286,7 +1301,19 @@ components:
       required:
         - template_key
       type: object
-    TopItemView:
+    TopItemListResponseBody:
+      additionalProperties: false
+      properties:
+        items:
+          items:
+            $ref: "#/components/schemas/TopItemResource"
+          type:
+            - array
+            - "null"
+      required:
+        - items
+      type: object
+    TopItemResource:
       additionalProperties: false
       properties:
         item_key:
@@ -1305,19 +1332,7 @@ components:
         - units
         - value
       type: object
-    TopItemsOutputBody:
-      additionalProperties: false
-      properties:
-        items:
-          items:
-            $ref: "#/components/schemas/TopItemView"
-          type:
-            - array
-            - "null"
-      required:
-        - items
-      type: object
-    UpdateServerInputBody:
+    UpdateServerRequestBody:
       additionalProperties: false
       properties:
         address:
@@ -1349,10 +1364,71 @@ components:
           type: string
         template_bindings:
           items:
-            $ref: "#/components/schemas/TemplateBindingInput"
+            $ref: "#/components/schemas/TemplateBindingRequest"
           type: array
       type: object
-    WebCheckResultView:
+    WebCheckListResponseBody:
+      additionalProperties: false
+      properties:
+        items:
+          items:
+            $ref: "#/components/schemas/WebCheckResource"
+          type:
+            - array
+            - "null"
+      required:
+        - items
+      type: object
+    WebCheckResource:
+      additionalProperties: false
+      properties:
+        check_id:
+          format: uuid
+          type: string
+        interval_seconds:
+          format: int64
+          type: integer
+        last_error:
+          type: string
+        response_time_threshold_seconds:
+          format: int64
+          type: integer
+        result:
+          $ref: "#/components/schemas/WebCheckResultResource"
+        retries:
+          format: int64
+          type: integer
+        server_id:
+          format: uuid
+          type: string
+        steps:
+          items:
+            $ref: "#/components/schemas/WebCheckStepResource"
+          type:
+            - array
+            - "null"
+        sync_status:
+          enum:
+            - PENDING
+            - ACTIVE
+            - FAILED
+          type: string
+        timeout_seconds:
+          format: int64
+          type: integer
+      required:
+        - check_id
+        - server_id
+        - steps
+        - interval_seconds
+        - timeout_seconds
+        - retries
+        - response_time_threshold_seconds
+        - sync_status
+        - last_error
+        - result
+      type: object
+    WebCheckResultResource:
       additionalProperties: false
       properties:
         checked_at:
@@ -1380,7 +1456,7 @@ components:
         - response_time_seconds
         - checked_at
       type: object
-    WebCheckStepInput:
+    WebCheckStepRequest:
       additionalProperties: false
       properties:
         expected_status_codes:
@@ -1403,7 +1479,7 @@ components:
         - name
         - url
       type: object
-    WebCheckStepView:
+    WebCheckStepResource:
       additionalProperties: false
       properties:
         expected_status_codes:
@@ -1424,55 +1500,12 @@ components:
         - required_pattern
         - follow_redirects
       type: object
-    WebCheckView:
-      additionalProperties: false
-      properties:
-        check_id:
-          format: uuid
-          type: string
-        interval_seconds:
-          format: int64
-          type: integer
-        last_error:
-          type: string
-        response_time_threshold_seconds:
-          format: int64
-          type: integer
-        result:
-          $ref: "#/components/schemas/WebCheckResultView"
-        retries:
-          format: int64
-          type: integer
-        server_id:
-          format: uuid
-          type: string
-        steps:
-          items:
-            $ref: "#/components/schemas/WebCheckStepView"
-          type:
-            - array
-            - "null"
-        sync_status:
-          enum:
-            - PENDING
-            - ACTIVE
-            - FAILED
-          type: string
-        timeout_seconds:
-          format: int64
-          type: integer
-      required:
-        - check_id
-        - server_id
-        - steps
-        - interval_seconds
-        - timeout_seconds
-        - retries
-        - response_time_threshold_seconds
-        - sync_status
-        - last_error
-        - result
-      type: object
+  securitySchemes:
+    bearerAuth:
+      bearerFormat: JWT
+      description: 项目令牌。先在 auth.leaflow.net 登录拿到账号令牌，再用它向 IAM 换取项目令牌（POST /api/v1/projects/{projectId}/token）——一张项目令牌同时说明当前用户和当前项目。
+      scheme: bearer
+      type: http
 info:
   description: |-
     用户自己项目里的监控：接入机器、看指标、处理告警、开维护窗口、定可用率目标。
@@ -1502,31 +1535,25 @@ paths:
       description: "`incident_status` 表示监控系统是否判定已恢复，`closed` 表示是否有人完成了处理。两者相互独立，可分别筛选。"
       operationId: list-incidents
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
-        - description: 这一页最多返回多少条，0 表示用默认值
+        - description: 这一页最多返回多少条
           explode: false
           in: query
           name: limit
           schema:
             default: 50
-            description: 这一页最多返回多少条，0 表示用默认值
+            description: 这一页最多返回多少条
             format: int64
-            maximum: 500
-            minimum: 0
+            maximum: 200
+            minimum: 1
             type: integer
-        - description: 跳过多少条
+        - description: 跳过多少条。要翻得更深请改用游标翻页的接口
           explode: false
           in: query
           name: offset
           schema:
-            description: 跳过多少条
+            description: 跳过多少条。要翻得更深请改用游标翻页的接口
             format: int64
+            maximum: 10000
             minimum: 0
             type: integer
         - description: 只看某一台机器的
@@ -1637,7 +1664,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListIncidentsOutputBody"
+                $ref: "#/components/schemas/LengthAwarePageIncidentResource"
           description: OK
         default:
           content:
@@ -1652,13 +1679,6 @@ paths:
     get:
       operationId: get-incident
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: incidentId
           required: true
@@ -1670,7 +1690,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/IncidentView"
+                $ref: "#/components/schemas/IncidentResource"
           description: OK
         default:
           content:
@@ -1686,13 +1706,6 @@ paths:
       description: 同时会在监控系统中标记为已确认，便于其他渠道也能看到该告警已有人处理。
       operationId: acknowledge-incident
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: incidentId
           required: true
@@ -1703,14 +1716,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/AcknowledgeIncidentInputBody"
+              $ref: "#/components/schemas/AcknowledgeIncidentRequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/IncidentView"
+                $ref: "#/components/schemas/IncidentResource"
           description: OK
         default:
           content:
@@ -1729,13 +1742,6 @@ paths:
         **这里不校验被指派的人在不在这个项目里**——那要问 IAM，而这个服务的准入还没接。
       operationId: assign-incident
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: incidentId
           required: true
@@ -1746,14 +1752,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/AssignIncidentInputBody"
+              $ref: "#/components/schemas/AssignIncidentRequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/IncidentView"
+                $ref: "#/components/schemas/IncidentResource"
           description: OK
         default:
           content:
@@ -1769,13 +1775,6 @@ paths:
       description: 了结的是**平台上的处理流程**，不是告警本身的状态：尚未恢复的告警也可以按「已接受的风险」了结，它在监控系统中仍为未恢复。
       operationId: close-incident
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: incidentId
           required: true
@@ -1786,14 +1785,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/CloseIncidentInputBody"
+              $ref: "#/components/schemas/CloseIncidentRequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/IncidentView"
+                $ref: "#/components/schemas/IncidentResource"
           description: OK
         default:
           content:
@@ -1808,13 +1807,6 @@ paths:
     post:
       operationId: add-incident-comment
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: incidentId
           required: true
@@ -1825,14 +1817,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/AddCommentInputBody"
+              $ref: "#/components/schemas/AddCommentRequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/IncidentActivityView"
+                $ref: "#/components/schemas/IncidentActivityResource"
           description: OK
         default:
           content:
@@ -1848,13 +1840,6 @@ paths:
       description: 关注的是**自己**：操作者就是被加进关注列表的那个人。
       operationId: set-incident-following
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: incidentId
           required: true
@@ -1865,14 +1850,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/SetFollowingInputBody"
+              $ref: "#/components/schemas/SetFollowingRequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/IncidentView"
+                $ref: "#/components/schemas/IncidentResource"
           description: OK
         default:
           content:
@@ -1887,13 +1872,6 @@ paths:
     post:
       operationId: reopen-incident
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: incidentId
           required: true
@@ -1905,7 +1883,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/IncidentView"
+                $ref: "#/components/schemas/IncidentResource"
           description: OK
         default:
           content:
@@ -1921,13 +1899,6 @@ paths:
       description: 游标翻页而不是偏移量：时间线是只增的，用偏移量翻页会在新记录写入时漏行和重行。
       operationId: list-incident-timeline
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: incidentId
           required: true
@@ -1955,7 +1926,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListTimelineOutputBody"
+                $ref: "#/components/schemas/CursorPageIncidentActivityResource"
           description: OK
         default:
           content:
@@ -1969,20 +1940,12 @@ paths:
   /api/v1/maintenance-windows:
     get:
       operationId: list-maintenance-windows
-      parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListMaintenanceWindowsOutputBody"
+                $ref: "#/components/schemas/MaintenanceWindowListResponseBody"
           description: OK
         default:
           content:
@@ -1998,13 +1961,6 @@ paths:
       description: 立刻恢复告警，哪怕窗口还没到期。
       operationId: delete-maintenance-window
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: windowId
           required: true
@@ -2026,13 +1982,6 @@ paths:
     get:
       operationId: get-maintenance-window
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: windowId
           required: true
@@ -2044,7 +1993,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/MaintenanceWindowView"
+                $ref: "#/components/schemas/MaintenanceWindowResource"
           description: OK
         default:
           content:
@@ -2062,13 +2011,6 @@ paths:
         窗口期内这些机器的问题不告警，也不扣 SLA 的可用率。`server_ids` 留空表示整个项目，包括窗口开着的时候新接进来的机器。
       operationId: put-maintenance-window
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: windowId
           required: true
@@ -2079,14 +2021,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/PutMaintenanceWindowInputBody"
+              $ref: "#/components/schemas/PutMaintenanceWindowRequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/MaintenanceWindowView"
+                $ref: "#/components/schemas/MaintenanceWindowResource"
           description: OK
         default:
           content:
@@ -2101,20 +2043,12 @@ paths:
     get:
       description: 项目下还没有任何机器时返回各项均为零的总览，而不是 404——空项目是一个正常状态。
       operationId: get-project-overview
-      parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ProjectOverviewView"
+                $ref: "#/components/schemas/ProjectOverviewResource"
           description: OK
         default:
           content:
@@ -2129,31 +2063,25 @@ paths:
     get:
       operationId: list-servers
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
-        - description: 这一页最多返回多少条，0 表示用默认值
+        - description: 这一页最多返回多少条
           explode: false
           in: query
           name: limit
           schema:
             default: 50
-            description: 这一页最多返回多少条，0 表示用默认值
+            description: 这一页最多返回多少条
             format: int64
-            maximum: 500
-            minimum: 0
+            maximum: 200
+            minimum: 1
             type: integer
-        - description: 跳过多少条
+        - description: 跳过多少条。要翻得更深请改用游标翻页的接口
           explode: false
           in: query
           name: offset
           schema:
-            description: 跳过多少条
+            description: 跳过多少条。要翻得更深请改用游标翻页的接口
             format: int64
+            maximum: 10000
             minimum: 0
             type: integer
         - description: 按名字或地址模糊匹配
@@ -2179,7 +2107,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListServersOutputBody"
+                $ref: "#/components/schemas/LengthAwarePageServerResource"
           description: OK
         default:
           content:
@@ -2195,13 +2123,6 @@ paths:
       description: "**不可逆**：监控主机、历史数据和这台机器名下的告警会一并删除。若只是想暂时停止采集，改用 /disable。"
       operationId: delete-server
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: serverId
           required: true
@@ -2223,13 +2144,6 @@ paths:
     get:
       operationId: get-server
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: serverId
           required: true
@@ -2241,7 +2155,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ServerView"
+                $ref: "#/components/schemas/ServerResource"
           description: OK
         default:
           content:
@@ -2256,13 +2170,6 @@ paths:
       description: 只更新请求体中出现的字段。`address` 与 `address_kind` 必须一并提供：只改其中一个会得到互相矛盾的接入配置，该错误不会被报出，表现为 agent 连不上。
       operationId: update-server
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: serverId
           required: true
@@ -2273,14 +2180,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/UpdateServerInputBody"
+              $ref: "#/components/schemas/UpdateServerRequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ServerView"
+                $ref: "#/components/schemas/ServerResource"
           description: OK
         default:
           content:
@@ -2300,13 +2207,6 @@ paths:
         响应中的 `tls_psk` **只返回这一次**，请及时保存；遗失后需要轮换。
       operationId: enable-server-monitoring
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: serverId
           required: true
@@ -2317,14 +2217,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/EnableMonitoringInputBody"
+              $ref: "#/components/schemas/EnableMonitoringRequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/EnableMonitoringOutputBody"
+                $ref: "#/components/schemas/ServerEnrollmentResponseBody"
           description: OK
         default:
           content:
@@ -2340,13 +2240,6 @@ paths:
       description: 可逆操作：监控主机保留，仅停止采集，历史数据不受影响。重新接入即可恢复采集。如需连同历史数据一并删除，改用 DELETE。
       operationId: disable-server-monitoring
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: serverId
           required: true
@@ -2370,13 +2263,6 @@ paths:
       description: 原样返回采集到的监控项，不做筛选或重命名。哪些属于重要指标，由调用方依据监控项自带的标签自行判断。
       operationId: list-server-items
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: serverId
           required: true
@@ -2407,7 +2293,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListItemsOutputBody"
+                $ref: "#/components/schemas/ItemListResponseBody"
           description: OK
         default:
           content:
@@ -2423,13 +2309,6 @@ paths:
       description: "`item_key` 是**前缀匹配**：按分区、按网卡发现出来的监控项 key 带参数（`vfs.fs.size[/var,pused]`），所以 `vfs.fs.size` 这一个请求就能画出每个挂载点一条线。"
       operationId: get-server-metric
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: serverId
           required: true
@@ -2483,7 +2362,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/GetMetricOutputBody"
+                $ref: "#/components/schemas/MetricResponseBody"
           description: OK
         default:
           content:
@@ -2499,13 +2378,6 @@ paths:
       description: 换完要同步改 agent 侧的配置，否则那台机器立刻失联。新密钥同样**只在这个响应里明文出现一次**。
       operationId: rotate-agent-psk
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: serverId
           required: true
@@ -2517,7 +2389,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/EnrollmentView"
+                $ref: "#/components/schemas/EnrollmentResource"
           description: OK
         default:
           content:
@@ -2532,13 +2404,6 @@ paths:
     get:
       operationId: get-server-resources
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: serverId
           required: true
@@ -2550,7 +2415,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ServerResourcesView"
+                $ref: "#/components/schemas/ServerResourcesResource"
           description: OK
         default:
           content:
@@ -2565,13 +2430,6 @@ paths:
     get:
       operationId: get-server-snapshot
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: serverId
           required: true
@@ -2583,7 +2441,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/SnapshotView"
+                $ref: "#/components/schemas/SnapshotResource"
           description: OK
         default:
           content:
@@ -2599,13 +2457,6 @@ paths:
       description: 同时删除监控系统中对应的检查任务和触发器，不会遗留永远无法恢复的告警。
       operationId: delete-web-check
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: serverId
           required: true
@@ -2633,13 +2484,6 @@ paths:
     get:
       operationId: get-web-check
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: serverId
           required: true
@@ -2657,7 +2501,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/WebCheckView"
+                $ref: "#/components/schemas/WebCheckResource"
           description: OK
         default:
           content:
@@ -2672,13 +2516,6 @@ paths:
       description: "**创建即覆盖**：修改一个检查即用同一个 id 再次调用本接口，无需先判断它是否已存在。"
       operationId: put-web-check
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - in: path
           name: serverId
           required: true
@@ -2695,14 +2532,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/PutWebCheckInputBody"
+              $ref: "#/components/schemas/PutWebCheckRequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/WebCheckView"
+                $ref: "#/components/schemas/WebCheckResource"
           description: OK
         default:
           content:
@@ -2721,13 +2558,6 @@ paths:
         `server_id` 为空的那一行是项目整体。
       operationId: get-sli-report
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - explode: false
           in: query
           name: from
@@ -2755,7 +2585,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/SliReportOutputBody"
+                $ref: "#/components/schemas/SLIReportResponseBody"
           description: OK
         default:
           content:
@@ -2770,14 +2600,6 @@ paths:
     delete:
       description: 同时移除监控系统中对应的服务树，此后不再统计可用率。
       operationId: delete-slo
-      parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
       responses:
         "204":
           description: No Content
@@ -2793,20 +2615,12 @@ paths:
     get:
       description: 没定过就是 404，而不是一份默认目标：没承诺过和承诺了 99.9% 是两回事。
       operationId: get-slo
-      parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/SLOView"
+                $ref: "#/components/schemas/SLOResource"
           description: OK
         default:
           content:
@@ -2823,26 +2637,18 @@ paths:
 
         `min_severity` 必须显式选：它决定什么算「不可用」，是这条承诺的一半内容。
       operationId: put-slo
-      parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
       requestBody:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/PutSLOInputBody"
+              $ref: "#/components/schemas/PutSLORequestBody"
         required: true
       responses:
         "200":
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/SLOView"
+                $ref: "#/components/schemas/SLOResource"
           description: OK
         default:
           content:
@@ -2857,13 +2663,6 @@ paths:
     get:
       operationId: list-project-top-items
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - explode: false
           in: query
           name: kind
@@ -2889,7 +2688,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/TopItemsOutputBody"
+                $ref: "#/components/schemas/TopItemListResponseBody"
           description: OK
         default:
           content:
@@ -2904,13 +2703,6 @@ paths:
     get:
       operationId: list-web-checks
       parameters:
-        - description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-          in: header
-          name: Authorization
-          required: true
-          schema:
-            description: IAM 签发的项目令牌，形如 Bearer <token>。当前项目由令牌决定，路径上没有 project_id
-            type: string
         - description: 只看某一台机器的检查；不给就是整个项目的
           explode: false
           in: query
@@ -2923,7 +2715,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListWebChecksOutputBody"
+                $ref: "#/components/schemas/WebCheckListResponseBody"
           description: OK
         default:
           content:
@@ -2934,4 +2726,6 @@ paths:
       summary: 列出网页检查
       tags:
         - WebCheck
+security:
+  - bearerAuth: []