sla.update

Описание

object sla.update(объект/массив slaids)

Этот метод позволяет обновлять существующие записи SLA.

Этот метод доступен только пользователям с типом доступа Администратор и Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(object/array) свойства SLA, которые необходимо обновить.

Свойство slaid должно быть определено для каждого SLA, все остальные свойства являются необязательными. Будут обновлены только переданные свойства, все остальные останутся без изменений.

В дополнение к стандартным свойствам SLA, метод принимает следующие параметры.

Параметр Тип Описание
service_tags array Теги сервиса SLA для замены текущих тегов сервиса SLA.
schedule array Расписание SLA для замены текущего.
Указание пустого значения параметра будет интерпретировано как расписание 24x7.
excluded_downtimes array Исключенные периоды простоя SLA для замены текущих.

Возвращаемые значения

(object) Возвращает объект, содержащий идентификаторы обновлённых SLA в свойстве slaids.

Примеры

Обновление тегов сервиса

Сделайте так, чтобы SLA с ID "5" рассчитывался с ежемесячными интервалами для сервисов, связанных с NoSQL, не изменяя его расписание или исключённые простои; установите SLO равным 95%.

Запрос:

{
    "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"
                }
            ]
        }
    ],
    "id": 1
}

Ответ:

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

Изменение расписания SLA

Переключите SLA с ID "5" на расписание 24x7.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "sla.update",
    "params": {
        "slaid": "5",
        "schedule": []
    },
    "id": 1
}

Ответ:

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

Изменение исключаемых периодов простоя для SLA

Добавьте запланированный 4-часовой простой для обновления RAM 6 апреля 2022 года, при этом сохранив (его необходимо определить заново) ранее существовавшее запланированное обновление программного обеспечения 4 июля для SLA с ID "5".

Запрос:

{
    "jsonrpc": "2.0",
    "method": "sla.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"
            }
        ]
    },
    "id": 1
}

Ответ:

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

Источник

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