更新

描述

object mediatype.update(object/array mediaTypes)

此方法允许您更新现有的媒体类型。

此方法仅适用于 Super admin 用户类型。 调用此方法的权限可以在用户角色设置中撤销。 有关更多信息，请参见 用户角色。
如果在 前端配置文件（zabbix.conf.php）中的 $ZBX_FEATURE_FLAGS['media_type_denylist'] 功能标志里指定了投递方式，则用户不允许为相应的媒体类型调用此方法。

参数

(object/array) 要更新的媒介类型属性。

必须为每个媒介类型定义 mediatypeid 属性，所有其他属性均为可选。只有传入的属性会被更新，其他所有属性将保持不变。

除了标准媒介类型属性之外，该方法还接受以下参数。

参数 类型 描述
message_templates array 用于替换当前消息模板的消息模板。

返回值

(object) 返回包含mediatypeids属性下所更新IDs的对象。

示例

启用媒介类型

启用媒体类型，即将其状态设置为"0"。

请求：

{
    "jsonrpc": "2.0",
    "method": "mediatype.update",
    "params": {
        "mediatypeid": "6",
        "status": "0"
    },
    "id": 1
}

响应：

{
    "jsonrpc": "2.0",
    "result": {
        "mediatypeids": [
            "6"
        ]
    },
    "id": 1
}

来源

ui/include/classes/api/services/CMediaType.php 中的 CMediaType::update()。