Esta é uma tradução da página de documentação original em inglês. Ajude-nos a torná-la melhor.

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

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:

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

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:

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

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:

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

Veja também

Fonte

CHostPrototype::update() em ui/include/classes/api/services/CHostPrototype.php.