Documentation

host.massadd

Descrição

object host.massadd(object parameters)

Este método permite adicionar simultaneamente vários objetos relacionados a todos os hospedeiros dados.

Parâmetros

Parâmetros (object) contendo os IDs dos hosts a serem atualizados e o objetos para adicionar a todos os hosts.

O método aceita os seguintes parâmetros.

|Parâmetro|Tipo|Descrição| |---------|----------------------------------- ------------|-----------| |hosts
(obrigatório)|object/array|Hosts a serem atualizados.

Os hosts devem ter a propriedade hostid definida.| |grupos|objeto/array|Grupos de hosts para adicionar aos hosts fornecidos.

Os grupos de hosts devem ter a propriedade groupid definida.| |interfaces|object/array|Interfaces de host a serem criadas para os hosts fornecidos.| |macros|object/array|Macros do usuário a serem criados para os hosts fornecidos.| |templates|object/array|Modelos para vincular aos hosts fornecidos.

Os templates devem ter a propriedade templateid definida.|

Valores de retorno

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

Exemplos

Adicionando macros

Adicione duas novas macros a dois hosts.

Solicitação:

{
           "jsonrpc": "2.0",
           "método": "host.massadd",
           "parâmetros": {
               "anfitriões": [
                   {
                       "hostid": "10160"
                   },
                   {
                       "hostid": "10167"
                   }
               ],
               "macros": [
                   {
                       "macro": "{$TEST1}",
                       "valor": "MACROTEST1"
                   },
                   {
                       "macro": "{$TEST2}",
                       "valor": "MACROTEST2",
                       "description": "Descrição do teste"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "resultado": {
               "hostids": [
                   "10160",
                   "10167"
               ]
           },
           "id": 1
       }

Veja também

• host.update
• Grupo de hosts
• Modelo
• Do utilizador macro
• Hospedeiro interface

Fonte

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