host.massremove

Descrição

object host.massremove(object parameters)

Este método permite remover objetos relacionados de vários hosts.

Este método está disponível apenas para Admin e Superadministrador tipos de usuário. As permissões para chamar o método podem ser revogadas na função de usuário definições. Veja Usuário funções Para maiores informações.

Parâmetros

Parâmetros (object) contendo os IDs dos hosts a serem atualizados e o objetos que devem ser removidos.

Parâmetro Tipo Descrição
hostids
(obrigatório)		 string/array IDs dos hosts a serem atualizados.
groupids string/array Grupos de hosts dos quais remover os hosts fornecidos.
interfaces object/array Interfaces de host a serem removidas dos hosts fornecidos.

O objeto de interface de host deve ter as propriedades ip, dns e port definidas.
macros string/array Macros de usuário a serem excluídos dos hosts fornecidos.
templateids string/array Modelos para desvincular dos hosts fornecidos.
templateids_clear string/array Modelos para desvincular e limpar dos hosts fornecidos.

Valores de retorno

(object) Retorna um objeto contendo os IDs dos hosts atualizados sob a propriedade hostids.

Exemplos

Desvinculando modelos

Desvincule um modelo de dois hosts e exclua todos os modelos entidades.

Solicitação:

{
    "jsonrpc": "2.0",
    "método": "host.massremove",
    "parâmetros": {
        "hostids": ["69665", "69666"],
        "templateids_clear": "325"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Resposta:

{
    "jsonrpc": "2.0",
    "resultado": {
        "hostids": [
            "69665",
            "69666"
        ]
    },
    "id": 1
}

Veja também

Fonte

CHost::massRemove() em ui/include/classes/api/services/CHost.php.