op5util 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 107908b5501c4f587f9d1d1ff3f2f90eb5396519
+  data.tar.gz: 2f6e63fea64bc6ed7c29cae3f44b9488d34f0223
+SHA512:
+  metadata.gz: 4870871536c87d7127b45b956baadfa7e9e31c0f65dd789f2cbd5b2d000abc3186861fc80ad6dd9d8f316fb8a81c4b72862c093dc62d1312b5d38e4501ace6dd
+  data.tar.gz: 62cb31a8c2a0a975f2a328902b9234d903b24c1fcb2405aa83e360e92b98809da230b59e23236c6ff10de2bf903b56f5ba8b18ad591f0435b2f33d9090418f43

data/.gitignore

@@ -0,0 +1,7 @@
+pkg/*/
+!pkg/*pkg
+*~
+.bundle/
+vendor/
+pkg/op5util-0.0.*.gem
+.DS_Store

data/Gemfile

@@ -0,0 +1,12 @@
+source 'https://rubygems.org'
+gemspec
+gem 'colorize'
+gem 'httparty'
+gem 'terminal-table'
+
+group :development do
+  gem 'awesome_print'
+  gem 'rake'
+  gem 'rdoc'
+  gem 'test-unit'
+end

data/Gemfile.lock

@@ -0,0 +1,42 @@
+PATH
+  remote: .
+  specs:
+    op5util (0.1.1)
+      colorize (= 0.8.1)
+      gli (= 2.16.1)
+      httparty (= 0.15.5)
+      terminal-table (= 1.8.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    awesome_print (1.7.0)
+    colorize (0.8.1)
+    gli (2.16.1)
+    httparty (0.15.5)
+      multi_xml (>= 0.5.2)
+    multi_xml (0.6.0)
+    power_assert (0.2.6)
+    rake (12.0.0)
+    rdoc (5.1.0)
+    terminal-table (1.8.0)
+      unicode-display_width (~> 1.1, >= 1.1.1)
+    test-unit (3.2.5)
+      power_assert
+    unicode-display_width (1.2.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  awesome_print
+  colorize
+  httparty
+  op5util!
+  rake
+  rdoc
+  terminal-table
+  test-unit
+
+BUNDLED WITH
+   1.15.1

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Niklas Paulsson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.rdoc

@@ -0,0 +1,6 @@
+= op5util
+
+Describe your project here
+
+:include:op5util.rdoc
+

data/Rakefile

@@ -0,0 +1,16 @@
+require 'rake/clean'
+require 'rubygems'
+require 'rubygems/package_task'
+require 'rdoc/task'
+Rake::RDocTask.new do |rd|
+  rd.main = "README.rdoc"
+  rd.rdoc_files.include("README.rdoc","lib/**/*.rb","bin/**/*")
+  rd.title = 'Your application title'
+end
+
+spec = eval(File.read('op5util.gemspec'))
+
+Gem::PackageTask.new(spec) do |pkg|
+end
+
+task :default => [:test]

data/Readme.md

