grafana 0.8.2

data/lib/grafana/login.rb

@@ -0,0 +1,139 @@
+
+module Grafana
+
+  # Abstract base class for Login.
+  #
+  module Login
+
+    # Login into Grafana
+    #
+    # @param [Hash] params
+    # @option params [String] username username for the login
+    # @option params [String] password password for the login
+    # @option params [Integer] max_retries (2) maximum retries
+    # @option params [Integer] sleep_between_retries (5) sleep seconds between retries
+    #
+    # @example
+    #    login( username: 'admin', password: 'admin' )
+    #    login( username: 'admin', password: 'admin', max_retries: 10, sleep_between_retries: 8 )
+    #
+    # @return [Hash]
+    #
+    def login( params )
+
+      raise ArgumentError.new(format('wrong type. \'params\' must be an Hash, given \'%s\'', params.class.to_s)) unless( params.is_a?(Hash) )
+      raise ArgumentError.new('missing params') if( params.size.zero? )
+
+      username = validate( params, required: true, var: 'username', type: String )
+      password = validate( params, required: true, var: 'password', type: String )
+      max_retries = validate( params, required: false, var: 'max_retries', type: Integer ) || 2
+      sleep_between_retries = validate( params, required: false, var: 'sleep_between_retries', type: Integer ) || 5
+
+      begin
+        @api_instance = RestClient::Resource.new(
+          @url,
+          timeout: @timeout.to_i,
+          open_timeout: @open_timeout.to_i,
+          headers: @http_headers,
+          verify_ssl: false
+        )
+      rescue => e
+        logger.error( e ) if @debug
+        logger.debug( e.backtrace.join("\n") ) if @debug
+        false
+      end
+
+      request_data = { 'User' => username, 'Password' => password }
+
+      if( @api_instance )
+        retried ||= 0
+        response_cookies  = ''
+        @headers          = {}
+
+        begin
+          logger.debug('Attempting to establish user session') if @debug
+
+          response = @api_instance['/login'].post(
+            request_data.to_json,
+            content_type: 'application/json; charset=UTF-8'
+          )
+
+          response_cookies  = response.cookies
+          response_code     = response.code.to_i
+
+          if( response_code == 200 )
+            @headers = {
+              content_type: 'application/json',
+              accept: 'application/json',
+              cookies: response_cookies
+            }
+          end
+
+        rescue SocketError
+          if( retried < max_retries )
+            retried += 1
+            logger.debug( format( 'cannot login, socket error (retry %d / %d)', retried, max_retries ) ) if @debug
+            sleep( sleep_between_retries )
+            retry
+          else
+            raise format( 'Maximum retries (%d) against \'%s/login\' reached. Giving up ...', max_retries, @url )
+          end
+
+        rescue RestClient::Unauthorized
+          logger.debug( request_data.to_json ) if @debug
+          raise format( 'Not authorized to connect \'%s\' - wrong username or password?', @url )
+
+        rescue RestClient::BadGateway
+          if( retried < max_retries )
+            retried += 1
+            logger.debug( format( 'cannot login, connection refused (retry %d / %d)', retried, max_retries ) ) if @debug
+            sleep( sleep_between_retries )
+            retry
+          else
+            raise format( 'Maximum retries (%d) against \'%s/login\' reached. Giving up ...', max_retries, @url )
+          end
+
+        rescue Errno::ECONNREFUSED
+          if( retried < max_retries )
+            retried += 1
+            logger.debug( format( 'cannot login, connection refused (retry %d / %d)', retried, max_retries ) ) if @debug
+            sleep( sleep_between_retries )
+            retry
+          else
+            raise format( 'Maximum retries (%d) against \'%s/login\' reached. Giving up ...', max_retries, @url )
+          end
+
+        rescue Errno::EHOSTUNREACH
+          if( retried < max_retries )
+            retried += 1
+            logger.debug( format( 'cannot login, host unreachable (retry %d / %d)', retried, max_retries ) ) if @debug
+            sleep( sleep_between_retries )
+            retry
+          else
+            raise format( 'Maximum retries (%d) against \'%s/login\' reached. Giving up ...', max_retries, @url )
+          end
+        end
+
+        logger.debug('User session initiated') if @debug
+
+        return true
+      end
+
+      false
+    end
+
+    # Renew session based on remember cookie
+    #
+    # @example
+    #    ping_session
+    #
+    # @return [Hash]
+    #
+    def ping_session
+      endpoint = '/api/login/ping'
+      logger.debug( "Pinging current session (GET #{endpoint})" ) if @debug
+      get( endpoint )
+    end
+  end
+
+end

