# > 用户宏对象

以下对象与“usermacro”API直接相关。

### 全局宏

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

|属性            类|说明|<|
|---------------------|------|-|
|globalmacroid|string|*(readonly)* 全局宏的ID。|
|**macro**<br>(required)|string|宏字符串。|
|**value**<br>(required)|string|宏的价值。|

### 主机宏

主机宏对象定义主机或模板上可用的宏。 它具有以下属性。

|属性          类|说明|<|
|-------------------|------|-|
|hostmacroid|string|*(readonly)* 主机宏的ID。|
|**hostid**<br>(required)|string|宏所属主机的ID。|
|**macro**<br>(required)|string|宏字符串。|
|**value**<br>(required)|string|宏的值。|