hostgroup.massupdate

Descrição

object hostgroup.massupdate(object parameters)

Este método permite substituir hosts e templates pelos especificados aqueles em vários grupos de 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 grupos de hosts a serem atualizados e os objetos que devem ser atualizados.

Parâmetro Tipo Descrição
grupos
(obrigatório)
objeto/array Grupos de hosts a serem atualizados.

Os grupos de hosts devem ter a propriedade groupid definida.
hosts
(obrigatório)
object/array Hosts para substituir os hosts atuais nos grupos de hosts fornecidos.
Todos os outros hosts, exceto os mencionados, serão excluídos dos grupos de hosts.
>Os hosts descobertos não serão afetados.

Os hosts devem ter a propriedade hostid definida.
modelos
(obrigatório)
objeto/array Modelos para substituir os modelos atuais nos grupos de hosts especificados.
Todos os outros modelos, exceto os mencionados, serão excluídos dos grupos de hosts.
>
Os templates devem ter a propriedade templateid definida.

Valores de retorno

(object) Retorna um objeto contendo os IDs do host atualizado grupos sob a propriedade groupids.

Exemplos

Substituindo hosts e modelos em um grupo de hosts

Substitua todos os hosts em um grupo de hosts pelos hosts mencionados e desvincule todos modelos do grupo de hosts.

Solicitação:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.massupdate",
    "parâmetros": {
        "grupos": [
            {
                "groupid": "6"
            }
        ],
        "anfitriões": [
            {
                "hostid": "30050"
            }
        ],
        "modelos": []
    },
    "auth": "f223adf833b2bf2ff38574a67bba6372",
    "id": 1
}

Resposta:

{
    "jsonrpc": "2.0",
    "resultado": {
        "groupids": [
            "6",
        ]
    },
    "id": 1
}

Veja também

Fonte

CHostGroup::massUpdate() em ui/include/classes/api/services/CHostGroup.php.