Documentation
Table of Contents
sla.update
Описание
object sla.update(объект/массив slaids)
Этот метод позволяет обновлять существующие записи SLA.
Этот метод доступен только пользователям с типом доступа Администратор и Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.
Parameters
(object/array) SLA properties to be updated.
The slaid property must be defined for each SLA, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.
Additionally to the standard SLA properties, the method accepts the following parameters.
| Parameter | Type | Description |
|---|---|---|
| service_tags | array | SLA service tags to replace the current SLA service tags. At least one service tag must be specified. |
| schedule | array | SLA schedule to replace the current one. Specifying parameter as empty will be interpreted as a 24x7 schedule. |
| excluded_downtimes | array | SLA excluded downtimes to replace the current ones. |
Return values
(object) Returns an object containing the IDs of the updated SLAs under the slaids property.
Примеры
Updating service tags
Make SLA with ID "5" to be calculated at monthly intervals for NoSQL related services, without changing its schedule or excluded downtimes; set SLO to 95%.
Request:
{
"jsonrpc": "2.0",
"method": "sla.update",
"params": [
{
"slaid": "5",
"name": "NoSQL Database engines",
"slo": "95",
"period": 2,
"service_tags": [
{
"tag": "Database",
"operator": "0",
"value": "Redis"
},
{
"tag": "Database",
"operator": "0",
"value": "MongoDB"
}
]
}
],
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Response:
Changing the schedule of an SLA
Switch the SLA with ID "5" to a 24x7 schedule.
Request:
{
"jsonrpc": "2.0",
"method": "service.update",
"params": {
"slaid": "5",
"schedule": []
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Response:
Changing the excluded downtimes for an SLA
Add a planned 4 hour long RAM upgrade downtime on the 6th of April, 2022, while keeping (needs to be defined anew) a previously existing software upgrade planned on the 4th of July for the SLA with ID "5".
Request:
{
"jsonrpc": "2.0",
"method": "service.update",
"params": {
"slaid": "5",
"excluded_downtimes": [
{
"name": "Software version upgrade rollout",
"period_from": "1648760400",
"period_to": "1648764900"
},
{
"name": "RAM upgrade",
"period_from": "1649192400",
"period_to": "1649206800"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Response:
Источник
CSla::update() в ui/include/classes/api/services/CSla.php.