用户宏 object

以下objects与usermacroAPI直接相关。

全局宏

全局宏对象具有以下属性。

Property Type Description
globalmacroid ID 全局宏的 ID。

属性行为:
- 只读
- 在更新操作中为 必需
macro string 宏字符串。

属性行为:
- 在创建操作中为 必需
value string 宏的值。

属性行为:
- 如果 type 设置为 "Secret macro"，则为 只写
- 在创建操作中为 必需
type integer 宏的类型。

可能的值：
0 - (默认) 文本宏；
1 - Secret macro；
2 - Vault secret。
description string 宏的描述。

主机宏

主机宏对象定义了可在主机、主机原型或模板上使用的宏。它具有以下属性。

Property Type Description
hostmacroid ID 主机宏的 ID。

属性行为:
- 只读
- 更新操作时为 必需
hostid ID 宏所属主机的 ID。

属性行为:
- 常量
- 创建操作时为 必需
macro string 宏字符串。

属性行为:
- 创建操作时为 必需
value string 宏的值。

属性行为:
- 如果 type 设置为 "Secret macro"，则为 仅写入
- 创建操作时为 必需
type integer 宏的类型。

可能的值：
0 - (默认) 文本宏；
1 - Secret macro；
2 - Vault secret。
description string 宏的描述。
automatic integer 定义该宏是否由发现规则控制。

可能的值：
0 - (默认) 宏由用户管理；
1 - 宏由发现规则管理。

不允许用户创建自动宏。
要更新自动宏，必须先将其转换为手动。