Samanage Ruby Gem

Requirements

• Ruby >= 2.3

Installation

gem install samanage

Usage

Basic Queries

Initialize API controller

    samanage = Samanage::Api.new(token: 'abc123')

• Create a user

  user = {user: { name: 'John Doe', email: 'john.doe@example.com'}}
  samanage.create_user(payload: user)
  

• Find a user by email

  my_user = samanage.find_user_by_email(email: 'user@example.com')
  

• Update incident by ID

  incident_data = {incident: { priority: 'Critical' }}
  incident_update = samanage.update_incident(id: 123, payload: incident_data)
  

• Update hardware

  hardware = {hardware: {name: 'Cool New Hostname'}}
  result = samanage.update_hardware(id: 123, payload: hardware)
  

• Use Filters

  incidents_updated_today = samanage.incidents(options: {'updated' => 1})
  expired_hardwares = samanage.hardwares(options: {'warranty_status[]' => 'Expired'})
  

Listing and Searching

• Find All Users ruby users = samanage.users # returns all users

• Filtering Incidents matching custom field and updated in the last 7 days

  incidents = samanage.incidents(options: {'Custom Field' => 'Some Value', 'updated[]' => 7})
  

• Listing / Searching also responds to blocks

  api.controller.users(options: {'Some Filter' => 'Some Value'}) do |user|
  if user['email'].match(/something/)
  foo(bar: bar, user: user)
  else
  puts "User #{user['email']} did not match"
  end
  end
  

Executing an api query will return a Hash with the following keys:

• :response: unparsed http response
• :code: http status code
• :json: Samanage API json response
• :headers: Response headers
• :total_pages: Total pages
• :total_count: Total count of records
• :data: Hash containing response body