@@ -0,0 +1,180 @@
+## Op5util
+
+Are you using Op5? Perhaps you do most of your work from the command-line
+and want to be able to do the most common Op5 tasks without logging in
+to a web-gui?
+
+Or you want to start monitoring the newly installed hosts with Op5
+using your config management tool?
+
+Those two use-cases were my biggest itches when I first started to use
+saved curl commands to interact with the REST-api and soon op5util.rb
+was born.
+
+The design nowdays is reasonable modular so new functions can be easily
+added if they are needed, pull requests are happily accepted.
+
+I use op5util daily in a production environment, but it comes with no
+warranties.
+
+## Capabilities
+
+Currently op5util have implemented these functions:
+
+* Add a new host to be monitored by Op5
+* Add a existing host to more hostgroups
+* Schedule downtime for a host
+* Show status summary of all services/host and summary of service per host
+* Show status summary of services for a host and list all services w. status for a host
+* Schedule forced checks of a host and the hosts services to be done now
+* List all hostgroups available, including members and service checks
+
+These are the most common vanilla administrative tasks I perform to keep
+the networked monitored.
+
+## Screenshots, example usage
+
+A few usage example and the output from op5util.
+
+### Add a host to op5, check host status
+
+Adding a host using ```op5util add -g linux_hosts wiki``` and at the same time assigning
+membership in the linux_hosts hostgroup for the host, so some standard service checks are
+defined.
+
+To avoid waiting for checks to be performed on the new host, we tell Op5 to check them
+now with the command ```op5util schedule wiki```, and after only a short wait we can
+take a look at the detailed host status with ```op5util status -l wiki```.
+
+![Usage example](https://raw.githubusercontent.com/np422/Op5util/master/screenshots/usecase2.png)
+
+The newly added host in normal web-gui.
+
+![web-gui](https://raw.githubusercontent.com/np422/Op5util/master/screenshots/host_op5.png)
+
+And the same host in a Op5 listview with service state after services was checked, as comparison
+with the terminal output by op5util.
+
+![web-gui](https://raw.githubusercontent.com/np422/Op5util/master/screenshots/host_op5_listview.png)
+
+
+### Another use case
+
+Op5util is installed using ```gem install pkg/0.1.0.pkg```
+
+The export of the environment variable MONITOR is to avoid using the command-line
+flag ```-m monitor.ipa.hemma``` on every command, and by saving credentials in the in the .op5pass
+file you don't need type the -u/-p thereafter.
+
+Check the overall status with the command ```op5util status```, as one host is down we request more
+info to be displayed with ```op5util status -l```, and we see that the host gitlab01 is down, to
+acknowledge the alarms, ```op5util acknowledge gitlab01```.
+
+Once the problem is resolved and the host is up, ```op5util schedule gitlab01, because impatience,
+ a final check with ```op5util status gitlab01```.
+
+![screenshot](https://raw.githubusercontent.com/np422/Op5util/master/screenshots/usecase1.png)
+
+## Installation
+
+Download the latest pkg/op5util-0.X.Y.gem from this repo and install using
+```shell
+gem install op5util-0.1.0.gem
+```
+
+## Usage
+
+There is no man-page, but the built in help text should do the job.
+
+If you enter the command ```op5util help``` the top-level documentation is displayed.
+
+IMHO git has very good command line interface and I've tried to make op5util to do user
+interaction in the same spirit as git.
+
+
+``` text
+NAME
+    op5util - A small utility to perform common Op5 administration tasks from the command line
+
+    About authentication, if you supply username/password as command-line flags they will be
+    used first. If username/password options isn't supplied on the command-line, the environment
+    variables OP5USER and OP5PASS will be used. If there are no environment variables present,
+    the file ~/.op5pass (or --authfile=) will be read. The file format is a single line with
+    username and password separated by a : (colon). The supplied credentials shoud be an
+    account with administrative privileges.
+
+    This application uses the REST-api described at https://your.op5.sever/api/help. Although
+    TLS/SSL is used, no verification of the certificate is done as most Op5-servers have a
+    self-signed certificate.
+
+SYNOPSIS
+    op5util [global options] command [command options] [arguments...]
+
+VERSION
+    0.0.9
+
+GLOBAL OPTIONS
+    -f, --authfile=authfile - Authfile containing "username:password" used to authenticate
+                              with Op5 server (default: ~/.op5pass)
+    --help                  - Show this message
+    -m, --monitor=monitor   - Hostname or IP-address of the Op5 monitor server, if not supplied
+                              the environment variable MONITOR will be used (default: none)
+    -p, --password=password - Password used to authenticate with the Op5 server, if not supplied
+                              the environment variable OP5PASS will be used (default: none)
+    -u, --username=username - Username used to authenticate with the Op5 server, if not supplied
+                              the environment variable OP5USER will be used (default: none)
+    --version               - Display the program version
+
+COMMANDS
+    acknowledge    - Acknowledge outstanding host and service alarms.
+    add            - Add a new host to be monitored by the Op5 server
+    add_hostgroups - Add host to a new hostgroup(s)
+    downtime       - Schedule fixed downtime for a host
+    help           - Shows a list of commands or help for one command
+    hostgroups     - List hostgroups, optionally with member and service info
+                     to list members and services for the linux_hosts hostgroup
+    schedule       - Schedule host and all host services checks to be performed swiftly for the given host
+    status         - Show monitoring status, if no host is given all hosts/services are included
+
+```
+
+### Command usage
+
+To get information about a specific command, use ```op5util help add``` , example below.
+
+``` textNAME
+    add - Add a new host to be monitored by the Op5 server
+
+SYNOPSIS
+    op5util [global options] add [command options] hostname
+
+DESCRIPTION
+    The host is added using mostly default values for max_check_attempts (3),
+    notification_interval (0, aka notify once), notification_period (24x7), etc
+    using the default-host-template. For most off-the-shelf newly installed
+    servers these values usually are sufficient and can be fine-tuned using
+    the web-gui if so should be needed.
+
+COMMAND OPTIONS
+    -a, --alias=arg         - Alias for host, defaults to hostname with the domain name
+                              removed (default: none)
+    -c, --contactgroups=arg - Contact groups for host, defaults to "support_group" (may
+                              be used more than once, default: ["support-group"])
+    -g, --hostgroups=arg    - Hostgroup(s) to which the new host will be added (may be
+                              used more than once, default: none)
+    -i, --ipaddr=arg        - IP-address of host, resolved with DNS from hostname if
+                              not supplied (default: none)
+```
+
+
+## Roadmap, TODO
+
+A lot remains, the code really should be DRY'ied up, more automated pre-release tests, more
+documentation and perhaps even adding some more functions, but the current version of op5util
+is already useful to me in my day-time job, perhaps it also could be useful to other Op5
+administrators?
+
+Please, give my repo a github star or drop me line if you find this utility useful. Feel
+free to leave a bug-reports or feature requests as an issue in this repo.
+
+/Niklas

data/bin/op5util

@@ -0,0 +1,180 @@
+#!/usr/bin/env ruby
+
+# rubocop:disable Lint/UnneededDisable, LineLength, AbcSize, SymbolArray, MethodLength, HashSyntax
+
+require 'gli'
+require 'op5util'
+
+include GLI::App
+
+program_desc 'A small utility to perform common Op5 administration tasks from the command line'
+program_long_desc '
+About authentication, if you supply username/password as command-line flags they will be used first. If username/password options isn\'t supplied on the command-line, the environment variables OP5USER and OP5PASS will be used. If there are no environment variables present, the file ~/.op5pass (or --authfile=)  will be read. The file format is a single line with username and password separated by a : (colon). The supplied credentials shoud be an account with administrative privileges.
+
+This application uses the REST-api described at https://your.op5.sever/api/help. Although TLS/SSL is used, no verification of the certificate is done as most Op5-servers have a self-signed certificate.'
+
+version Op5util::VERSION
+
+subcommand_option_handling :normal
+arguments :strict
+
+monitor = nil
+
+desc 'Username used to authenticate with the Op5 server, if not supplied the environment variable OP5USER will be used'
+arg_name 'username'
+flag [:u, :username]
+
+desc 'Password used to authenticate with the Op5 server, if not supplied the environment variable OP5PASS will be used'
+arg_name 'password'
+flag [:p, :password]
+
+desc 'Hostname or IP-address of the Op5 monitor server, if not supplied the environment variable MONITOR will be used'
+arg_name 'monitor'
+flag [:m, :monitor]
+
+desc 'Authfile containing "username:password" used to authenticate with Op5 server'
+default_value '~/.op5pass'
+arg_name 'authfile'
+flag [:f, :authfile]
+
+desc 'Add a new host to be monitored by the Op5 server'
+long_desc 'The host is added using mostly default values for max_check_attempts (3), notification_interval (0, aka notify once), notification_period (24x7), etc using the default-host-template. For most off-the-shelf newly installed servers these values usually are sufficient and can be fine-tuned using the web-gui if so should be needed.'
+arg_name 'hostname'
+command :add do |c|
+  c.desc 'Alias for host, defaults to hostname with the domain name removed'
+  c.flag [:a, :alias]
+
+  c.desc 'Hostgroup(s) to which the new host will be added'
+  c.flag [:g, :hostgroups], :multiple => true
+
+  c.desc 'Contact groups for host, defaults to "support_group"'
+  c.default_value ['support-group']
+  c.flag [:c, :contactgroups], :multiple => true
+
+  c.desc 'IP-address of host, resolved with DNS from hostname if not supplied'
+  c.flag [:i, :ipaddr]
+
+  c.action do |_global_options, options, args|
+    # Your command logic here
+    # If you have any errors, just raise them
+    # raise "that command made no sense"
+    monitor.add_host(args[0], options)
+  end
+end
+
+desc 'Add host to a new hostgroup(s)'
+long_desc 'Example: "op5util add_hostgroups -g linux_hosts -g webservers web-vl131-zrh" will add the host web-vl131-zrh to the hostgroups linux_hosts and webservers'
+arg_name 'host'
+command :add_hostgroups do |c|
+  c.desc 'Hostgroup(s) that host should be a member of'
+  c.flag [:g, :hostgroups], :multiple => true
+
+  c.action do |_global_options, options, args|
+    monitor.add_hostgroups(args[0], options[:hostgroups])
+  end
+end
+
+desc 'Schedule fixed downtime for a host'
+arg_name 'host'
+command :downtime do |c|
+  c.desc 'Duration of downtime, in number of hours'
+  c.default_value '2'
+  c.flag [:t, :time]
+
+  c.desc 'Start downtime in X hours. If not given, downtime starts now'
+  c.default_value 0
+  c.flag [:w, :wait]
+
+  c.desc 'Comment on reason for downtime downtime'
+  c.default_value 'Temporary downtime due to system administration'
+  c.flag [:c, :comment]
+
+  c.action do |_global_options, options, args|
+    monitor.schedule_downtime(args[0], options)
+  end
+end
+
+desc 'Show monitoring status, if no host is given all hosts/services are included'
+arg_name 'host'
+command :status do |c|
+  c.desc 'Print only a brief status information with stats summarized'
+  c.switch [:s, :short]
+
+  c.desc 'Print a summary with hosts listed and service information per hsot'
+  c.switch [:l, :long]
+
+  c.action do |_global_options, options, args|
+    if args.count.zero?
+      monitor.status_summary(options)
+    else
+      monitor.status_host(args[0], options)
+    end
+  end
+end
+
+desc 'Acknowledge outstanding host and service alarms, without host - *ALL* outstanding alarms and services are acknowledged, ackn is "sticky" - it lasts until host/service recovery.'
+arg_name 'host'
+command :acknowledge do |c|
+  c.desc 'comment on acknowledgement'
+  c.default_value 'Work in progress to resolve problem'
+  c.flag [:c, :comment]
+
+  c.desc 'Make comment persistent after problems are resolved'
+  c.switch [:p, :persistent]
+
+  c.desc 'Print more verbose output'
+  c.switch [:v, :verbose]
+
+  c.action do |_global_options, options, args|
+    if args[0].nil?
+      monitor.acknowledge_all_alarms(options)
+    else
+      monitor.acknowledge_host_alarms(args[0], options)
+    end
+  end
+end
+
+desc 'Schedule host and all host services checks to be performed swiftly for the given host'
+arg_name 'host'
+command :schedule do |c|
+  c.desc 'Print more information about progress'
+  c.switch [:v, :verbose]
+
+  c.action do |_global_options, options, args|
+    monitor.schedule_checks(args[0], options)
+  end
+end
+
+desc 'List hostgroups, optionally with member and service info, Usage examples: \'op5util hostgroups\' to list all hostgroups, \'op5util hostgroups -l linux_hosts\' to list members and services for the linux_hosts hostgroup'
+arg_name 'hostgroup'
+command :hostgroups do |c|
+  c.desc 'Include servicechecks and hosts for hostgroup in output, warning - this may take time if done for all hostgroups'
+  c.switch [:l, :long]
+
+  c.action do |_global_options, options, args|
+    monitor.list_hostgroups(args[0], options)
+  end
+end
+
+pre do |global, _command, _options, _args|
+  Op5util.check_auth(global) ? true : false
+  if global[:monitor].nil? && ENV['MONITOR'].nil?
+    false
+  else
+    global[:monitor] = ENV['MONITOR'] if global['monitor'].nil?
+    monitor = Op5util::Monitor.new(global[:monitor],
+                                   global[:username],
+                                   global[:password])
+    true
+  end
+end
+
+on_error do |exception|
+  # Error logic here
+  # return false to skip default error handling
+  # TODO: Catch error and print an apropriate message
+  puts "Error, #{exception}"
+  false
+end
+
+exit run(ARGV)

data/lib/op5util/acknowledge_alarm.rb

@@ -0,0 +1,86 @@
+# rubocop:disable LineLength, AbcSize
+# Foo
+module Op5util
+  # Foo
+  class Monitor
+    def acknowledge_host_alarms(host, options)
+      host_states = host_status(host)
+      if host_states[:host] > 0
+        puts 'Acknowledge host alarm for host ' + host
+        ack_host_alarm(host, options)
+      else
+        puts 'No alarm for host ' + host + ', not acking host'
+      end
+      if host_states[:services].count > 0
+        host_states[:services].each do |s|
+          ack_host_service(host, s, options)
+          puts "Service \"#{s}\" acknowledged" if options[:verbose]
+        end
+        puts 'All service alarms for host ' + host + ' acknowledged'
+      else
+        puts "No service alarms to acknowledge for host #{host}"
+      end
+    end
+
+    def acknowledge_all_alarms(options)
+      response = self.class.get(@base_uri + 'config/host?format=json',
+                                basic_auth: @auth, verify: false)
+      raise ApiError unless response.code == 200
+      JSON.parse!(response.body).map { |h| h['name'] }.each do |host|
+        acknowledge_host_alarms(host, options)
+      end
+    end
+
+    private
+
+    def ack_host_alarm_body(host, options)
+      {
+        host_name:   host,
+        sticky:      true,
+        notify:      true,
+        persistent:  options[:persistent],
+        comment:     options[:comment]
+      }.to_json
+    end
+
+    def ack_host_alarm(host, options)
+      body = ack_host_alarm_body(host, options)
+      response = self.class.post(@base_uri + 'command/ACKNOWLEDGE_HOST_PROBLEM?format=json',
+                                 headers: { 'Content-Type' => 'application/json' },
+                                 body: body, basic_auth: @auth, verify: false)
+      raise ApiError unless response.code == 200
+      puts 'Host alarm acknowledged'
+    end
+
+    def ack_host_service_alarm_body(host, service, options)
+      {
+        host_name:           host,
+        service_description: service,
+        sticky:              true,
+        notify:              true,
+        persistent:          options[:persistent],
+        comment:             options[:comment]
+      }.to_json
+    end
+
+    def ack_host_service(host, service, options)
+      body = ack_host_service_alarm_body(host, service, options)
+      response = self.class.post(@base_uri + 'command/ACKNOWLEDGE_SVC_PROBLEM?format=json',
+                                 headers: { 'Content-Type' => 'application/json' },
+                                 body: body, basic_auth: @auth, verify: false)
+      raise ApiError unless response.code == 200
+      puts "Alarm for service \"#{service}\" acknowledged" if options[:verbose]
+    end
+
+    def host_status(host)
+      response = self.class.get(@base_uri + "status/host/#{host}?format=json",
+                                basic_auth: @auth, verify: false)
+      raise ApiError unless response.code == 200
+      state = JSON.parse!(response.body)
+      {
+        host:     state['hard_state'],
+        services: state['services_with_state'].select { |s| s[1] > 0 }.map { |s| s[0] }
+      }
+    end
+  end
+end

data/lib/op5util/add_host.rb

@@ -0,0 +1,61 @@
+# rubocop:disable Lint/UnneededDisable
+# rubocop:disable LineLength
+# rubocop:disable AbcSize
+# rubocop:disable SymbolArray
+# rubocop:disable Metrics/MethodLength
+# rubocop:disable HashSyntax
+# Foo
+module Op5util
+  require 'resolv'
+  class ApiError < StandardError; end
+  # Foo
+  class Monitor
+    def add_host(host, options)
+      body = build_add_host_request_body(host, options)
+      response = self.class.post(@base_uri + 'config/host',
+                                 headers: { 'Content-Type' => 'application/json' },
+                                 body: body, basic_auth: @auth, verify: false)
+      raise ApiError, "Response code: #{response.code}, Message: #{response.body}" if response.code != 201
+      puts 'New host created'
+
+      url = @base_uri + 'config/change'
+      response = self.class.post(url, body: {}, basic_auth: @auth, verify: false)
+      raise ApiError, "Response code: #{response.code}, Message: #{response.body}" if response.code != 200
+      puts 'New op5-config saved'
+    end
+
+    private
+
+    def build_add_host_request_body(host, options)
+      host_ipaddr   = options[:ipaddr].nil? ? Resolv.getaddress(host) : options[:ipaddr]
+      host_alias    = options[:alias].nil? ? short_name(host) : options[:alias]
+      contactgroups = options[:contactgroups].nil? ? ['support-group'] : options[:contactgroups]
+      hostgroups    = options[:hostgroups].nil? ? [] : options[:hostgroups]
+      add_host_request_body_as_json(host, host_ipaddr, host_alias, contactgroups, hostgroups)
+    end
+
+    def add_host_request_body_as_json(host, host_ipaddr, host_alias, contactgroups, hostgroups)
+      { file_id:                   'etc/hosts.cfg',
+        host_name:                 host.to_s,
+        address:                   host_ipaddr.to_s,
+        alias:                     host_alias.to_s,
+        max_check_attempts:        3,
+        notification_interval:     0,
+        notification_options:      %w[d u r],
+        notification_period:       '24x7',
+        notifications_enabled:     true,
+        template:                  'default-host-template',
+        contact_groups:            contactgroups,
+        hostgroups:                hostgroups }.to_json
+    end
+
+    def short_name(h)
+      split_host = h.split('.')
+      if split_host.count > 1
+        split_host[0]
+      else
+        ''
+      end
+    end
+  end
+end

data/lib/op5util/add_hostgroups.rb

@@ -0,0 +1,48 @@
+# rubocop:disable Lint/UnneededDisable, LineLength, AbcSize, SymbolArray, MethodLength, HashSyntax
+# Foo
+module Op5util
+  class NoSuchHostgroupError < StandardError; end
+  class NoSuchHostError < StandardError; end
+  # Foo
+  class Monitor
+    def add_hostgroups(host, hostgroups)
+      hostgroups.each do |group|
+        members = get_hostgroup_members(group)
+        if !members.grep(host).empty?
+          puts "Host #{host} is already a member of hostgroup #{group}"
+        else
+          raise NoSuchHostError, host unless host_exist?(host)
+          members << host
+          update_hostgroup(group, members)
+        end
+      end
+    end
+
+    private
+
+    def get_hostgroup_members(group)
+      response = self.class.get(@base_uri + "config/hostgroup/#{group}?format=json",
+                                basic_auth: @auth, verify: false)
+      raise NoSuchHostgroupError if response.code == 404
+      JSON.parse!(response.body)['members']
+    end
+
+    def host_exist?(host)
+      response = self.class.get(@base_uri + "config/host/#{host}?format=json",
+                                basic_auth: @auth, verify: false)
+      raise NoSuchHostError if response.code == 404
+      raise ApiError if response.code != 200
+      true
+    end
+
+    def update_hostgroup(hostgroup, members)
+      body = { file_id:         'etc/hostgroups.cfg',
+               hostgroup_name:  hostgroup.to_s,
+               members:         members }.to_json
+      response = self.class.patch(@base_uri + "config/hostgroup/#{hostgroup}",
+                                  headers: { 'Content-Type' => 'application/json' },
+                                  body: body, basic_auth: @auth, verify: false)
+      raise ApiError unless response.code == 200
+    end
+  end
+end