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.