This is a translation of the original English documentation page. Help us make it better.

hostinterface.replacehostinterfaces

Description

object hostinterface.replacehostinterfaces(object parameters)

This method allows to replace all host interfaces on a given host.

This method is only available to Admin and Super admin user types. Permissions to call the method can be revoked in user role settings. See User roles for more information.

Parameters

(object) Parameters containing the ID of the host to be updated and the new host interfaces.

Parameter Type Description
hostid
(required)
string ID of the host to be updated.
interfaces
(required)
object/array Host interfaces to replace the current host interfaces with.

Повернуті значення

(object) Повертає об’єкт, що містить ідентифікатори створених інтерфейсів хостів у властивості interfaceids.

Приклади

Заміна інтерфейсів хоста

Замініть усі інтерфейси хоста єдиним інтерфейсом агента.

Запит:

{
           "jsonrpc": "2.0",
           "method": "hostinterface.replacehostinterfaces",
           "params": {
               "hostid": "30052",
               "interfaces": {
                   "dns": "",
                   "ip": "127.0.0.1",
                   "main": 1,
                   "port": "10050",
                   "type": 1,
                   "useip": 1
               }
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Відповідь:

{
           "jsonrpc": "2.0",
           "result": {
               "interfaceids": [
                   "30081"
               ]
           },
           "id": 1
       }

See also

Джерело

CHostInterface::replaceHostInterfaces() в ui/include/classes/api/services/CHostInterface.php.