usermacro.update
Beschreibung
object usermacro.update(object/array hostMacros)
Diese Methode ermöglicht die Aktualisierung vorhandener Host-Makros.
Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.
Parameter
(object/array) zu aktualisierende Eigenschaften von Host-Makros.
Die Eigenschaft hostmacroid muss für jedes Host-Makro definiert werden, alle anderen Eigenschaften sind optional. Nur die übergebenen Eigenschaften werden aktualisiert, alle anderen bleiben unverändert.
Rückgabewerte
(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Host-Makros in der Eigenschaft hostmacroids enthält.
Beispiele
Ändern des Werts eines Host-Makros
Ändern Sie den Wert eines Host-Makros auf „public“.
{
"jsonrpc": "2.0",
"method": "usermacro.update",
"params": {
"hostmacroid": "1",
"value": "public"
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"hostmacroids": [
"1"
]
},
"id": 1
}Makrowert ändern, der durch eine Discovery-Regel erstellt wurde
Ein von einer Discovery-Regel erstelltes "automatisches" Makro in "manuell" umwandeln und seinen Wert in "new-value" ändern.
{
"jsonrpc": "2.0",
"method": "usermacro.update",
"params": {
"hostmacroid": "1",
"value": "new-value",
"automatic": "0"
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"hostmacroids": [
"1"
]
},
"id": 1
}Quelle
CUserMacro::update() in ui/include/classes/api/services/CUserMacro.php.