Please add create_host example

[tjyang]

Hi @lebe-dev I was able to follow get_host example code to really get a host's information. Can you please add create_host example ?

• Searching the real EXAMPLE code

[zabbix-api-rs]$ egrep -r "\/\/\/\s\*\*" src
src/client/mod.rs:    /// **Example:**
[me@rocky9t01a zabbix-api-rs]$ egrep -r "\/\/\/\s\*\*Example" src
src/client/mod.rs:    /// **Example:**
[zabbix-api-rs]$

• this my attempt, still have lots of TBC.

  
  // https://www.zabbix.com/documentation/6.0/en/manual/api/reference/host/create
  // create requests json using json.
  //              "jsonrpc": "2.0",
  //    "method": "host.create",
  //    "params": {
  //        "host": "Linux server",
  //        "interfaces": [
  //            {
  //                "type": 1,
  //                "main": 1,
  //                "useip": 1,
  //                "ip": "192.168.3.1",
  //                "dns": "",
  //                "port": "10050"
  //            }
  //        ],
  //        "groups": [
  //            {
  //                "groupid": "50"
  //            }
  //        ],
  //        "tags": [
  //            {
  //                "tag": "Host name",
  //                "value": "Linux server"
  //            }
  //        ],
  //        "templates": [
  //            {
  //                "templateid": "20045"
  //            }
  //        ],
  //        "macros": [
  //            {
  //                "macro": "{$USER_ID}",
  //                "value": "123321"
  //            },
  //            {
  //                "macro": "{$USER_LOCATION}",
  //                "value": "0:0:0",
  //                "description": "latitude, longitude and altitude coordinates"
  //            }
  //        ],
  //        "inventory_mode": 0,
  //        "inventory": {
  //            "macaddress_a": "01234",
  //            "macaddress_b": "56768"
  //        }
  //    },
  //    "auth": "038e1d7b1735c6a5436ee9eae095879e",
  //    "id": 1
  //}
  #[derive(Serialize)]
  struct Host           {pub host: Vec<String>,}
  struct Interfaces     {pub interface: Vec<String>,}
  struct Groups         {pub groups: Vec<String>,}
  struct Tags           {pub tags: Vec<String>,}
  struct Templates      {pub templates: Vec<String>,}
  struct Macros         {pub macros: Vec<String>,}
  struct InventoryMode  {pub inventory_mode: Vec<String>,}
  struct Inventory      {pub inventory: Vec<String>,}
  let request = CreateHostRequest {
  host: "test01".to_owned(),
  interface: Interfaces {vec!["Zabbix server".to_string()]},
  groups: Vec<String>,
  tags: Vec<String>,
  templates: Vec<String>,
  macros: Vec<String>,
  inventory_mode: 0 ,
  inventory: Inventory {vec!["macaddress_a","macaddressb"]}
  };
  let http_client = ClientBuilder::new()
  .danger_accept_invalid_certs(false)
  .build()
  .unwrap();
  let client = ZabbixApiV6Client::new(http_client, DEFAULT_URL);
  let session = client.get_auth_session(DEFAULT_ADMIN, DEFAULT_PASSWORD).unwrap();
  match client.create_host(&session,&request) {
  Ok(hosts) => {
  //       println!("host.len()= {:?}",hosts.len());
  //       let host = hosts.first().unwrap();
  //       // assert_eq!(&host.host,"Zabbix server")
  //     println!("host: {:?}", host);
  }
  Err(e) => {
      eprintln!("host get error: {}", e);
      panic!("{}", e)
  }
  }

[lebe-dev]

Added doc for create_host method https://github.com/lebe-dev/zabbix-api-rs/blob/792f83c88967ae588fb7ab6b210400c12c7d6240/src/client/mod.rs#L80

If you want to use dev version you should add dependency

[dependencies]
...
zabbix-api = { git = "https://github.com/lebe-dev/zabbix-api-rs.git" }
...

[tjyang]

Thanks, let me try it and will close upon success.

[tjyang]

Thanks for the create host example, I was able to see it on zabbix web GUI after creating a test01.test.net host.

Can you add error handling after host creation ? based on zabbix_api::host::create::CreateHostResponse.

[lebe-dev]

Why? The last instruction uses .unwrap(), test fails if any error occurs.

For example of doctest: https://doc.rust-lang.org/rust-by-example/testing/doc_testing.html#motivation-behind-documentation-tests

[tjyang]

Thanks for the url pointer. I now understand why no need since it is a documentation tests