[comment]: # ({be70f0cc-be70f0cc})
# triggerprototype.update

[comment]: # ({/be70f0cc-be70f0cc})

[comment]: # ({0af53e19-842b5955})
### Описание

`object triggerprototype.update(объект/массив triggerPrototypes)`

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

::: noteclassic
Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*.
Разрешения на вызов метода можно отозвать в настройках ролей пользователя.
Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/0af53e19-842b5955})

[comment]: # ({db615d69-827e4920})
### Параметры

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

Для каждого прототипа триггера должно быть определено свойство `triggerid`, все
остальные свойства необязательны. Будут обновлены только переданные свойства,
все остальные останутся без изменений.

Кроме [стандартных свойств прототипа триггера](object#trigger-prototype), метод принимает следующие
параметры.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|dependencies|array|[Триггеры](/manual/api/reference/trigger/object#trigger) и [прототипы триггеров](/manual/api/reference/triggerprototype/object#trigger-prototype), от которых зависит прототип триггера.<br><br>У триггеров должно быть определено только свойство `triggerid`.|
|tags|array|[Теги прототипа триггера](/manual/api/reference/triggerprototype/object#trigger-prototype-tag).|

[comment]: # ({/db615d69-827e4920})

[comment]: # ({200d7b9d-200d7b9d})
### Возвращаемые значения

`(object)` Возвращает объект, содержащий идентификаторы обновленных прототипов триггеров в свойстве `triggerids`.

[comment]: # ({/200d7b9d-200d7b9d})

[comment]: # ({b41637d2-b41637d2})
### Примеры

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({7b2a44a5-bcca41dc})
#### Включение прототипа триггера

Чтобы включить прототип триггера, установите для его статуса значение "0".

[Запрос](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "triggerprototype.update",
    "params": {
        "triggerid": "13938",
        "status": 0
    },
    "id": 1
}
```

Ответ:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "triggerids": [
            "13938"
        ]
    },
    "id": 1
}
```

[comment]: # ({/7b2a44a5-bcca41dc})

[comment]: # ({708ac736-724af3ce})
#### Замена тегов прототипа триггера

Заменяет теги для одного прототипа триггера.

[Запрос](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "triggerprototype.update",
    "params": {
        "triggerid": "17373",
        "tags": [
            {
                "tag": "volume",
                "value": "{#FSNAME}"
            },
            {
                "tag": "type",
                "value": "{#FSTYPE}"
            }
        ]
    },
    "id": 1
}
```

Ответ:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "triggerids": [
            "17373"
        ]
    },
    "id": 1
}
```

[comment]: # ({/708ac736-724af3ce})

[comment]: # ({585ae96a-585ae96a})
### Источник

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

[comment]: # ({/585ae96a-585ae96a})