Zabbix Documentation 5.0

3.04.05.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.24.4Guidelines

User Tools

Site Tools


pt:manual:api

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
pt:manual:api [2016/01/01 13:07]
spaww created
pt:manual:api [2019/10/07 06:35] (current)
Line 43: Line 43:
 Antes de você acessar qualquer dado dentro do Zabbix você precisa se autenticar e obter um token de autenticação. Isso pode ser feito utilizando ​ o método ''​[[pt:​manual:​api:​reference:​user:​login|user.login]]''​. Vamos supor que você queira se autenticar como um usuário comum do Zabbix. A requisição JSON a seguir poderia fazer isso: Antes de você acessar qualquer dado dentro do Zabbix você precisa se autenticar e obter um token de autenticação. Isso pode ser feito utilizando ​ o método ''​[[pt:​manual:​api:​reference:​user:​login|user.login]]''​. Vamos supor que você queira se autenticar como um usuário comum do Zabbix. A requisição JSON a seguir poderia fazer isso:
  
-<​code ​js>+<​code ​java>
 { {
     "​jsonrpc":​ "​2.0",​     "​jsonrpc":​ "​2.0",​
Line 65: Line 65:
 Se você oferecer as credenciais corretamente ,a resposta retornada pela API será o token de autenticação:​ Se você oferecer as credenciais corretamente ,a resposta retornada pela API será o token de autenticação:​
  
-<​code ​js>+<​code ​java>
 { {
     "​jsonrpc":​ "​2.0",​     "​jsonrpc":​ "​2.0",​
Line 82: Line 82:
 Agora podemos utilizar o token de autenticação para acessar dados no Zabbix. Por exemplo, vamos utilizar o método ''​[[pt:​manual:​api:​reference:​host:​get|host.get]]''​ para recuperar os IDs, nomes e interfaces de todos os  [[pt:​manual:​api:​reference:​host:​object|hosts]] que o usuário tiver acesso: Agora podemos utilizar o token de autenticação para acessar dados no Zabbix. Por exemplo, vamos utilizar o método ''​[[pt:​manual:​api:​reference:​host:​get|host.get]]''​ para recuperar os IDs, nomes e interfaces de todos os  [[pt:​manual:​api:​reference:​host:​object|hosts]] que o usuário tiver acesso:
  
-<​code ​js>+<​code ​java>
 { {
     "​jsonrpc":​ "​2.0",​     "​jsonrpc":​ "​2.0",​
Line 104: Line 104:
  
 O objeto de resposta irá conter o dado sobre os hosts que foi requisitado:​ O objeto de resposta irá conter o dado sobre os hosts que foi requisitado:​
-<​code ​js>+<​code ​java>
 { {
     "​jsonrpc":​ "​2.0",​     "​jsonrpc":​ "​2.0",​
Line 129: Line 129:
 Vamos criar um novo [[pt:​manual:​api:​reference:​item:​object|item]] no "​Zabbix server"​ usando os dados que obtivemos através do método anterior ( ''​host.get''​). ISso pode ser feito através do método ''​[[pt:​manual:​api:​reference:​item:​create|item.create]]'':​ Vamos criar um novo [[pt:​manual:​api:​reference:​item:​object|item]] no "​Zabbix server"​ usando os dados que obtivemos através do método anterior ( ''​host.get''​). ISso pode ser feito através do método ''​[[pt:​manual:​api:​reference:​item:​create|item.create]]'':​
  
-<​code ​js>+<​code ​java>
 { {
     "​jsonrpc":​ "​2.0",​     "​jsonrpc":​ "​2.0",​
Line 149: Line 149:
 Uma resposta bem sucedida irá conter o ID do novo item criado, que poderá ser utilizado mas próximas referências:​ Uma resposta bem sucedida irá conter o ID do novo item criado, que poderá ser utilizado mas próximas referências:​
  
-<​code ​js>+<​code ​java>
 { {
     "​jsonrpc":​ "​2.0",​     "​jsonrpc":​ "​2.0",​
Line 167: Line 167:
 Até este ponto tudo o que tentamos deve ter funcionado corretamente. Mas o que aconteceria se nós tentássemos uma chamada incorreta à API? Vamos tentar criar outra chamada ao método ''​[[pt:​manual:​api:​reference:​host:​create|host.create]]'',​ mas omitindo a propriedade obrigatória ​ ''​groups''​ .  Até este ponto tudo o que tentamos deve ter funcionado corretamente. Mas o que aconteceria se nós tentássemos uma chamada incorreta à API? Vamos tentar criar outra chamada ao método ''​[[pt:​manual:​api:​reference:​host:​create|host.create]]'',​ mas omitindo a propriedade obrigatória ​ ''​groups''​ . 
  
-<​code ​js>+<​code ​java>
 { {
     "​jsonrpc":​ "​2.0",​     "​jsonrpc":​ "​2.0",​
Line 191: Line 191:
 A resposta desta requisição irá conter uma mensagem de erro: A resposta desta requisição irá conter uma mensagem de erro:
  
-<​code ​js>+<​code ​java>
 { {
     "​jsonrpc":​ "​2.0",​     "​jsonrpc":​ "​2.0",​