.werks/4700

   1 Title: WATO Web-API: Now able to configure host tags
   2 Level: 2
   3 Component: wato
   4 Compatible: compat
   5 Edition: cre
   6 Version: 1.5.0i1
   7 Date: 1495553122
   8 Class: feature
   9
  10 You can now configure the WATO Hosttags through the new API calls <tt>get_hosttags</tt> and <tt>set_hosttags</tt>.
  11
  12 Important: These API calls are intended for admin use only, since they modify the entire hosttags configuration.
  13
  14
  15 <tt>get_hosttags</tt><br>
  16 This API call does not require any additional info. It simply returns a dictionary with all tag_group and aux_tags.
  17 The response also includes an extra key <tt>configuration_hash</tt>, which can be used in the following call.
  18
  19 <tt>set_hosttags</tt><br>
  20 The previous call provided a dict with the hosttags configuration. This call expect the same format
  21 in the request object. You can modify the modify the previously queried dict and send it back.
  22 If you also sent the configuration_hash parameter, the Web-API will check if the configuration has changed
  23 in the meantime. If so, the set_hosttags call will fail. When no configuration_hash parameter is sent,
  24 no checking will be done and the configuration is completely overwritten.
  25 However, there are some final checks before the configuration is applied.
  26 First of all, the syntax and dependencies are checked.
  27 Furthermore, the api call checks whether all explicitely configured host tags are still present in the updated
  28 configuration. You can not set hosttags when the operation would introduce corrupt host tag settings.