[comment]: # aside: 1

[comment]: # ({ee2c7113-41154bde})
# Objeto de mapa de valores

Os seguintes objetos estão diretamente relacionados à API `valuemap`.

[comment]: # ({/ee2c7113-41154bde})

[comment]: # ({aec7b0d0-65471f47})
### Mapa de valores

O objeto mapa de valores possui as seguintes propriedades.

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|valuemapid|ID|ID do mapa de valores.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*<br>- *obrigatório* para operações de atualização|
|hostid|ID|ID do host ou template ao qual o mapa de valores pertence.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *constante*<br>- *obrigatório* para operações de criação|
|name|string|Nome do mapa de valores.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* para operações de criação|
|mappings|array|Mapeamentos de valores para o mapa de valores atual. O objeto de mapeamento é [descrito em detalhes abaixo](object#value-mappings).<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* para operações de criação|
|uuid|string|Identificador universal único, usado para vincular mapas de valores importados aos já existentes. Gerado automaticamente, se não fornecido.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *suportado* se o mapa de valores pertencer a um template|

[comment]: # ({/aec7b0d0-65471f47})

[comment]: # ({5ff6d41b-145a9918})
#### Mapeamentos de valores

O objeto de mapeamentos de valores define os mapeamentos de valores do mapa de valores. Ele possui as seguintes propriedades.

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|type|integer|Tipo de correspondência do mapeamento.<br><br>Valores possíveis:<br>0 - *(padrão)* o mapeamento será aplicado se o valor for igual;<br>1 - o mapeamento será aplicado se o valor for maior ou igual^1^;<br>2 - o mapeamento será aplicado se o valor for menor ou igual^1^;<br>3 - o mapeamento será aplicado se o valor estiver em um intervalo (os intervalos são inclusivos; vários intervalos, separados por vírgula, podem ser definidos)^1^;<br>4 - o mapeamento será aplicado se o valor corresponder a uma expressão regular^2^;<br>5 - se nenhuma correspondência for encontrada, o mapeamento não será aplicado e o valor padrão será usado.<br><br>Se `type` for definido como "0", "1", "2", "3", "4", então `value` não pode estar vazio.<br><br>Se `type` for definido como "5", então `value` deve estar vazio.|
|value|string|Valor original.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* se `type` for definido como "1", "2", "3", "4"<br>- *suportado* se `type` for definido como "5"|
|newvalue|string|Valor para o qual o valor original é mapeado.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|

^1^ suportado apenas para items com tipo de valor "numérico sem sinal", "numérico flutuante".<br>
^2^ suportado apenas para items com tipo de valor "caractere".<br>

[comment]: # ({/5ff6d41b-145a9918})