Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

proxy.update

Description

object proxy.update(object/array proxies)

Cette méthode permet de mettre à jour les proxys existants.

Cette méthode est seulement disponible pour les utilisateurs du type Super admin. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôle d'utilisateur. Voir Rôles utilisateur pour plus d'informations.

Paramètres

(object/array) Propriétés du proxy à mettre à jour.

La propriété proxyid doit être définie pour chaque proxy, toutes les autres propriétés sont facultatives. Seules les propriétés transmises seront mises à jour, toutes les autres resteront inchangées.

En plus des propriétés standard du proxy, la méthode accepte les paramètres suivants.

Paramètre Type Description
hosts array Hôtes devant être surveillé par le proxy. Si un hôte est déjà surveillé par un proxy différent, il sera réaffecté au proxy actuel.

Les hôtes doivent avoir la propriété hostid définie.
interface object Interface d'hôte en remplacement de l'interface existante pour le proxy passif.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des proxys mis à jour sous la propriété proxyids.

Exemples

Changement des hôtes surveillés par un proxy

Mettez à jour le proxy pour surveiller les deux hôtes donnés.

Requête :

{
           "jsonrpc": "2.0",
           "method": "proxy.update",
           "params": {
               "proxyid": "10293",
               "hosts": [
                   {
                       "hostid": "10294"
                   },
                   {
                       "hostid": "10295"
                   },
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Réponse :

{
           "jsonrpc": "2.0",
           "result": {
               "proxyids": [
                   "10293"
               ]
           },
           "id": 1
       }

Modification du statut du proxy

Changez le proxy en proxy actif et renommez-le en "Active proxy".

Requête :

{
           "jsonrpc": "2.0",
           "method": "proxy.update",
           "params": {
               "proxyid": "10293",
               "host": "Active proxy",
               "status": "5"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Réponse :

{
           "jsonrpc": "2.0",
           "result": {
               "proxyids": [
                   "10293"
               ]
           },
           "id": 1
       }

Voir également

Source

CProxy::update() dans ui/include/classes/api/services/CProxy.php.