usermacro.create
Beschreibung
object usermacro.create(object/array hostMacros)
Mit dieser Methode können neue Host-Makros erstellt werden.
Diese Methode ist nur für Benutzertypen Admin und Super admin verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den Benutzerrolleneinstellungen entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.
Parameter
(object/array) Zu erstellende Host-Makros.
Die Methode akzeptiert Host-Makros mit den standardmäßigen Eigenschaften von Host-Makros.
Rückgabewerte
(object) Gibt ein Objekt zurück, das die IDs der erstellten Host-
Makros in der Eigenschaft hostmacroids enthält. Die Reihenfolge der
zurückgegebenen IDs entspricht der Reihenfolge der übergebenen Host-
Makros.
Beispiele
Erstellen eines Host-Makros
Erstellen Sie auf dem Host "10198" ein Host-Makro "{$SNMP_COMMUNITY}" mit dem Wert "public".
{
"jsonrpc": "2.0",
"method": "usermacro.create",
"params": {
"hostid": "10198",
"macro": "{$SNMP_COMMUNITY}",
"value": "public"
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"hostmacroids": [
"11"
]
},
"id": 1
}Quelle
CUserMacro::create() in ui/include/classes/api/services/CUserMacro.php.