usermacro.create
Beschreibung
object usermacro.create(object/array hostMacros)
Diese Methode ermöglicht es Ihnen, neue Host-Makros zu erstellen.
Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Die Berechtigung zum Aufruf der Methode kann in den Einstellungen der Benutzerrolle widerrufen 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.