data/lib/grafana/network.rb

@@ -0,0 +1,169 @@
+
+module Grafana
+
+  module Network
+
+    def get( endpoint )
+
+      request( 'GET', endpoint )
+    end
+
+    def post( endpoint, data )
+
+      request( 'POST', endpoint, data )
+    end
+
+    def put( endpoint, data )
+
+      request( 'PUT', endpoint, data )
+    end
+
+    def patch( endpoint, data )
+
+      request( 'PATCH', endpoint, data )
+    end
+
+    def delete( endpoint )
+
+      request( 'DELETE', endpoint )
+    end
+
+    def request( method_type = 'GET', endpoint = '/', data = {} )
+
+      raise 'try first login()' if  @api_instance.nil?
+
+      response             = nil
+      response_code        = 404
+      response_body        = ''
+
+      begin
+
+        case method_type.upcase
+        when 'GET'
+          response = @api_instance[endpoint].get( @headers )
+        when 'POST'
+          response = @api_instance[endpoint].post( data, @headers )
+        when 'PATCH'
+          response = @api_instance[endpoint].patch( data, @headers )
+        when 'PUT'
+          # response = @api_instance[endpoint].put( data, @headers )
+          @api_instance[endpoint].put( data, @headers ) do |response, request, result|
+
+            case response.code
+            when 200
+              response_body = response.body
+              response_code = response.code.to_i
+              response_body = JSON.parse(response_body) if response_body.is_a?(String)
+
+              return {
+                'status' => response_code,
+                'message' => response_body.dig('message').nil? ? 'Successful' : response_body.dig('message')
+              }
+            when 400
+              response_body = response.body
+              response_code = response.code.to_i
+              raise RestClient::BadRequest
+            else
+              logger.error( response.code )
+              logger.error( response.body )
+              response.return! # (request, result)
+            end
+          end
+
+        when 'DELETE'
+          response = @api_instance[endpoint].delete( @headers )
+        else
+          @logger.error( "Error: #{__method__} is not a valid request method." )
+          return false
+        end
+
+        response_code    = response.code.to_i
+        response_body    = response.body
+        response_headers = response.headers
+
+        if( @debug )
+          logger.debug("response_code : #{response_code}" )
+          logger.debug("response_body : #{response_body}" )
+          logger.debug("response_headers : #{response_headers}" )
+        end
+
+        if( ( response_code >= 200 && response_code <= 299 ) || ( response_code >= 400 && response_code <= 499 ) )
+
+          result = JSON.parse( response_body )
+
+          if( result.is_a?(Array) )
+            r_result= {
+              'status' => response_code,
+              'message' => result
+            }
+            return r_result
+          end
+
+          result_status = result.dig('status') if( result.is_a?( Hash ) )
+
+          result['message'] = result_status unless( result_status.nil? )
+          result['status']  = response_code
+
+          return result
+        else
+
+          @logger.error( "#{__method__} #{method_type.upcase} on #{endpoint} failed: HTTP #{response.code} - #{response_body}" )
+          @logger.error( @headers )
+          @logger.error( JSON.pretty_generate( response_headers ) )
+
+          return JSON.parse( response_body )
+        end
+
+      rescue RestClient::BadRequest
+
+        response_body = JSON.parse(response_body) if response_body.is_a?(String)
+
+        return {
+          'status' => 400,
+          'message' => response_body.dig('message').nil? ? 'Bad Request' : response_body.dig('message')
+        }
+
+      rescue RestClient::Unauthorized
+
+        return {
+          'status' => 401,
+          'message' => format('Not authorized to connect \'%s/%s\' - wrong username or password?', @url, endpoint)
+        }
+
+      rescue RestClient::NotFound
+
+        return {
+          'status' => 404,
+          'message' => 'Not Found'
+        }
+
+      rescue RestClient::Conflict
+
+        return {
+          'status' => 409,
+          'message' => 'Conflict with the current state of the target resource'
+        }
+
+      rescue RestClient::PreconditionFailed
+
+        return {
+          'status' => 412,
+          'message' => 'Precondition failed. The Object probably already exists.'
+        }
+
+      rescue RestClient::ExceptionWithResponse => e
+
+        logger.error( "Error: #{__method__} #{method_type.upcase} on #{endpoint} error: '#{e}'" )
+        logger.error( data )
+        logger.error( @headers )
+        logger.error( JSON.pretty_generate( response_headers ) )
+
+        return false
+
+      end
+
+    end
+
+  end
+
+end

