soracom 1.0.1

data/lib/soracom/cli.rb

@@ -0,0 +1,320 @@
+# coding: utf-8
+
+require 'thor'
+require 'open-uri'
+
+module SoracomCli
+  # SIM related commands
+  class Subscriber < Thor
+    desc 'list', 'list Subscriber(SIM)s'
+    option :limit, type: :numeric, required: false, desc: 'max number of result(default:1024)'
+    option :filter, type: :hash, required: false, desc: 'ex) --filter key:imsi value:001010000000001 / --filter key:tagname value:tagvalue'
+    def list
+      client = Soracom::Client.new
+      sims = client.list_subscribers(Hash[options.map { |k, v| [k.to_sym, v] }])
+      puts JSON.pretty_generate(sims)
+    end
+
+    desc 'register', 'register Subscriber(SIM)'
+    option :registration_secret, type: :string, required: true, desc: 'Registration Secret, 5 digits'
+    option :imsi, type: :string, required: true, desc: 'SIM unique ID, 15 digits'
+    option :type, type: :string, desc: 'default plan type'
+    option :tags, type: :hash, desc: 'tag as hash i.e. --tags name:"foo" group:"bar"'
+    def register
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.register_subscriber(Hash[options.map { |k, v| [k.to_sym, v] }]))
+    end
+
+    desc 'activate', 'activate Subscriber(SIM)s'
+    option :imsi, type: :array, required: true
+    def activate
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.activate_subscriber(options[:imsi]))
+    end
+
+    desc 'deactivate', 'deactivate Subscriber(SIM)s'
+    option :imsi, type: :array, required: true
+    def deactivate
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.deactivate_subscriber(options[:imsi]))
+    end
+
+    desc 'terminate', 'terminate Subscriber(SIM)s'
+    option :imsi, type: :array, required: true
+    option :confirm, type: :string
+    def terminate
+      abort 'You may not revert terminate opereation. Please add "--confirm YES" if you are sure.' if options[:confirm] != 'YES'
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.terminate_subscriber(options[:imsi]))
+    end
+
+    desc 'enable_termination', 'enable termination of Subscriber(SIM)s'
+    option :imsi, type: :array, required: true
+    def enable_termination
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.enable_termination(options[:imsi]))
+    end
+
+    desc 'disable_termination', 'disable termination of Subscriber(SIM)s'
+    option :imsi, type: :array, required: true
+    def disable_termination
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.disable_termination(options[:imsi]))
+    end
+
+    desc 'update_tags', 'add or update tags for Subscriber(SIM)s'
+    option :imsi, type: :array, required: true
+    option :tags, type: :hash, required: true
+    def update_tags
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.update_subscriber_tags(options[:imsi], options[:tags]))
+    end
+
+    desc 'delete_tag', 'delete tag for Subscriber(SIM)s'
+    option :imsi, type: :array, required: true
+    option :tag_name, type: :string, required: true
+    def delete_tag
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.delete_subscriber_tag(options[:imsi], options[:tag_name]))
+    end
+
+    desc 'update_speed_class', 'change speed class for Subscriber(SIM)s'
+    option :imsi, type: :array, required: true
+    option :speed_class, type: :string, required: true
+    def update_speed_class
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.update_subscriber_speed_class(options[:imsi], options[:speed_class]))
+    end
+
+    desc 'set_expiry_time', 'update expiry time of Subscriber(SIM)s'
+    option :imsi, type: :array, required: true
+    option :expiry_time, type: :numeric, required: true
+    def set_expiry_time
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.set_expiry_time(options[:imsi], options[:expiry_time]))
+    end
+
+    desc 'unset_expiry_time', 'delete expiry time of Subscriber(SIM)s'
+    option :imsi, type: :array, required: true
+    def unset_expiry_time
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.unset_expiry_time(options[:imsi]))
+    end
+
+    desc 'set_group', 'set group of Subscriber(SIM)'
+    option :imsi, type: :string, required: true
+    option :group_id, type: :string, required: true
+    def set_group
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.set_group(options[:imsi], options[:group_id]))
+    end
+
+    desc 'unset_group', 'unset group of Subscriber(SIM)'
+    option :imsi, type: :string, required: true
+    def unset_group
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.unset_group(options[:imsi]))
+    end
+  end
+  
+  # Group related commands
+  class Group < Thor
+    desc 'list', 'list groups'
+    option :group_id, type: :string, desc: 'group ID'
+    def list
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.list_groups(options.group_id))
+    end
+    
+    desc 'list_subscribers', 'list subscriber in a group'
+    option :group_id, type: :string, required:true, desc: 'group ID'
+    def list_subscribers
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.list_subscribers_in_group(options.group_id))
+    end
+    
+    desc 'create', 'create group'
+    option :parameters, type: :hash, desc: 'group parameters'
+    option :tags, type: :hash, desc: 'group tags'
+    def create
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.create_group(options.parameters, options.tags))
+    end
+    
+    desc 'delete_group', 'delete a group'
+    option :group_id, type: :string, required:true, desc: 'group ID'
+    def delete
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.delete_group(options.group_id))
+    end
+    
+    desc 'update_configuration', 'update configuration parameter'
+    option :group_id, type: :string, required:true, desc: 'group ID'
+    option :namespace, type: :string, required:true, desc: 'namespace of the parameter'
+    option :params, type: :string, required:true, desc: 'JSON string of the configuration parameter'
+    def update_configuration
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.update_group_configuration(options.group_id, options.namespace, options.params))
+    end
+    
+    desc 'delete_configuration', 'delete configuration parameter'
+    option :group_id, type: :string, required:true, desc: 'group ID'
+    option :namespace, type: :string, required:true, desc: 'namespace of the parameter'
+    option :name, type: :string, required:true, desc: 'name of configuration parameter to delete'
+    def delete_configuration
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.delete_group_configuration(options.group_id, options.namespace, options.name))
+    end
+
+    desc 'update_tags', 'update group tags'
+    option :group_id, type: :string, required:true, desc: 'group ID'
+    option :tags, type: :string, required:true, desc: 'JSON string of tags i.e. [{"tagName":"name","tagValue":"new group name"}]'
+    def update_tags
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.update_group_tags(options.group_id, options.tags))
+    end
+    
+    desc 'delete_tag', 'delete group tag'
+    option :group_id, type: :string, required:true, desc: 'group ID'
+    option :name, type: :string, required:true, desc: 'tag name to delete'
+    def delete_tag
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.delete_group_tags(options.group_id, options.name))
+    end
+  end
+  
+  # EventHandler related commands
+  class EventHandler < Thor
+    desc 'list', 'list groups'
+    option :handler_id, type: :string, desc: 'group ID'
+    option :imsi, type: :string, desc: 'SIM unique ID, 15 digits'
+    option :target, type: :string, desc: 'target can be operator/imsi/tag'
+    def list
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.list_event_handlers(Hash[options.map { |k, v| [k.to_sym, v] }]))
+    end
+        
+    desc 'create', 'create event handler'
+    option :req, type: :string, desc: 'JSON string of event handler configuration'
+    def create
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.create_event_handler(options.req))
+    end
+    
+    desc 'delete', 'delete event handler'
+    option :handler_id, type: :string, required:true, desc: 'Event Handler ID'
+    def delete
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.delete_event_handler(options.handler_id))
+    end
+    
+    desc 'update', 'update event handler configuration'
+    option :handler_id, type: :string, required:true, desc: 'Event Handler ID'
+    option :req, type: :string, desc: 'JSON string of event handler configuration'
+    def update
+      client = Soracom::Client.new
+      puts JSON.pretty_generate(client.update_event_handler(options.handler_id, options.req))
+    end
+  end
+  
+  # Stats related commands
+  class Stats < Thor
+    desc 'get_air_usage', 'get air usage per Subscriber(SIM)'
+    option :imsi, type: :string, required: true, desc: '15 digits SIM unique ID'
+    option :from, type: :numeric, required: false, desc: 'UNIX time in seconds when stat window begins'
+    option :to, type: :numeric, required: false, desc: 'UNIX time in seconds when stat window ends'
+    option :period, type: :string, required: false, desc: 'miniutes or day or month'
+    def get_air_usage
+      client = Soracom::Client.new
+      data = client.get_air_usage(Hash[options.map { |k, v| [k.to_sym, v] }])
+      puts JSON.pretty_generate(data)
+    end
+    
+    desc 'get_beam_usage', 'get beam usage per Subscriber(SIM)'
+    option :imsi, type: :string, required: true, desc: '15 digits SIM unique ID'
+    option :from, type: :numeric, required: false, desc: 'UNIX time in seconds when stat window begins'
+    option :to, type: :numeric, required: false, desc: 'UNIX time in seconds when stat window ends'
+    option :period, type: :string, required: false, desc: 'miniutes or day or month'
+    def get_beam_usage
+      client = Soracom::Client.new
+      data = client.get_beam_usage(Hash[options.map { |k, v| [k.to_sym, v] }])
+      puts JSON.pretty_generate(data)
+    end
+    
+    desc 'export_air_usage', 'export air usage for all Subscriber(SIM)s in csv format'
+    option :from, type: :numeric, required: false, desc: 'UNIX time in seconds when stat window begins'
+    option :to, type: :numeric, required: false, desc: 'UNIX time in seconds when stat window ends'
+    option :period, type: :string, required: false, desc: 'miniutes or day or month'
+    def export_air_usage
+      client = Soracom::Client.new
+      csv = client.export_air_usage(Hash[options.map { |k, v| [k.to_sym, v] }])
+      puts csv
+    end
+    
+    desc 'export_beam_usage', 'export beam usage for all Subscriber(SIM)s in csv format'
+    option :from, type: :numeric, required: false, desc: 'UNIX time in seconds when stat window begins'
+    option :to, type: :numeric, required: false, desc: 'UNIX time in seconds when stat window ends'
+    option :period, type: :string, required: false, desc: 'miniutes or day or month'
+    def export_beam_usage
+      client = Soracom::Client.new
+      csv = client.export_beam_usage(Hash[options.map { |k, v| [k.to_sym, v] }])
+      puts csv
+    end
+  end
+
+  # Using Thor for CLI Implementation
+  class CLI < Thor
+    register(Subscriber, 'subscriber', 'subscriber <command>', 'Subscriber related operations')
+    register(Subscriber, 'sim', 'sim <command>', 'Subscriber related operations(alias)')
+    register(Group, 'group', 'group <command>', 'Group related operations')
+    register(EventHandler, 'event_handler', 'event_handler <command>', 'Event Handler related operations')
+    register(Stats, 'stats', 'stats <command>', 'Stats related operations')
+
+    desc 'auth', 'test authentication'
+    def auth
+      puts 'testing authentication...'
+      begin
+        client = Soracom::Client.new
+        puts <<EOS
+authentication succeeded.
+apiKey: #{client.api_key}
+operatorId: #{client.operator_id}
+EOS
+      rescue => evar
+        abort 'ERROR: ' + evar.to_s
+      end
+    end
+
+    desc 'support', 'open support site'
+    def support
+      client = Soracom::Client.new
+      url = client.get_support_url
+      system "open '#{url}' &> /dev/null || ( echo open following URL in your browser. ; echo '#{url}' )"
+    end
+
+    desc 'version', 'print version'
+    def version
+      puts "Soracom API tool v#{Soracom::VERSION}"
+    end
+
+    desc 'complete', 'command list for shell completion'
+    def complete
+      commands = CLI.commands.select { |k, _v| k != 'complete' }.map { |k, _v| k }.join(' ')
+      subcommands = {}
+      CLI.subcommand_classes.each { |k, v| subcommands[k] = v.commands.map { |k2, _v2| k2 } }
+      subcommands_string = subcommands.map do |k, v|
+        <<EOS
+  [ "$3" = "#{k}" ] && COMPREPLY=( $( compgen -W "#{v.join(' ')}" ${COMP_WORDS[COMP_CWORD]} ) )
+EOS
+      end.join
+      print <<EOS
+_soracom()
+{
+  [ "$3" = "soracom" ] && COMPREPLY=( $( compgen -W "#{commands}" ${COMP_WORDS[COMP_CWORD]} ) )
+#{subcommands_string}
+}
+complete -F _soracom soracom
+EOS
+    end
+  end
+end

