usermacro.create
Beschreibung
object usermacro.create(object/array hostMacros)
Mit dieser Methode können Sie neue Host-Makros erstellen.
Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den Einstellungen der Benutzerrolle 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.