Documentation
Table of Contents
host.update
Descri??o
object host.update(object/array hosts)
Este m¨¦todo permite atualizar os hosts 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 host a serem atualizadas.
A propriedade hostid deve ser definida para cada host, todos os outros propriedades s?o opcionais. Somente as propriedades fornecidas ser?o atualizadas, todas outros permanecer?o inalterados.
Observe, no entanto, que atualizar o nome t¨¦cnico do host tamb¨¦m atualizar¨¢ o nome vis¨ªvel do host (se n?o fornecido ou vazio) pelo t¨¦cnico do host valor do nome.
Al¨¦m das propriedades padr?o do host, o m¨¦todo aceita os seguintes par?metros.
|Par?metro|Tipo|Descri??o| |---------|----------------------------------- ------------|-----------| |groups|object/array|Host groups para substituir os grupos de hosts atuais aos quais o host pertence.
Os grupos de hosts devem ter o groupid propriedade definida. Todos os grupos de hosts que n?o est?o listados na solicita??o ser?o desvinculados.| |interfaces|object/array|Host interfaces para substituir as interfaces de host atuais.
Todas as interfaces que n?o estiverem listadas na solicita??o ser?o removidas.| |tags|object/array|Host tags para substituir as tags de host atuais.
Todas as tags que n?o estiverem listadas na solicita??o ser?o removidas .| |¾±²Ô±¹±ð²Ô³Ù¨¢°ù¾±´Ç|objeto|Host ¾±²Ô±¹±ð²Ô³Ù¨¢°ù¾±´Ç propriedades.| |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.| |templates|object/array|Templates para substituir os templates atualmente vinculados. Todos os modelos que n?o estiverem listados na solicita??o ser?o apenas desvinculados.
Os modelos devem ter a propriedade templateid definida.| |templates_clear|object/array|Templates para desvincular e limpar do host.
Os templates devem ter a propriedade templateid definida.|
Ao contr¨¢rio do frontend Áú»¢¶Ä²©, quando name (vis¨ªvel nome do host) ¨¦ o mesmo que host (nome t¨¦cnico do host), atualizando o host via API n?o atualizar¨¢ automaticamente name. Ambas as propriedades precisam ser atualizado explicitamente.
Valores de retorno
(object) Retorna um objeto contendo os IDs dos hosts atualizados sob a propriedade hostids.
Exemplos
Habilitando um host
Habilite o monitoramento do host, ou seja, defina seu status como 0.
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "host.update",
"par?metros": {
"hostid": "10126",
"estado": 0
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
Desvinculando modelos
Desvincule e limpe dois modelos do host.
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "host.update",
"par?metros": {
"hostid": "10126",
"templates_clear": [
{
"templateid": "10124"
},
{
"templateid": "10125"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
Atualizando macros de host
Substitua todas as macros de host por duas novas.
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "host.update",
"par?metros": {
"hostid": "10126",
"macros": [
{
"macro": "{$PASS}",
"valor": "senha"
},
{
"macro": "{$DISC}",
"valor": "sda",
"description": "Descri??o atualizada"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
Atualizando o ¾±²Ô±¹±ð²Ô³Ù¨¢°ù¾±´Ç do host
Alterar o modo de ¾±²Ô±¹±ð²Ô³Ù¨¢°ù¾±´Ç e adicionar local
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "host.update",
"par?metros": {
"hostid": "10387",
"modo_¾±²Ô±¹±ð²Ô³Ù¨¢°ù¾±´Ç": 0,
"¾±²Ô±¹±ð²Ô³Ù¨¢°ù¾±´Ç": {
"location": "Let?nia, Riga"
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
Atualizando tags de host
Substitua todas as tags de host por uma nova.
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "host.update",
"par?metros": {
"hostid": "10387",
"Tag": {
"tag": "SO",
"valor": "CentOS 7"
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
Updating discovered host macros
Convert discovery rule created "automatic" macro to "manual" and change its value to "new-value".
Request:
{
"jsonrpc": "2.0",
"method": "host.update",
"params": {
"hostid": "10387",
"macros": {
"hostmacroid": "5541",
"value": "new-value",
"automatic": "0"
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Response:
Updating host encryption
Update the host "10590" to use PSK encryption only for connections from host to Áú»¢¶Ä²© server. In addition, update the PSK identity and PSK key for this host. Note that the Áú»¢¶Ä²© agent that is installed on the host has to be configured to use PSK.
{
"jsonrpc": "2.0",
"method": "host.update",
"params": {
"hostid": "10590",
"tls_connect": 1,
"tls_accept": 2,
"tls_psk_identity": "PSK 002",
"tls_psk": "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9"
},
"id": 1
}Response:
Veja tamb¨¦m
- host.massadd
- host.massupdate
- host.massremove
- Grupo de hosts
- Modelo
- Do utilizador macro
- Hospedeiro interface
- Invent¨¢rio do host
- Tag do host
Fonte
CHost::update() em ui/include/classes/api/services/CHost.php.