data/lib/soracom/client.rb

@@ -0,0 +1,332 @@
+require 'net/http'
+require 'uri'
+require 'json'
+require 'base64'
+require 'ostruct'
+require 'logger'
+
+# SORACOM gem implementation
+module Soracom
+  API_BASE_URL = 'https://api.soracom.io/v1'
+  # Soracom API Client
+  class Client
+    # 設定されなかった場合には、環境変数から認証情報を取得
+    def initialize(email:ENV['SORACOM_EMAIL'], password:ENV['SORACOM_PASSWORD'], endpoint:ENV['SORACOM_ENDPOINT'])
+      @log = Logger.new(STDERR)
+      @log.level = ENV['SORACOM_DEBUG'] ? Logger::DEBUG : Logger::WARN
+      begin
+        if email && password
+          @auth = auth(email, password, endpoint)
+        else
+          fail 'Could not find any credentials(email & password)'
+        end
+      rescue => evar
+        abort 'ERROR: ' + evar.to_s
+      end
+      @api = Soracom::ApiClient.new(@auth, endpoint)
+    end
+
+    # 特定Operator下のSubscriber一覧を取
+    def list_subscribers(operatorId:@auth[:operatorId], limit:1024, filter:{})
+      filter = Hash[filter.map { |k, v| [k.to_sym, v] }]
+      if filter[:key].nil?
+        return @api.get(path: '/subscribers', params: { operatorId: operatorId, limit: limit })
+      end
+
+      # filterありの場合
+      case filter[:key]
+      when 'imsi'
+        [@api.get(path: "/subscribers/#{filter[:value]}", params: { operatorId: operatorId, limit: limit })]
+      when 'msisdn'
+        [@api.get(path: "/subscribers/msisdn/#{filter[:value]}", params: { operatorId: operatorId, limit: limit })]
+      when 'status'
+        @api.get(path: '/subscribers', params: { operatorId: operatorId, limit: limit, status_filter: filter[:value].gsub('|', '%7C') })
+      when 'speed_class'
+        @api.get(path: '/subscribers', params: { operatorId: operatorId, limit: limit, speed_class_filter: filter[:value] })
+      else
+        @api.get(path: '/subscribers', params: { operatorId: operatorId, limit: limit, tag_name: filter[:key], tag_value: filter[:value], tag_value_match_mode: filter[:mode] || 'exact' })
+      end
+    end
+
+    def subscribers(operatorId:@auth[:operatorId], limit:1024, filter:{})
+      list_subscribers(operatorId: operatorId, limit: limit, filter: filter).map { |s| Soracom::Subscriber.new(s, self) }
+    end
+
+    # SIMの登録
+    def register_subscriber(imsi:nil, registration_secret:nil, groupId:nil, tags:{})
+      params = { registrationSecret: registration_secret, tags: tags }
+      params[groupId] = groupId if groupId
+      @api.post(path: "/subscribers/#{imsi}", payload: params)
+    end
+
+    # SIMの利用開始(再開)
+    def activate_subscriber(imsis)
+      threads = [], result = []
+      imsis.map do |imsi|
+        threads << Thread.new do
+          result << { 'imsi' => imsi }.merge(@api.post(path: "/subscribers/#{imsi}/activate"))
+        end
+      end
+      threads.each(&:join)
+      result
+    end
+
+    # SIMの利用休止
+    def deactivate_subscriber(imsis)
+      threads = [], result = []
+      imsis.map do |imsi|
+        threads << Thread.new do
+          result << { 'imsi' => imsi }.merge(@api.post(path: "/subscribers/#{imsi}/deactivate"))
+        end
+      end
+      threads.each(&:join)
+      result
+    end
+
+    # SIMの解約
+    def terminate_subscriber(imsis)
+      threads = [], result = []
+      imsis.map do |imsi|
+        threads << Thread.new do
+          result << { 'imsi' => imsi }.merge(@api.post(path: "/subscribers/#{imsi}/terminate"))
+        end
+      end
+      threads.each(&:join)
+      result
+    end
+
+    # 指定されたSubscriberをTerminate可能に設定する
+    def enable_termination(imsis)
+      threads = [], result = []
+      imsis.map do |imsi|
+        threads << Thread.new do
+          result << { 'imsi' => imsi }.merge(@api.post(path: "/subscribers/#{imsi}/enable_termination"))
+        end
+      end
+      threads.each(&:join)
+      result
+    end
+
+    # 指定されたSubscriberをTerminate不可能に設定する
+    def disable_termination(imsis)
+      threads = [], result = []
+      imsis.map do |imsi|
+        threads << Thread.new do
+          result << { 'imsi' => imsi }.merge(@api.post(path: "/subscribers/#{imsi}/disable_termination"))
+        end
+      end
+      threads.each(&:join)
+      p result
+      result
+    end
+
+    # タグの更新
+    def update_subscriber_tags(imsis, tags)
+      threads = [], result = []
+      imsis.map do |imsi|
+        threads << Thread.new do
+          result << { 'imsi' => imsi }.merge(@api.post(path: "/subscribers/#{imsi}/update_tags", payload: tags))
+        end
+      end
+      threads.each(&:join)
+      result
+    end
+
+    # 指定タグの削除
+    def delete_subscriber_tag(imsis, tag_name)
+      threads = [], result = []
+      imsis.map do |imsi|
+        threads << Thread.new do
+          result << { 'imsi' => imsi }.merge(@api.delete(path: "/subscribers/#{imsi}/tags/#{tag_name}"))
+        end
+      end
+      threads.each(&:join)
+      result
+    end
+
+    # SIMのプラン変更
+    def update_subscriber_speed_class(imsis, speed_class)
+      imsis = [imsis] if imsis.class == String
+      threads = [], result = []
+      imsis.map do |imsi|
+        threads << Thread.new do
+          result << { 'imsi' => imsi }.merge(@api.post(path: "/subscribers/#{imsi}/update_speed_class", payload: { speedClass: speed_class }))
+        end
+      end
+      threads.each(&:join)
+      result
+    end
+
+    # SIMの有効期限設定
+    def set_expiry_time(imsis, expiry_time)
+      threads = [], result = []
+      imsis.map do |imsi|
+        threads << Thread.new do
+          result << { 'imsi' => imsi }.merge(@api.post(path: "/subscribers/#{imsi}/set_expiry_time", payload: { expiryTime: expiry_time }))
+        end
+      end
+      threads.each(&:join)
+      result
+    end
+
+    # SIMの有効期限設定を解除
+    def unset_expiry_time(imsis)
+      threads = [], result = []
+      imsis.map do |imsi|
+        threads << Thread.new do
+          result << { 'imsi' => imsi }.merge(@api.post(path: "/subscribers/#{imsi}/unset_expiry_time"))
+        end
+      end
+      threads.each(&:join)
+      result
+    end
+
+    # SIMの所属Groupを指定あるいは上書き変更
+    def set_group(imsi, group_id)
+      @api.post(path: "/subscribers/#{imsi}/set_group", payload: { groupId: group_id })
+    end
+
+    # SIMの所属Groupを指定を解除
+    def unset_group(imsi)
+      @api.post(path: "/subscribers/#{imsi}/unset_group")
+    end
+
+    # SIMグループの一覧を取得
+    def list_groups(group_id)
+      if group_id
+        [ @api.get(path: "/groups/#{group_id}") ]
+      else
+        @api.get(path: '/groups')
+      end
+    end
+
+    # SIMグループを新規作成
+    def create_group(parameters:nil, tags:nil)
+      payload = {}
+      payload['parameters'] = parameters if parameters
+      payload['tags'] = tags if tags
+      @api.post(path: '/groups', payload: payload)
+    end
+
+    # SIMグループの削除
+    def delete_group(group_id)
+      @api.delete(path: "/groups/#{group_id}")
+    end
+
+    # SIMグループの削除
+    def list_subscribers_in_group(group_id)
+      @api.get(path: "/groups/#{group_id}/subscribers")
+    end
+
+    # コンフィグパラメータの更新
+    def update_group_configuration(group_id, namespace, params)
+      @api.put(path: "/groups/#{group_id}/configuration/#{namespace}", payload: params)
+    end
+
+    # コンフィグパラメータ内の設定を削除
+    def delete_group_configuration(group_id, namespace, name)
+      @api.delete(path: "/groups/#{group_id}/configuration/#{namespace}/#{name}")
+    end
+
+    # コンフィグパラメータの更新
+    def update_group_tags(group_id, tags = {})
+      @api.put(path: "/groups/#{group_id}/tags", payload: tags)
+    end
+
+    # コンフィグパラメータ内の設定を削除
+    def delete_group_tags(group_id, name)
+      @api.delete(path: "/groups/#{group_id}/tags/#{name}")
+    end
+
+    # イベントハンドラーの一覧を得る
+    def list_event_handlers(handler_id:nil, target:nil, imsi:nil)
+      if handler_id
+        [@api.get(path: "/event_handlers/#{handler_id}")]
+      elsif imsi
+        @api.get(path: "/event_handlers/subscribers/#{imsi}")
+      elsif target # target is one of imsi/operator/tag
+        @api.get(path: '/event_handlers', params: { target: target })
+      else
+        @api.get(path: "/event_handlers")
+      end
+    end
+
+    # イベントハンドラーを新規作成する
+    def create_event_handler(req)
+      @api.post(path: '/event_handlers', payload: req)
+    end
+
+    # イベントハンドラーの情報を得る
+    def get_event_handler(handler_id)
+      @api.get(path: "/event_handlers/#{handler_id}")
+    end
+
+    # イベントハンドラーを削除する
+    def delete_event_handler(handler_id)
+      @api.delete(path: "/event_handlers/#{handler_id}")
+    end
+
+    # イベントハンドラーを更新する
+    def update_event_handler(handler_id, params)
+      @api.put(path: "/event_handlers/#{handler_id}", payload: params)
+    end
+
+    # Subscriber毎のAir使用状況を得る(デフォルトでは直近１日)
+    def get_air_usage(imsi:nil, from:(Time.now.to_i - 24 * 60 * 60), to:Time.now.to_i, period:'minutes')
+      @api.get(path: "/stats/air/subscribers/#{imsi}", params: { from: from, to: to, period: period })
+    end
+
+    # Subscriber毎のBeam使用状況を得る(デフォルトでは直近１日)
+    def get_beam_usage(imsi:nil, from:(Time.now.to_i - 24 * 60 * 60), to:Time.now.to_i, period:'minutes')
+      @api.get(path: "/stats/beam/subscribers/#{imsi}", params: { from: from, to: to, period: period })
+    end
+
+    # Operator配下の全Subscriberに関するAir使用状況をダウンロードする(デフォルトでは今月)
+    def export_air_usage(operator_id:@auth[:operatorId] , from:Time.parse("#{Time.now.year}-#{Time.now.month}-#{Time.now.day}").to_i, to:Time.now.to_i, period:'day')
+      res = @api.post(path: "/stats/air/operators/#{operator_id}/export", payload: { from: from, to: to, period: period })
+      open(res['url']).read
+    end
+
+    # Operator配下の全Subscriberに関するBeam使用状況をダウンロードする(デフォルトでは今月)
+    def export_beam_usage(operator_id:@auth[:operatorId] , from:Time.parse("#{Time.now.year}-#{Time.now.month}-#{Time.now.day}").to_i, to:Time.now.to_i, period:'day')
+      res = @api.post(path: "/stats/beam/operators/#{operator_id}/export", payload: { from: from, to: to, period: period })
+      open(res['url']).read
+    end
+
+    # サポートサイトのURLを取得
+    def get_support_url(return_to: 'https://soracom.zendesk.com/hc/ja/requests')
+      res = @api.post(path: "/operators/#{@auth[:operatorId]}/support/token")
+      "https://soracom.zendesk.com/access/jwt?jwt=#{res['token']}&return_to=#{return_to}"
+    end
+
+    # APIキーを取得
+    def api_key
+      @auth[:apiKey]
+    end
+
+    # オペレータIDを取得
+    def operator_id
+      @auth[:operatorId]
+    end
+
+    private
+
+    # authenticate by email and password
+    def auth(email, password, endpoint)
+      endpoint = API_BASE_URL if endpoint.nil?
+      res = RestClient.post endpoint + '/auth',
+                            { email: email, password: password },
+                            'Content-Type' => 'application/json',
+                            'Accept' => 'application/json'
+      result = JSON.parse(res.body)
+      fail result['message'] if res.code != '200'
+      Hash[JSON.parse(res.body).map { |k, v| [k.to_sym, v] }]
+    end
+
+    def extract_jwt(jwt)
+      encoded = jwt.split('.')[1]
+      encoded += '=' * (4 - encoded.length % 4) # add padding(=) for Base64
+      Base64.decode64(encoded)
+    end
+  end
+end

