创建
描述
object sla.create(object/array SLAs)
此方法用于创建新的 SLA 对象。
此方法仅适用于 Admin 和 Super admin 用户类型。 调用此方法的权限可在用户角色设置中被撤销。 更多信息请参见 用户角色。
参数
(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": "数据库正常运行时间",
"slo": "99.9995",
"period": "1",
"timezone": "America/Toronto",
"description": "为主要数据库引擎提供出色的正常运行时间。",
"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": "软件版本升级发布",
"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。