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.