n/a

Hi !

For 'host.update' method you provide "interfaces" object with 'main' => 1 property.
The object will try to replace interfaces on the host (i.e. firstly delete existing one), but as the host has some items required at least one interface - it produces the correct error message. See https://www.zabbix.com/documentation/3.4/manual/api/reference/host/update

To change IP address for some interface - you need to use another method - "hostinterface.update"
See https://www.zabbix.com/documentation/3.4/manual/api/reference/hostinterface/update

Regards
Kaspars

You've confirmed that it does a delete first which is the source of the problem. At best, this is a terrible design. This makes it nearly impossible to use host.update if specifying interfaces. In many cases the interfaces being passed with host.update would be identical to the ones in place. This error should only be returned if there were an attempt to update the host and leave it without a main interface that was in-use.

Dear LarryDorman,

host.update API method is working as intended.
You must specify interfaceid for each interface when updating interfaces using it.
To get interfaceid you may use host.get or hostinterface.get method.
See examples below.

1. Get interfaces.
1.1. Using host.get method:

{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "output": ["hostid"],
        "hostids": ["10119"],
        "selectInterfaces": ["interfaceid"]
    },
    "auth": "f22de29e4e8175b2acdf9b0b5388a986",
    "id": 1
}

Response:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "hostid": "10119",
            "interfaces": [
                {
                    "interfaceid": "14"
                }
            ]
        }
    ],
    "id": 1
}

1.2. Using hostinterface.get method:

{
    "jsonrpc": "2.0",
    "method": "hostinterface.get",
    "params": {
        "output": ["interfaceid"],
        "hostids": "10119"
    },
    "auth": "f22de29e4e8175b2acdf9b0b5388a986",
    "id": 1
}

Response:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "interfaceid": "14"
        }
    ],
    "id": 1
}

2. Update interfaces.
2.1. Using host.update method:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10119",
        "status": 0,
        "interfaces": [
            {
                "type": 1,
                "interfaceid": "14",
                "main": 1,
                "useip": 1,
                "ip": "127.0.0.1",
                "dns": false,
                "port": 10050
            }
        ]
    },
    "auth": "f22de29e4e8175b2acdf9b0b5388a986",
    "id": 1
}

Response:

{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "10119"
        ]
    },
    "id": 1
}

2.2. Using hostinterface.update method:

{
    "jsonrpc": "2.0",
    "method": "hostinterface.update",
    "params": {
        "type": 1,
        "interfaceid": "14",
        "main": 1,
        "useip": 1,
        "ip": "127.0.0.1",
        "dns": false,
        "port": 10050
    },
    "auth": "f22de29e4e8175b2acdf9b0b5388a986",
    "id": 1
}

Response:

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

Andrejs Griščenko, now add a template that uses interfaceid 14 in your example and re-execute the "2.1. Using host.update method:" example.  You will find that the API now throws an error which makes it impossible to do a one-step host update.  You now have to do a host.update without any interfaces specified and you have to do a separate hostinterface.update.

There is no (good) reason one should not be able to do a one-step update of a host, including interfaces, using the host.update call.  Only in those cases in which there is an attempt to remove an in-use interface should an error be returned.

LarryDorman, I have created a host with 2 interfaces (Agent and SNMP) and added 2 items to this host each using its own interface. Now, to update interfaces on this host using host.update method all interfaces with linked items must be specified. Otherwise "Interface is linked to item ... on ... ." error will be returned. There is nothing wrong and it is expected behaviour.
To update specific interface (or set of interfaces) hostinterface.update method should be used instead.

In case I have missed something, please provide exact API calls you are using to reproduce the problem.