sla更新

描述

此方法允许更新现有的 SLA 条目。

此方法仅适用于 AdminSuper admin用户类型。可以在用户角色中撤销调用该方法的权限设置。请参阅 用户角色 了解更多信息。

参数

(object/array) SLA属性将被更新

必须为每个 SLA 定义 slaid 属性,所有其他属性是可选的。只有传递的属性会被更新,所有其他的将保持不变。

除了 标准 SLA 属性,方法接受以下参数。

参数类型描述
service_tags数组SLA 服务标签 替换当前的 SLA 服务标签。

必须至少指定一个服务标签。
schedule数组SLA schedule 替换当前的。

将参数指定为空将被解释为 24x7 计划。
excluded_downtimes数组SLA 排除停机时间 替换当前的。

返回值

(object)返回一个对象,该对象包含 slaids 属性下更新的 SLA 的 ID。

示例

更新服务标签

为 NoSQL 相关服务每月计算一次 ID 为“5”的 SLA,不改变其时间表或排除停机时间;将 SLO 设置为 95%。

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "sla.update",
  4. "params": [
  5. {
  6. "slaid": "5",
  7. "name": "NoSQL Database engines",
  8. "slo": "95",
  9. "period": 2,
  10. "service_tags": [
  11. {
  12. "tag": "Database",
  13. "operator": "0",
  14. "value": "Redis"
  15. },
  16. {
  17. "tag": "Database",
  18. "operator": "0",
  19. "value": "MongoDB"
  20. }
  21. ]
  22. }
  23. ],
  24. "auth": "038e1d7b1735c6a5436ee9eae095879e",
  25. "id": 1
  26. }

响应:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "slaids": [
  5. "5"
  6. ]
  7. },
  8. "id": 1
  9. }

更改 SLA计划

将 ID 为“5”的 SLA 切换为 24x7 计划。

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "service.update",
  4. "params": {
  5. "slaid": "5",
  6. "schedule": []
  7. },
  8. "auth": "038e1d7b1735c6a5436ee9eae095879e",
  9. "id": 1
  10. }

响应:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "slaids": [
  5. "5"
  6. ]
  7. },
  8. "id": 1
  9. }

更改 SLA 的排除停机时间

在 2022 年 4 月 6 日添加计划的 4 小时 RAM 升级停机时间,同时保留(需要重新定义)计划在 7 月 4 日进行的先前存在的软件升级对于 ID 为“5”的 SLA。 请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "service.update",
  4. "params": {
  5. "slaid": "5",
  6. "excluded_downtimes": [
  7. {
  8. "name": "Software version upgrade rollout",
  9. "period_from": "1648760400",
  10. "period_to": "1648764900"
  11. },
  12. {
  13. "name": "RAM upgrade",
  14. "period_from": "1649192400",
  15. "period_to": "1649206800"
  16. }
  17. ]
  18. },
  19. "auth": "038e1d7b1735c6a5436ee9eae095879e",
  20. "id": 1
  21. }

响应:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "slaids": [
  5. "5"
  6. ]
  7. },
  8. "id": 1
  9. }

来源

CSla::update() in ui/include/classes/api/services/CSla.php.