创建用户宏
描述
object usermacro.create(object/array hostMacros)
此方法用于创建新的主机宏.
此方法只有Admin(管理员) 和 Super admin(超级管理员) 用户可用.可以在用户角色设置中撤销调用该方法的权限.更多信息请查看 User roles .
参数
(object/array)
要创建主机宏.
此方法接受具有 标准主机宏属性的主机宏.
返回值
(object)
返回包含 hostmacroids
属性(其中包含被创建主机宏的ID)的对象. 返回的主机宏ID顺序与传入的主机宏顺序相同.
示例
创建一个主机宏
为主机”10198”创建主机宏 “{$SNMP_COMMUNITY}” ,值为 “public” .
请求:
{
"jsonrpc": "2.0",
"method": "usermacro.create",
"params": {
"hostid": "10198",
"macro": "{$SNMP_COMMUNITY}",
"value": "public"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
返回:
{
"jsonrpc": "2.0",
"result": {
"hostmacroids": [
"11"
]
},
"id": 1
}
来源
CUserMacro::create() in ui/include/classes/api/services/CUserMacro.php.