data/lib/soracom/event_handler.rb

@@ -0,0 +1,44 @@
+module Soracom
+  # EventHandlerクラス
+  # 初期化方法1. 新規に作成
+  # 初期化方法2. 特定ハンドラのIDを指定して初期化({handlerId:HANDLERID}) → APIで現時点の内容を取得
+  # 初期化方法3. hashを指定して初期化(list_event_handlersの戻り値を利用など)
+  class EventHandler < OpenStruct
+    def initialize(hash = {}, client = Soracom::Client.new)
+      @log = Logger.new(STDERR)
+      @log.level = ENV['SORACOM_DEBUG'] ? Logger::DEBUG : Logger::WARN
+      if hash.keys.length == 0 # 新規作成
+        hash = Hash[%w(handlerId targetImsi targetOperatorId targetTag name description ruleConfig actionConfigList).map { |k| [k, nil] }]
+      end
+      if hash.keys.length == 1 && hash.keys[0] == 'handlerId' # IDのみを指定して作成
+        hash = client.list_event_handlers(handler_id: hash['handlerId'])[0]
+      end
+      super(hash)
+      @client = client
+    end
+
+    # 新規作成または更新用のpayloadをJSON形式で取得
+    def to_json
+      to_h.select { |k, v| true if !v.nil? && k != :handlerId }.to_json
+    end
+
+    # 現在の内容でEventHandlerを作成または更新
+    def save
+      result = validate
+      fail result unless result == true
+      @log.debug(to_json)
+      if handlerId
+        @client.update_event_handler(handlerId, to_json)
+      else
+        @client.create_event_handler(to_json)
+      end
+    end
+
+    def validate
+      return 'No target is defined' if [targetImsi, targetOperatorId, targetTag].compact.length == 0
+      return 'No rule is defined' if ruleConfig.nil? || ruleConfig.length == 0
+      return 'No action is defined' if actionConfigList.nil? || actionConfigList.length == 0
+      true
+    end
+  end
+end