data/lib/grafana/organization.rb

@@ -0,0 +1,101 @@
+
+module Grafana
+
+  # http://docs.grafana.org/http_api/org/#organisation-api
+  #
+  module Organization
+
+    # Get current Organisation
+    # GET /api/org
+    #
+    #  -> {"id"=>1, "name"=>"Docker", "address"=>{"address1"=>"", "address2"=>"", "city"=>"", "zipCode"=>"", "state"=>"", "country"=>""}, "status"=>200}
+    #
+    def current_organization
+      endpoint = '/api/org'
+      @logger.debug("Get current Organisation (GET #{endpoint})") if @debug
+      get(endpoint)
+    end
+
+    # Update current Organisation
+    # PUT /api/org
+    #
+    #
+    #
+    def update_current_organization( params = {} )
+
+      raise ArgumentError.new(format('wrong type. \'params\' must be an Hash, given \'%s\'', params.class.to_s)) unless( params.is_a?(Hash) )
+      name = params.dig(:name)
+      raise ArgumentError.new('missing name') if( name.nil? )
+
+      endpoint = '/api/org'
+      @logger.debug("Updating current organization (PUT #{endpoint})") if @debug
+      put(endpoint, params.to_json)
+    end
+
+    # Get all users within the actual organisation
+    # GET /api/org/users
+    #
+    #
+    #
+    def current_organization_users
+      endpoint = '/api/org/users'
+      @logger.debug("Getting organization users (GET #{endpoint})") if @debug
+      get(endpoint)
+    end
+
+    # Add a new user to the actual organisation
+    # POST /api/org/users
+    #
+    #
+    #
+    def add_user_to_current_organization( params = {} )
+
+      raise ArgumentError.new(format('wrong type. \'params\' must be an Hash, given \'%s\'', params.class.to_s)) unless( params.is_a?(Hash) )
+      login_or_email = params.dig(:loginOrEmail)
+      role           = params.dig(:role)
+      raise ArgumentError.new('missing loginOrEmail') if( login_or_email.nil? )
+      raise ArgumentError.new('missing role') if( role.nil? )
+      # Defaults to Viewer, other valid options are Admin and Editor and Read Only Editor
+      # valid_perms = ['Viewer','Editor','Read Only Editor','Admin']
+      raise ArgumentError.new( format( 'wrong role. only \'Admin\', \'Viewer\' or \'Editor\' allowed (\'%s\' giving)',role)) if( %w[Admin Viewer Editor].include?(role) == false )
+
+      org = current_organization_users
+      usr = user_by_name( login_or_email )
+
+      if( org )
+
+        org = org.dig('message')
+
+        if( org.select { |x| x.dig('email') == login_or_email }.count >= 1 )
+          return {
+            'status' => 404,
+            'message' => format('User \'%s\' are already in the organisation', login_or_email)
+          }
+        end
+      end
+
+      if( usr.nil? || usr.dig('status').to_i != 200 )
+        return {
+          'status' => 404,
+          'message' => format('User \'%s\' not found', login_or_email)
+        }
+      end
+
+      endpoint = '/api/org/users'
+      @logger.debug("Adding user to current organization (POST #{endpoint})") if @debug
+      post(endpoint, params.to_json)
+    end
+
+    # Updates the given user
+    # PATCH /api/org/users/:userId
+
+
+    # Delete user in actual organisation
+    # DELETE /api/org/users/:userId
+
+
+    #
+
+  end
+
+end

data/lib/grafana/organizations.rb

