2022 Zabbix中国峰会
2022 Zabbix中国峰会

创建

描述

object sla.create(object/array SLAs)

这个方法可以创建新的 SLA 对象。

这个方法只有 管理员超级管理员 用户类型可用。在用户角色设置中可用撤销掉用该方法的权限。查看 用户角色获取更多信息。

参数

(object/array) 创建 SLA 对象。

除了标准的 SLA 属性之外, 该方法还接受以下参数。

参数 类型 描述
service_tags array 为 SLA 创建的SLA 服务标签

参数行为:
- 必填
schedule array 为 SLA 创建SLA 时间表
指定空参数将被解释为 24x7 的时间表。
默认: 24x7 时间表。
excluded_downtimes array 为 SLA 创建SLA 排除停机时间

返回值

(对象) 返回一个包含创建的 SLA 的 ID 的对象,这些 ID 在 slaids 属性下。返回的 ID 的顺序与传入 SLA 的顺序相匹配。

示例

创建一个 SLA

指示创建一个 SLA 条目: * 跟踪与 SQL 引擎相关的服务的正常运行时间; * 自定义时间表,所有工作日都包括在内,但不包括星期六的最后一个小时; * 生效时间为 2022年的最后一天; * 计划停机时间为 1 小时 15 分钟,从 7 月 4 日午夜开始; * 将启用SLA 每周报告计算; * 最低可接受的 SLO 为 99.9995%。

请求:

{
           "jsonrpc": "2.0",
           "method": "sla.create",
           "params": [
               {
                   "name": "Database Uptime",
                   "slo": "99.9995",
                   "period": "1",
                   "timezone": "America/Toronto",
                   "description": "Provide excellent uptime for main database engines.",
                   "effective_date": 1672444800,
                   "status": 1,
                   "schedule": [
                       {
                           "period_from": 0,
                           "period_to": 601200
                       }
                   ],
                   "service_tags": [
                       {
                           "tag": "Database",
                           "operator": "0",
                           "value": "MySQL"
                       },
                       {
                           "tag": "Database",
                           "operator": "0",
                           "value": "PostgreSQL"
                       }
                   ],
                   "excluded_downtimes": [
                       {
                           "name": "Software version upgrade rollout",
                           "period_from": "1648760400",
                           "period_to": "1648764900"
                       }
                   ]
               }
           ],
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "slaids": [
                   "5"
               ]
           },
           "id": 1
       }

来源

CSla::create() 在 ui/include/classes/api/services/CSla.php