跳转到主要内容
API Explorer|API Explorer
SLO 与服务质量相关接口/SLO
POSTSLO起始版本 1.0同步需要认证

创建SLI

创建新SLI定义指标类型PROM QL查询。

调试可用性

在线调试

使用当前认证信息和示例参数提交 Mock 请求。

请求参数

请求体字段

  • nameString必填

    资源名称。

    示例： api-availability

  • descriptionString必填

    资源的详细描述。

    示例： HTTP success rate for the public API

  • metricTypeString必填

    指标分类可用性延迟吞吐量错误速率。

    示例： availability

  • goodEventsQueryString必填

    正常事件的查询语句。

    示例： sum(rate(http_requests_total{status=~"2.."}[5m]))

  • totalEventsQueryString必填

    总事件的查询语句。

    示例： sum(rate(http_requests_total[5m]))

响应状态

200 OK

该 API 成功时返回以下响应结构。

  • idString

    资源ID。

    示例： sli-abc123

  • nameString

    资源名称。

    示例： api-availability

  • descriptionString

    资源的详细描述。

    示例： Ratio of successful HTTP requests to total requests

  • metricTypeString

    指标分类可用性时延吞吐量错误比例。

    示例： availability

  • goodEventsQueryString

    正常事件的查询语句。

    示例： sum(rate(http_requests_total{status=~"2.."}[5m]))

  • totalEventsQueryString

    总事件的查询语句。

    示例： sum(rate(http_requests_total[5m]))

  • unitString

    测量指标请求时间，单位为毫秒。

    示例： requests

  • sourceProductString

    产品服务拥有SLI。

    示例： zcf-api

  • createdAtString

    创建时间。

    示例： 2026-01-15T08:00:00Z

请求地址

POST/api/v1/slo/slis

/api/v1/slo/slis

操作 ID

CreateSLI

永久链接

请求示例

curl -X POST '{host}/api/v1/slo/slis' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"name":"api-availability","description":"HTTP success rate for the public API","metricType":"availability","goodEventsQuery":"sum(rate(http_requests_total{status=~\"2..\"}[5m]))","totalEventsQuery":"sum(rate(http_requests_total[5m]))","unit":"requests","sourceProduct":"zcf-api"}'

响应示例

200
{
  "id": "sli-abc123",
  "name": "api-availability",
  "description": "Ratio of successful HTTP requests to total requests",
  "metricType": "availability",
  "goodEventsQuery": "sum(rate(http_requests_total{status=~\"2..\"}[5m]))",
  "totalEventsQuery": "sum(rate(http_requests_total[5m]))",
  "unit": "requests",
  "sourceProduct": "zcf-api"
}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史