[comment]: # translation:outdated

[comment]: # ({8246351f-8246351f})
# itemprototype.get

[comment]: # ({/8246351f-8246351f})

[comment]: # ({9ecc6833-5f97ef4a})
### Descrição

`integer/array itemprototype.get(object parameters)`

O método permite recuperar protótipos de itens de acordo com o
parâmetros.

::: noteclassic
Este método está disponível para usuários de qualquer tipo. Permissões
para chamar o método pode ser revogado nas configurações de função do usuário. Veja [Usuário
funções](/manual/web_interface/frontend_sections/administration/user_roles)
Para maiores informações.
:::

[comment]: # ({/9ecc6833-5f97ef4a})

[comment]: # ({42f5c79b-8d6ecc79})
### Parâmetros

`(object)` Parâmetros que definem a saída desejada.

O método oferece suporte aos seguintes parâmetros.

|Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição|
|---------|----------------------------------- ------------|-----------|
|discoveryids|string/array|Retorna apenas protótipos de itens que pertencem às regras LLD fornecidas.|
|graphids|string/array|Retorna apenas protótipos de itens que são usados nos protótipos de gráficos fornecidos.|
|hostids|string/array|Retorna apenas protótipos de itens que pertencem aos hosts fornecidos.|
|inherited|boolean|Se definido como `true`, retornará apenas protótipos de itens herdados de um modelo.|
|itemids|string/array|Retorna apenas protótipos de itens com os IDs fornecidos.|
|monitored|boolean|Se definido como `true` retorna apenas protótipos de itens habilitados que pertencem a hosts monitorados.|
|templated|boolean|Se definido como `true`, retornará apenas protótipos de itens que pertencem a templates.|
|templateids|string/array|Retorna apenas protótipos de itens que pertencem aos modelos fornecidos.|
|triggerids|string/array|Retorna apenas os protótipos de item que são usados nos protótipos de gatilho fornecidos.|
|selectDiscoveryRule|query|Retorne uma propriedade [discoveryRule](/manual/api/reference/discoveryrule/object#lld_rule) com a regra de descoberta de baixo nível à qual o protótipo do item pertence.|
|selectGraphs|query|Retorne uma propriedade [manual/api/reference/graphprototype/object\#graph\_prototype](/manual/api/reference/graphprototype/object#graph_prototype) com protótipos de gráfico nos quais o protótipo de item é usado.< br><br>Suporta `contagem`.|
|selectHosts|query|Retorne uma propriedade [hosts](/manual/api/reference/host/object) com uma matriz de hosts aos quais o protótipo do item pertence.|
|selectTags|query|Retorne as tags de protótipo do item na propriedade [tags](/manual/api/reference/itemprototype/object#Item_prototype_tag).|
|selectTriggers|query|Retorne uma propriedade [triggers](/manual/api/reference/triggerprototype/object#trigger_prototype) com protótipos de gatilho nos quais o protótipo do item é usado.<br><br>Suporta `count`.|
|selectPreprocessing|query|Retorna uma propriedade de [pré-processamento](/manual/api/reference/item/object#item_preprocessing) com opções de pré-processamento de item.<br><br>Tem as seguintes propriedades:<br>`type` - ` (string)` O tipo de opção de pré-processamento:<br>1 - Multiplicador personalizado;<br>2 - Aparar à direita;<br>3 - Aparar à esquerda;<br>4 - Aparar;<br>5 - Correspondência de expressão regular;< br>6 - Booleano para decimal;<br>7 - Octal para decimal;<br>8 - Hexadecimal para decimal;<br>9 - Alteração simples;<br>10 - Alteração por segundo;<br>11 - XML XPath ;<br>12 - JSONPath;<br>13 - No intervalo;<br>14 - Corresponde à expressão regular;<br>15 - Não corresponde à expressão regular;<br>16 - Verifique se há erro no JSON;<br> 17 - Verificar erro no XML;<br>18 - Verificar erro usando expressão regular;<br>19 - Descartar inalterado;<br>20 - Descartar inalterado com pulsação;<br>21 - JavaScript;<br>22 - Padrão Prometheus;<br>23 - Prometheus para JSON;<br>24 - CSV para JSON;<br>25 - Substituir;<br>26 - Verificar valor não suportado;<br>27- XML para JSON.<br> ><br>`params` - `(str ing)` Parâmetros adicionais usados pela opção de pré-processamento. Vários parâmetros são separados pelo caractere LF (\\n).<br>`error_handler` - `(string)` Tipo de ação usado em caso de falha na etapa de pré-processamento:<br>0 - Mensagem de erro é definida pelo servidor Zabbix;<br> >1 - Descartar valor;<br>2 - Definir valor personalizado;<br>3 - Definir mensagem de erro personalizada.<br><br>`error_handler_params` - `(string)` Parâmetros do manipulador de erro.|
|selectValueMap|query|Retorne uma propriedade [valuemap](/manual/api/reference/valuemap/object) com o mapa de valor do protótipo do item.|
|filter|object|Retorna apenas os resultados que correspondem exatamente ao filtro fornecido.<br><br>Aceita uma matriz, em que as chaves são nomes de propriedades e os valores são um único valor ou uma matriz de valores para correspondência. <br><br>Suporta filtros adicionais:<br>`host` - nome técnico do host ao qual o protótipo do item pertence.|
|limitSelects|integer|Limite o número de registros retornados por subseleções.<br><br>Aplica-se às seguintes subseleções:<br>`selectGraphs` - os resultados serão classificados por `name`;<br>`selectTriggers` - resultados será ordenado por `descrição`.|
|sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.<br><br>Os valores possíveis são: `itemid`, `name`, `key_`, `delay`, `type` e `status`.|
|countOutput|boolean|Esses parâmetros sendo comuns para todos os métodos `get` são descritos em detalhes no [comentário de referência](/manual/api/reference_commentary#common_get_method_parameters).|
|editável|booleano|^|
|excludePesquisa|boolean|^|
|limite|inteiro|^|
|saída|consulta|^|
|preservekeys|boolean|^|
|pesquisar|objeto|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|ordem de classificação|cadeia/matriz|^|
|startSearch|boolean|^|

[comment]: # ({/42f5c79b-8d6ecc79})

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

`(integer/array)` Retorna:

- uma matriz de objetos;
- a contagem de objetos recuperados, se o parâmetro `countOutput` tiver
    sido usado.

[comment]: # ({/7223bab1-7223bab1})

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

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

[comment]: # ({24c96792-92651f4c})
#### Recuperando protótipos de itens de uma regra LLD

Recupere todos os protótipos de itens de uma regra LLD.

Solicitação:

``` {.java}
{
    "jsonrpc": "2.0",
    "método": "itemprototype.get",
    "parâmetros": {
        "saída": "estender",
        "discoveryids": "27426"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Resposta:

``` {.java}
{
    "jsonrpc": "2.0",
    "resultado": [
        {
            "itemid": "23077",
            "tipo": "0",
            "snmp_oid": "",
            "hostid": "10079",
            "name": "Tráfego de rede de entrada em en0",
            "key_": "net.if.in[en0]",
            "atraso": "1m",
            "história": "1w",
            "tendências": "365d",
            "estado": "0",
            "value_type": "3",
            "trapper_hosts": "",
            "unidades": "bps",
            "Fórmula": "",
            "erro": "",
            "logtimefmt": "",
            "templateid": "0",
            "valuemap": "0",
            "parâmetros": "",
            "ipmi_sensor": "",
            "authtype": "0",
            "nome do usuário": "",
            "senha": "",
            "chave pública": "",
            "chave privada": "",
            "bandeiras": "0",
            "interfaceid": "0",
            "Descrição": "",
            "link_inventário": "0",
            "vida": "30d",
            "estado": "0",
            "evaltype": "0",
            "jmx_endpoint": "",
            "master_itemid": "0",
            "tempo limite": "3s",
            "url": "",
            "query_fields": [],
            "Postagens": "",
            "status_codes": "200",
            "follow_redirects": "1",
            "post_type": "0",
            "proxy HTTP": "",
            "cabeçalhos": [],
            "recuperar_modo": "0",
            "request_method": "0",
            "output_format": "0",
            "ssl_cert_file": "",
            "ssl_key_file": "",
            "ssl_key_password": "",
            "verify_peer": "0",
            "verify_host": "0",
            "allow_traps": "0",
            "último relógio": "0",
            "últimos": "0",
            "último valor": "0",
            "valor anterior": "0",
            "descobrir": "0",
            "parâmetros": []
        },
        {
            "itemid": "10010",
            "tipo": "0",
            "snmp_oid": "",
            "hostid": "10001",
            "name": "Carga do processador (média de 1 min por núcleo)",
            "key_": "system.cpu.load[percpu,avg1]",
            "atraso": "1m",
            "história": "1w",
            "tendências": "365d",
            "estado": "0",
            "value_type": "0",
            "trapper_hosts": "",
            "unidades": "",
            "Fórmula": "",
            "erro": "",
            "logtimefmt": "",
            "templateid": "0",
            "valuemap": "0",
            "parâmetros": "",
            "ipmi_sensor": "",
            "authtype": "0",
            "nome do usuário": "",
            "senha": "",
            "chave pública": "",
            "chave privada": "",
            "bandeiras": "0",
            "interfaceid": "0",
            "description": "A carga do processador é calculada como a carga da CPU do sistema dividida pelo número de núcleos da CPU.",
            "link_inventário": "0",
            "vida": "0",
            "estado": "0",
            "evaltype": "0",
            "jmx_endpoint": "",
            "master_itemid": "0",
            "tempo limite": "3s",
            "url": "",
            "query_fields": [],
            "Postagens": "",
            "status_codes": "200",
            "follow_redirects": "1",
            "post_type": "0",
            "proxy HTTP": "",
            "cabeçalhos": [],
            "recuperar_modo": "0",
            "request_method": "0",
            "output_format": "0",
            "ssl_cert_file": "",
            "ssl_key_file": "",
            "ssl_key_password": "",
            "verify_peer": "0",
            "verify_host": "0",
            "allow_traps": "0",
            "último relógio": "0",
            "últimos": "0",
            "último valor": "0",
            "valor anterior": "0",
            "descobrir": "0",
            "parâmetros": []
        }
    ],
    "id": 1
}
```

[comment]: # ({/24c96792-92651f4c})

[comment]: # ({f5e6b133-acb23a7a})
#### Encontrando item dependente

Encontre um item Dependente para o item com ID "25545".

Solicitação:

``` {.java}
{
    "jsonrpc": "2.0",
    "método": "item.get",
    "parâmetros": {
        "saída": "estender",
        "filtro": {
            "tipo": "18",
            "master_itemid": "25545"
        },
        "limite": "1"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Resposta:

``` {.java}
{
    "jsonrpc": "2.0",
    "resultado": [
        {
            "itemid": "25547",
            "tipo": "18",
            "snmp_oid": "",
            "hostid": "10116",
            "nome": "Segundos",
            "key_": "apache.status.uptime.seconds",
            "atraso": "0",
            "história": "90d",
            "tendências": "365d",
            "estado": "0",
            "value_type": "3",
            "trapper_hosts": "",
            "unidades": "",
            "Fórmula": "",
            "erro": "",
            "logtimefmt": "",
            "templateid": "0",
            "valuemap": "0",
            "parâmetros": "",
            "ipmi_sensor": "",
            "authtype": "0",
            "nome do usuário": "",
            "senha": "",
            "chave pública": "",
            "chave privada": "",
            "bandeiras": "0",
            "interfaceid": "0",
            "Descrição": "",
            "link_inventário": "0",
            "vida": "30d",
            "estado": "0",
            "evaltype": "0",
            "master_itemid": "25545",
            "jmx_endpoint": "",
            "master_itemid": "0",
            "tempo limite": "3s",
            "url": "",
            "query_fields": [],
            "Postagens": "",
            "status_codes": "200",
            "follow_redirects": "1",
            "post_type": "0",
            "proxy HTTP": "",
            "cabeçalhos": [],
            "recuperar_modo": "0",
            "request_method": "0",
            "output_format": "0",
            "ssl_cert_file": "",
            "ssl_key_file": "",
            "ssl_key_password": "",
            "verify_peer": "0",
            "verify_host": "0",
            "allow_traps": "0",
            "último relógio": "0",
            "últimos": "0",
            "último valor": "0",
            "valor anterior": "0",
            "descobrir": "0",
            "parâmetros": []
        }
    ],
    "id": 1
}
```

[comment]: # ({/f5e6b133-acb23a7a})

[comment]: # ({e5a65942-18563427})
#### Localizar protótipo de item do agente HTTP

Encontre o protótipo do item do agente HTTP com o método de solicitação HEAD para
ID do host.

Solicitação:

``` {.java}
{
    "jsonrpc": "2.0",
    "método": "itemprototype.get",
    "parâmetros": {
        "hostids": "10254",
        "filtro": {
            "tipo": "19",
            "request_method": "3"
        }
    },
    "id": 17,
    "auth": "d678e0b85688ce578ff061bd29a20d3b"
}
```

Resposta:

``` {.java}
{
    "jsonrpc": "2.0",
    "resultado": [
        {
            "itemid": "28257",
            "tipo": "19",
            "snmp_oid": "",
            "hostid": "10254",
            "nome": "descoberto",
            "key_": "item[{#INAME}]",
            "atraso": "{#IUPDATE}",
            "história": "90d",
            "tendências": "30d",
            "estado": "0",
            "value_type": "3",
            "trapper_hosts": "",
            "unidades": "",
            "Fórmula": "",
            "erro": "",
            "logtimefmt": "",
            "templateid": "28255",
            "valuemap": "0",
            "parâmetros": "",
            "ipmi_sensor": "",
            "authtype": "0",
            "nome do usuário": "",
            "senha": "",
            "chave pública": "",
            "chave privada": "",
            "bandeiras": "2",
            "interfaceid": "2",
            "Descrição": "",
            "link_inventário": "0",
            "vida": "30d",
            "estado": "0",
            "evaltype": "0",
            "jmx_endpoint": "",
            "master_itemid": "0",
            "tempo limite": "3s",
            "url": "{#IURL}",
            "query_fields": [],
            "Postagens": "",
            "status_codes": "",
            "follow_redirects": "0",
            "post_type": "0",
            "proxy HTTP": "",
            "cabeçalhos": [],
            "recuperar_modo": "0",
            "request_method": "3",
            "output_format": "0",
            "ssl_cert_file": "",
            "ssl_key_file": "",
            "ssl_key_password": "",
            "verify_peer": "0",
            "verify_host": "0",
            "allow_traps": "0",
            "descobrir": "0",
            "parâmetros": []
        }
    ],
    "id": 17
}
```

[comment]: # ({/e5a65942-18563427})

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

- [Host](/manual/api/reference/host/object#host)
-   [Gráfico
    protótipo](/manual/api/reference/graphprototype/object#graph_prototype)
-   [Acionar
    protótipo](/manual/api/reference/triggerprototype/object#trigger_prototype)

[comment]: # ({/a0ef93a9-b9b138b8})

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

CItemPrototype::get() in
*ui/include/classes/api/services/CItemPrototype.php*.

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