usermacro.update
Description
object usermacro.update(object/array hostMacros)
Cette méthode permet de mettre à jour des macros d'hôte existantes.
Cette méthode est disponible uniquement pour les types d'utilisateur Admin et Super admin. Les autorisations d'appel de la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Voir User roles pour plus d'informations.
Paramètres
(object/array) Propriétés des macros d'hôte à mettre à jour.
La propriété hostmacroid doit être définie pour chaque macro d'hôte. Toutes les autres propriétés sont facultatives. Seules les propriétés transmises seront mises à jour, toutes les autres resteront inchangées.
Valeurs retournées
(object) Retourne un objet contenant les identifiants des macros d'hôtes mises à jour sous la propriété hostmacroids.
Exemples
Modification de la valeur d'une macro d'hôte
Modifiez la valeur d'une macro d'hôte en "public".
{
"jsonrpc": "2.0",
"method": "usermacro.update",
"params": {
"hostmacroid": "1",
"value": "public"
},
"id": 1
}Réponse :
{
"jsonrpc": "2.0",
"result": {
"hostmacroids": [
"1"
]
},
"id": 1
}Modifier la valeur d’une macro créée par une règle de découverte
Convertissez la macro « automatique » créée par la règle de découverte en macro « manuelle » et modifiez sa valeur en « new-value ».
{
"jsonrpc": "2.0",
"method": "usermacro.update",
"params": {
"hostmacroid": "1",
"value": "new-value",
"automatic": "0"
},
"id": 1
}Réponse :
{
"jsonrpc": "2.0",
"result": {
"hostmacroids": [
"1"
]
},
"id": 1
}Source
CUserMacro::update() dans ui/include/classes/api/services/CUserMacro.php.