Table of Contents
hostprototype.update
Descrição
object hostprototype.update(object/array hostPrototypes)
Este método permite atualizar protótipos de host existentes.
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
(object/array) Propriedades do protótipo do host a serem atualizadas.
A propriedade hostid deve ser definida para cada protótipo de host, todos os outros propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas outros permanecerão inalterados.
Além do protótipo de host padrão properties, o método aceita o seguinte parâmetros.
|Parâmetro|Tipo|Descrição| |---------|----------------------------------- ------------|-----------| |groupLinks|array|Grupo links para substituir os links de grupo atuais no protótipo do host.| |groupPrototypes|array|Grupo protótipos para substituir os protótipos de grupo existentes no protótipo do host.| |macros|object/array|Macros de usuário para substituir as macros de usuário atuais.
Todas as macros que não estiverem listadas na solicitação serão removidas.| |tags|object/array|Protótipo de host tags para substituir as tags atuais.
Todas as tags que não estiverem listadas na solicitação serão removidas .| |interfaces|object/array|Protótipo de host interfaces personalizadas para substituir as interfaces atuais.
O objeto de interface personalizada deve conter todos os seus parâmetros.<br >Todas as interfaces que não estão listadas na solicitação serão removidas.| |templates|object/array|Templates para substituir os templates atualmente vinculados.
Os templates devem ter a propriedade templateid definida.|
Valores de retorno
(object) Retorna um objeto contendo os IDs do host atualizado protótipos sob a propriedade hostids.
Exemplos
Desativando um protótipo de host
Desabilite um protótipo de host, ou seja, defina seu status como 1.
Solicitação:
{
"jsonrpc": "2.0",
"method": "hostprototype.update",
"parâmetros": {
"hostid": "10092",
"estado": 1
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
Atualizando tags de protótipo de host
Substitua as tags de protótipo do host por novas.
Solicitação:
{
"jsonrpc": "2.0",
"method": "hostprototype.update",
"parâmetros": {
"hostid": "10092",
"Tag": [
{
"tag": "Datacenter",
"valor": "{#DATACENTER.NAME}"
},
{
"tag": "Tipo de instância",
"valor": "{#INSTANCE_TYPE}"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
Atualizando interfaces personalizadas de protótipo de host
Substitua interfaces herdadas por interfaces personalizadas de protótipo de host.
Solicitação:
{
"jsonrpc": "2.0",
"method": "hostprototype.update",
"parâmetros": {
"hostid": "10092",
"custom_interfaces": "1",
"interfaces": [
{
"principal": "1",
"tipo 2",
"useip": "1",
"ip": "127.0.0.1",
"dns": "",
"porta": "161",
"detalhes": {
"versão 2",
"em massa": "1",
"community": "{$SNMP_COMMUNITY}"
}
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
Veja também
- Link do grupo
- Protótipo do grupo
- Tag de protótipo do host
- Interface personalizada
- Do utilizador macro
Fonte
CHostPrototype::update() em ui/include/classes/api/services/CHostPrototype.php.