usermacro.update
Description
object usermacro.update(object/array hostMacros)
Cette méthode vous permet de mettre à jour les macros d’hôte existantes.
Cette méthode est uniquement disponible pour les types d’utilisateurs Admin et Super admin. Les autorisations permettant d’appeler cette méthode peuvent être révoquées dans les paramètres des rôles utilisateur. Consultez la page Rôles utilisateur pour plus d’informations.
Paramètres
(object/array) Propriétés de macro 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.