@@ -0,0 +1,406 @@
+
+module Grafana
+
+  # http://docs.grafana.org/http_api/org/#organisations
+  #
+  module Organizations
+
+    # Search all Organisations
+    # GET /api/orgs
+    def organizations
+      endpoint = '/api/orgs'
+      @logger.debug("Getting all organizations (GET #{endpoint})") if @debug
+      get( endpoint )
+    end
+
+
+    # Get a single data sources by Id or Name
+    #
+    # @example
+    #    organisation( 1 )
+    #    organisation( 'foo' )
+    #
+    # @return [Hash]
+    #
+    def organization( organisation_id )
+
+      raise ArgumentError.new(format('wrong type. user \'organisation_id\' must be an String (for an Datasource name) or an Integer (for an Datasource Id), given \'%s\'', organisation_id.class.to_s)) if( organisation_id.is_a?(String) && organisation_id.is_a?(Integer) )
+      raise ArgumentError.new('missing \'organisation_id\'') if( organisation_id.size.zero? )
+
+      endpoint = format( '/api/orgs/%d', organisation_id ) if(organisation_id.is_a?(Integer))
+      endpoint = format( '/api/orgs/name/%s', URI.escape( organisation_id ) ) if(organisation_id.is_a?(String))
+
+      @logger.debug("Attempting to get existing data source Id #{organisation_id} (GET #{endpoint})") if  @debug
+
+      get(endpoint)
+    end
+
+#     # Get Organisation by Id
+#     # GET /api/orgs/:orgId
+#     def organization_by_id( id )
+#
+#       raise ArgumentError.new('id must be an Integer') unless( id.is_a?(Integer) )
+#
+#       endpoint = format( '/api/orgs/%d', id )
+#       @logger.debug("Get Organisation by Id (GET #{endpoint}})") if @debug
+#       get( endpoint )
+#     end
+#
+#     # Get Organisation by Name
+#     # GET /api/orgs/name/:orgName
+#     def organization_by_name( name )
+#
+#       raise ArgumentError.new('name must be an String') unless( name.is_a?(String) )
+#
+#       endpoint = format( '/api/orgs/name/%s', URI.escape( name ) )
+#       @logger.debug("Get Organisation by Name (GET #{endpoint})") if @debug
+#       get( endpoint )
+#     end
+
+    # Update Organisation
+    #
+    # fields Adress 1, Adress 2, City are not implemented yet.
+    #
+    # @param [Hash] params
+    # @option params [String] organization name of the Organisation
+    # @option params [String] name new name
+    # @option params [String] adress_1
+    # @option params [String] adress_2
+    # @option params [String] city
+    #
+    # @example
+    #    update_organization( organization: 'Main. Org', name: 'Foo+Bar' )
+    #
+    # @return [Hash]
+    #
+    def update_organization( params )
+
+      raise ArgumentError.new(format('wrong type. \'params\' must be an Hash, given \'%s\'', params.class.to_s)) unless( params.is_a?(Hash) )
+      raise ArgumentError.new('missing \'params\'') if( params.size.zero? )
+
+      organization   = validate( params, required: true, var: 'organization', type: String )
+      name = validate( params, required: true, var: 'name', type: String )
+
+      org = organization( organization )
+
+      if( org.nil? || org.dig('status').to_i != 200 )
+        return {
+          'status' => 404,
+          'message' => format('Organization \'%s\' not found', organization)
+        }
+      end
+      org_id = org.dig('id')
+
+      payload = { name: name }
+
+      endpoint = format( '/api/orgs/%s', org_id )
+      @logger.debug("Update Organisation id #{org_id} (PUT #{endpoint})") if @debug
+
+      put( endpoint, payload.to_json )
+    end
+
+    # Get Users in Organisation
+    #
+    # @param [Mixed] user_id Username (String) or Userid (Integer) for delete User
+    #
+    # @example
+    #    organization_users( 1 )
+    #    organization_users( 'Foo Bar' )
+    #
+    # @return [Hash]
+    #
+    def organization_users( org_id )
+
+      raise ArgumentError.new(format('wrong type. user \'org_id\' must be an String (for an Organisation name) or an Integer (for an Organisation Id), given \'%s\'', org_id.class.to_s)) if( org_id.is_a?(String) && org_id.is_a?(Integer) )
+      raise ArgumentError.new('missing \'org_id\'') if( org_id.size.zero? )
+
+      if(org_id.is_a?(String))
+        org = organization(org_id)
+        if( org.nil? || org.dig('status').to_i != 200 )
+          return {
+            'status' => 404,
+            'message' => format('Organization \'%s\' not found', organization)
+          }
+        end
+        org_id = org.dig('id')
+      end
+
+      endpoint = format( '/api/orgs/%s/users', org_id )
+
+      @logger.debug("Getting users in Organisation id #{org_id} (GET #{endpoint})") if @debug
+      get(endpoint)
+    end
+
+    # Add User in Organisation
+    #
+    # @param
+    # @option params [String] organization Organisation name
+    # @option params [String] login_or_email Login or email
+    # @option params [String] role Name of the Role - only 'Viewer', 'Editor', 'Read Only Editor' or 'Admin' allowed
+    #
+    # @examle
+    #    params = {
+    #      organization: 'Foo',
+    #      login_or_email: 'foo@foo-bar.tld',
+    #      role: 'Viewer'
+    #    }
+    #    add_user_to_organization( params )
+    #
+    # @return [Hash]
+    #
+    def add_user_to_organization( params )
+
+      raise ArgumentError.new(format('wrong type. \'params\' must be an Hash, given \'%s\'', params.class.to_s)) unless( params.is_a?(Hash) )
+      raise ArgumentError.new('missing \'params\'') if( params.size.zero? )
+
+      organization   = validate( params, required: true, var: 'organization', type: String )
+      login_or_email = validate( params, required: true, var: 'login_or_email', type: String )
+      role           = validate( params, required: true, var: 'role', type: String )
+      valid_roles    = ['Viewer', 'Editor', 'Read Only Editor', 'Admin']
+
+      # https://stackoverflow.com/questions/9333952/case-insensitive-arrayinclude?answertab=votes#tab-top
+      # Do this once, or each time the array changes
+      downcased = Set.new valid_roles.map(&:downcase)
+      unless( downcased.include?( role.downcase ) )
+
+        message = format( 'wrong role. Role must be one of %s, given \'%s\'', valid_roles.join(', '), role )
+
+        return {
+          'status' => 404,
+          'login_or_email' => login_or_email,
+          'role' => role,
+          'message' => message
+        }
+      end
+
+      org = organization( organization )
+      usr = user_by_name( login_or_email )
+
+      if( org.nil? || org.dig('status').to_i != 200 )
+        return {
+          'status' => 404,
+          'message' => format('Organization \'%s\' not found', organization)
+        }
+      end
+
+      if( usr.nil? || usr.dig('status').to_i != 200 )
+        return {
+          'status' => 404,
+          'message' => format('User \'%s\' not found', login_or_email)
+        }
+      end
+
+      org_id = org.dig('id')
+
+      payload = {
+        loginOrEmail: login_or_email,
+        role: role
+      }
+
+      endpoint = format( '/api/orgs/%d/users', org_id )
+      @logger.debug("Adding user '#{login_or_email}' to organisation '#{organization}' (POST #{endpoint})") if @debug
+
+      post( endpoint, payload.to_json )
+    end
+
+    # Update Users in Organisation
+    #
+    # @param
+    # @option params [String] organization Organisation name
+    # @option params [String] login_or_email Login or email
+    # @option params [String] role Name of the Role - only 'Viewer', 'Editor', 'Read Only Editor' or 'Admin' allowed
+    #
+    # @examle
+    #    params = {
+    #      organization: 'Foo',
+    #      login_or_email: 'foo@foo-bar.tld',
+    #      role: 'Viewer'
+    #    }
+    #    update_organization_user( params )
+    #
+    # @return [Hash]
+    #
+    def update_organization_user( params )
+
+      raise ArgumentError.new(format('wrong type. \'params\' must be an Hash, given \'%s\'', params.class.to_s)) unless( params.is_a?(Hash) )
+      raise ArgumentError.new('missing \'params\'') if( params.size.zero? )
+
+      organization   = validate( params, required: true, var: 'organization', type: String )
+      login_or_email = validate( params, required: true, var: 'login_or_email', type: String )
+      role           = validate( params, required: true, var: 'role', type: String )
+      valid_roles    = ['Viewer', 'Editor', 'Read Only Editor', 'Admin']
+
+      # https://stackoverflow.com/questions/9333952/case-insensitive-arrayinclude?answertab=votes#tab-top
+      # Do this once, or each time the array changes
+      downcased = Set.new valid_roles.map(&:downcase)
+      unless( downcased.include?( role.downcase ) )
+
+        message = format( 'wrong role. Role must be one of %s, given \'%s\'', valid_roles.join(', '), role )
+
+        return {
+          'status' => 404,
+          'login_or_email' => login_or_email,
+          'role' => role,
+          'message' => message
+        }
+      end
+
+      org = organization( organization )
+      usr = user_by_name( login_or_email )
+
+      if( org.nil? || org.dig('status').to_i != 200 )
+        return {
+          'status' => 404,
+          'message' => format('Organization \'%s\' not found', organization)
+        }
+      end
+
+      if( usr.nil? || usr.dig('status').to_i != 200 )
+        return {
+          'status' => 404,
+          'message' => format('User \'%s\' not found', login_or_email)
+        }
+      end
+
+      org_id = org.dig('id')
+      usr_id = usr.dig('id')
+
+      payload = {
+        role: role
+      }
+
+      endpoint = format( '/api/orgs/%d/users/%d', org_id, usr_id )
+
+      @logger.debug("Updating user '#{login_or_email}' in organization '#{organization}' (PATCH #{endpoint})") if @debug
+      patch( endpoint, payload.to_json )
+    end
+
+    # Delete User in Organisation
+    #
+    # @param
+    # @option params [String] organization Organisation name
+    # @option params [String] login_or_email Login or email
+    # @option params [String] role Name of the Role - only 'Viewer', 'Editor', 'Read Only Editor' or 'Admin' allowed
+    #
+    # @examle
+    #    params = {
+    #      organization: 'Foo',
+    #      login_or_email: 'foo@foo-bar.tld'
+    #    }
+    #    delete_user_from_organization( params )
+    #
+    # @return [Hash]
+    #
+    # DELETE /api/orgs/:orgId/users/:userId
+    def delete_user_from_organization( params )
+
+      raise ArgumentError.new(format('wrong type. \'params\' must be an Hash, given \'%s\'', params.class.to_s)) unless( params.is_a?(Hash) )
+      raise ArgumentError.new('missing \'params\'') if( params.size.zero? )
+
+      organization   = validate( params, required: true, var: 'organization', type: String )
+      login_or_email = validate( params, required: true, var: 'login_or_email', type: String )
+
+      org = organization( organization )
+      usr = user_by_name( login_or_email )
+
+      if( org.nil? || org.dig('status').to_i != 200 )
+        return {
+          'status' => 404,
+          'message' => format('Organization \'%s\' not found', organization)
+        }
+      end
+
+      if( usr.nil? || usr.dig('status').to_i != 200 )
+        return {
+          'status' => 404,
+          'message' => format('User \'%s\' not found', login_or_email)
+        }
+      end
+
+      org_id = org.dig('id')
+      usr_id = usr.dig('id')
+
+      endpoint = format( '/api/orgs/%d/users/%d', org_id, usr_id )
+
+      @logger.debug("Deleting user '#{login_or_email}' in organization '#{organization}' (DELETE #{endpoint})") if @debug
+      delete(endpoint)
+    end
+
+    # Create Organisation
+    #
+    # @param
+    # @option params [String] organization Organisation name
+    #
+    # @examle
+    #    params = {
+    #      name: 'Foo'
+    #    }
+    #    create_organisation( params )
+    #
+    # @return [Hash]
+    #
+    def create_organisation( params )
+
+      raise ArgumentError.new(format('wrong type. \'params\' must be an Hash, given \'%s\'', params.class.to_s)) unless( params.is_a?(Hash) )
+      raise ArgumentError.new('missing \'params\'') if( params.size.zero? )
+
+      name   = validate( params, required: true, var: 'name', type: String )
+
+      org = organization( name )
+
+      if( org.nil? || org.dig('status').to_i == 200 )
+        return {
+          'status' => 409,
+          'message' => format('Organisation \'%s\' already exists', name )
+        }
+      end
+
+      endpoint = '/api/orgs'
+      payload = {
+        name: name
+      }
+      @logger.debug("Create Organisation (POST #{endpoint})") if @debug
+
+      post( endpoint, payload.to_json )
+    end
+
+    # Delete Organisation
+    #
+    # @param [Mixed] organisation_id Organisation Name (String) or Organisation Id (Integer) for delete Organisation
+    #
+    # @example
+    #    delete_organisation( 1 )
+    #    delete_organisation( 'Foo' )
+    #
+    # @return [Hash]
+    #
+    def delete_organisation( organisation_id )
+
+      raise ArgumentError.new(format('wrong type. user \'organisation_id\' must be an String (for an Datasource name) or an Integer (for an Datasource Id), given \'%s\'', organisation_id.class.to_s)) if( organisation_id.is_a?(String) && organisation_id.is_a?(Integer) )
+      raise ArgumentError.new('missing \'organisation_id\'') if( organisation_id.size.zero? )
+
+      if(organisation_id.is_a?(String))
+        data = organizations.dig('message')
+        organisation_map = {}
+        data.each do |ds|
+          organisation_map[ds['id']] = ds
+        end
+        organisation_map.select { |_k,v| v['name'] == organisation_id }
+        organisation_id = organisation_map.keys.first if( data )
+      end
+
+      if( organisation_id.nil? )
+        return {
+          'status' => 404,
+          'message' => format( 'No Organisation \'%s\' found', organisation_id)
+        }
+      end
+
+      endpoint = format( '/api/orgs/%d', organisation_id )
+      @logger.debug("Deleting organization #{organisation_id} (DELETE #{endpoint})") if @debug
+
+      delete(endpoint)
+    end
+
+  end
+end