[comment]: # translation:outdated

[comment]: # ({66c5a546-66c5a546})
## host.massadd

[comment]: # ({/66c5a546-66c5a546})

[comment]: # ({55030171-55030171})
### Descrição

`object host.massadd(object parameters)`

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

::: noteclassic
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](/manual/web_interface/frontend_sections/administration/user_roles)
Para maiores informações.
:::

[comment]: # ({/55030171-55030171})

[comment]: # ({c25e2be4-c25e2be4})
### 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](/manual/api/reference_commentary#data_types)|Descrição|
|---------|----------------------------------- ------------|-----------|
|**hosts**<br>(obrigatório)|object/array|Hosts a serem atualizados.<br><br>Os hosts devem ter a propriedade `hostid` definida.|
|grupos|objeto/array|Grupos de hosts para adicionar aos hosts fornecidos.<br><br>Os grupos de hosts devem ter a propriedade `groupid` definida.|
|interfaces|object/array|[Interfaces de host](/manual/api/reference/hostinterface/object) a serem criadas para os hosts fornecidos.|
|macros|object/array|[Macros do usuário](/manual/api/reference/usermacro/object) a serem criados para os hosts fornecidos.|
|templates|object/array|Modelos para vincular aos hosts fornecidos.<br><br>Os templates devem ter a propriedade `templateid` definida.|

[comment]: # ({/c25e2be4-c25e2be4})

[comment]: # ({d166b99b-d166b99b})
### Valores de retorno

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

[comment]: # ({/d166b99b-d166b99b})

[comment]: # ({b41637d2-b41637d2})
### Exemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({453a1298-453a1298})
#### Adicionando macros

Adicione duas novas macros a dois hosts.

Solicitação:

``` {.java}
{
    "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:

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

[comment]: # ({/453a1298-453a1298})

[comment]: # ({ae4115e5-ae4115e5})
### Veja também

- [host.update](atualização)
- [Grupo de hosts](/manual/api/reference/hostgroup/object#host_group)
- [Modelo](/manual/api/reference/template/object#template)
-   [Do utilizador
    macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro)
-   [Hospedeiro
    interface](/manual/api/reference/hostinterface/object#host_interface)

[comment]: # ({/ae4115e5-ae4115e5})

[comment]: # ({d5e419cc-d5e419cc})
### Fonte

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

[comment]: # ({/d5e419cc-d5e419cc})