nifty-cloud-sdk 1.8.beta1 → 1.9.beta1

data/CHANGELOG

@@ -35,12 +35,13 @@ API Version.1.8 対応
 	- run_instances で Windows のイメージ ID が指定された場合のみ :password を必須とみなすようにする (see #13)
 	
 	* lib/NIFTY/config.rb
+        * README.rdoc
 	- デフォルトの API エンドポイントを https://cp.cloud.nifty.com/api/1.7/ から https://cp.cloud.nifty.com/api/ へ変更する (see #14)
 	
 	* test/test_*.rb
 	- テストコードにマジックコメントでスクリプトエンコーディングを指定する (see #16)
 	
-	* lib/NIFTY/version.rb, README.rdoc
+	* lib/NIFTY/version.rb
 	- VERSIONを変更
 
 

data/lib/NIFTY/Cloud/instances.rb

@@ -9,7 +9,7 @@ module NIFTY
       INSTANCES_DESCRIBE_ATTRIBUTE  = [
         'instanceType', 'disableApiTermination', 'blockDeviceMapping', 'accountingType', 'nextMonthAccountingType',
         'loadbalancing', 'copyInfo', 'autoscaling', 'ipType', 'groupId', 'description']
-      INSTANCES_MODIFY_ATTRIBUTE    = ['instanceType', 'disableApiTermination', 'instanceName', 'description', 'ipType', 'groupId']
+      INSTANCES_MODIFY_ATTRIBUTE    = ['instanceType', 'disableApiTermination', 'instanceName', 'description', 'ipType', 'groupId', 'accountingType']
       INSTANCES_IGNORED_PARAMS      = Regexp.union(/MinCount/, 
                                                    /MaxCount/, 
                                                    /AddisionalInfo/, 
@@ -74,12 +74,14 @@ module NIFTY
       #  @option options [String] :instance_id  サーバー名(必須)
       #  @option options [String] :attribute    更新対象の項目名(必須)
       #   許可値: instanceType(サーバータイプを更新) | disableApiTermination(API からのサーバー削除可否を更新) | instanceName(サーバー名を更新) | 
-      #           description(メモ情報を更新) | ipType(IP アドレスの固定化タイプを更新) | groupId(ファイアウォールグループを更新)
+      #           description(メモ情報を更新) | ipType(IP アドレスの固定化タイプを更新) | groupId(ファイアウォールグループを更新) |
+      #           accountingType(利用料金タイプを更新)
       #   
       #  @option options [String] :value        更新値(必須)
       #   許可値: (:attribute= instanceType) mini | small | small2 | small4 | small8 | medium | medium4 | medium8 | medium16 | large | large8 | large16 | large24 | large32 | extra-large16 | extra-large24 | extra-large32
       #           (:attribute= disableApiTermination) true | false 
       #           (:attribute= ipType) static | dynamic | none
+      #           (:attribute= accountingType) 1(月額課金) | 2(従量課金)
       #  @return [Hash] レスポンスXML解析結果
       #
       #  @example
@@ -93,6 +95,7 @@ module NIFTY
         raise ArgumentError, "Invalid :value provided." if options[:attribute] == 'instanceType' && !INSTANCE_TYPE.include?(options[:value].to_s)
         raise ArgumentError, "Invalid :value provided." if options[:attribute] == 'disableApiTermination' && !BOOLEAN.include?(options[:value].to_s)
         raise ArgumentError, "Invalid :value provided." if options[:attribute] == 'ipType' && !IP_TYPE.include?(options[:value].to_s)
+        raise ArgumentError, "Invalid :value provided." if options[:attribute] == 'accountingType' && !ACCOUNTING_TYPE.include?(options[:value].to_s)
 
         params = {'Action' => 'ModifyInstanceAttribute'}
         params.merge!(opts_to_prms(options, [:instance_id, :attribute, :value]))
@@ -386,6 +389,57 @@ module NIFTY
 
         return response_generator(params)
       end
+
+
+      # API「ImportInstances」を実行し、指定したOVFファイルの情報に基づいて、サーバーインポートを予約します。
+      # 1回のリクエストで1台のサーバーが予約可能です。
+      #
+      # イメージ（VMDKファイル）は、別途アップロード領域へアップロードしてください（このAPIのレスポンスに含まれるタスクIDを指定します）。
+      #
+      # サーバーの作成には、時間がかかることがあります。
+      # API「DescribeInstances」のレスポンス値「instanceState」でサーバーのステータスを確認できます。
+      #
+      # インポートしたサーバーは通常ほかのサーバー作成と同様に課金されますが、ニフティクラウドの基本ディスク容量（Linux:30GB、Windows:40GB）を超えるディスクを持つ場合は100GB単位で追加料金が発生します。
+      #
+      # ニフティクラウドがサポートしないOS製品である、複数OSのサーバーであるなどの場合はインポートできず、エラーが返されます。
+      #
+      # インポートしたサーバーは、APIからの削除が可能です。
+      # APIからの削除を禁止したい場合は、インポート完了後にAPI「ModifyInstanceAttribute」を実行してください。
+      #
+      #  @option options [Array<String>] :security_group      適用するファイアフォールグループ名
+      #  @option options [String] :instance_type              サーバータイプ
+      #   許可値: mini | small | small2 | small4 | small8 | medium | medium4 | medium8 | medium16 | large | large8 | large16 | large24 | large32 | extra-large16 | extra-large24 | extra-large32
+      #  @option options [String] :availability_zone
+      #  @option options [Boolean] :disable_api_termination   APIからのサーバー削除の可否 
+      #   許可値: true(削除不可) | false(削除可)
+      #  @option options [String] :instance_id                サーバー名
+      #  @option options [String] :ovf                        OVFデータ 
+      #  @option options [String] :accounting_type            利用料金タイプ
+      #   許可値: 1(月額課金) | 2(従量課金)
+      #  @option options [String] :ip_type                    IPアドレスタイプ
+      #   許可値: static | dynamic | none
+      #  @return [Hash] レスポンスXML解析結果
+      #
+      #  @example
+      #   cancel_copy_instances(:instance_id => 'server01')
+      #
+      def import_instance( options={} )
+        raise ArgumentError, "No :ovf provided." if blank?(options[:ovf])
+        #raise ArgumentError, "No :security_group provided." if blank?(options[:security_group])
+        raise ArgumentError, "Invalid :security_group provided." unless blank?(options[:security_group]) || GROUP_NAME =~ options[:security_group].to_s
+        raise ArgumentError, "Invalid :instance_type provided." unless blank?(options[:instance_type]) || INSTANCE_TYPE.include?(options[:instance_type].to_s)
+        raise ArgumentError, "Invalid :disable_api_termination provided." unless blank?(options[:disable_api_termination]) || 
+          BOOLEAN.include?(options[:disable_api_termination].to_s)
+        raise ArgumentError, "Invalid :accounting_type provided." unless blank?(options[:accounting_type]) || ACCOUNTING_TYPE.include?(options[:accounting_type].to_s)
+        raise ArgumentError, "Invalid :ip_type provided." unless blank?(options[:ip_type]) || IP_TYPE.include?(options[:ip_type].to_s)
+
+        params = {'Action' => 'ImportInstance'}
+        params.merge!(pathlist('SecurityGroup', options[:security_group]))
+        params.merge!(opts_to_prms(options, [:instance_type, :disable_api_termination, :instance_id, :ovf, :accounting_type, :ip_type]))
+        params.merge!(opts_to_prms(options, [:availability_zone], 'Placement'))
+
+        return response_generator(params)
+      end
     end   # end of Base class
   end     # end of Cloud module
 end       # end of NIFTY module

data/lib/NIFTY/Cloud/load_balancers.rb

@@ -9,6 +9,8 @@ module NIFTY
       LOAD_BALANCER_NAME      = /^[a-zA-Z0-9]{1,15}$/
       LOAD_BALANCERS_IGNORED_PARAMS = Regexp.union(/AvailabilityZones .member.*/, 
                                                    /HealthCheck .Timeout/)
+      LOAD_BALANCER_SESSION_STICKINESS_EXPIRATION_PERIOD = ['3', '5', '10', '15', '30']
+      LOAD_BALANCER_SORRY_PAGE_STATUS_CODE = ['200', '503']
 
       # API「ConfigureHealthCheck」を実行し、指定したロードバランサーのヘルスチェックの設定を変更します。
       # ロードバランサーを指定するためには、ロードバランサー名・ポート番号が必要です。削除済みのロードバランサーを指定した、
@@ -435,6 +437,182 @@ module NIFTY
         
         return response_generator(params)
       end
+
+
+      # API「UpdateLoadBalancerOption」を実行し、指定したロードバランサーのオプション設定を更新します。
+      #
+      # 削除済みのロードバランサー名・待ち受けポートを指定した、管理外のロードバランサー名を指定した場合は、エラーが返されます。
+      #
+      # 各オプションの利用設定がtrueの場合は有効、falseの場合は無効へ更新します。
+      #
+      # Sorryページオプションを有効にするためには指定するロードバランサーの待ち受けポートが80番である必要があります。
+      #
+      #  @option options [String] :load_balancer_name                 変更対象のロードバランサー名(必須)
+      #  @option options [Integer] :load_balancer_port                変更対象の待ち受けポート(必須)
+      #  @option options [Integer] :instance_port                     変更対象の宛先ポート(必須)
+      #  @option options [String] :session_stickiness_policy_update   セッション固定オプション
+      #   <Hash> options  [Boolean] :enable                            - セッション固定オプション利用設定
+      #   <Hash> options  [Integer] :expiration_period                 - セッション保持時間(セッション固定オプションが有効の場合必須)
+      #   許可値: 3 | 5 | 10 | 15 | 30
+      #  @option options [String] :sorry_page_update                  Sorryページオプション
+      #   <Hash> options  [Boolean] :enable                            - Sorryページオプション利用設定
+      #   <Hash> options  [Integer] :status_code                       - レスポンスコード(Sorryページオプションが有効の場合必須)
+      #   許可値: 200 | 503
+      #  @option options [String] :mobile_filter_update               携帯キャリアフィルターオプション
+      #   <Hash> options  [Boolean] :enable                            - 携帯キャリアフィルターオプション利用設定
+      #  @return [Hash] レスポンスXML解析結果
+      #
+      #  @example
+      #   update_load_balancer_option(
+      #     :load_balancer_name => 'lb0001',
+      #     :load_balancer_port => 80,
+      #     :instance_port => 80,
+      #     :session_stickiness_enable => true,
+      #     :session_stickiness_expiration_period => 10,
+      #     :sorry_page_enable => true,
+      #     :sorry_page_status_code => 200,
+      #     :mobile_filter_enable => true
+      #   )
+      #
+      def update_load_balancer_option( options={} )
+        raise ArgumentError, "No :load_balancer_name provided." if blank?(options[:load_balancer_name])
+        raise ArgumentError, "Invalid :load_balancer_name provided." unless LOAD_BALANCER_NAME =~ options[:load_balancer_name].to_s
+        raise ArgumentError, "No :load_balancer_port provided." if blank?(options[:load_balancer_port])
+        raise ArgumentError, "Invalid :load_balancer_port provided." unless blank?(options[:load_balancer_port]) ||
+          valid_port?(options[:load_balancer_port])
+        raise ArgumentError, "No :instance_port provided." if blank?(options[:instance_port]) && !blank?(options[:load_balancer_port])
+        raise ArgumentError, "Invalid :instance_port provided." unless blank?(options[:instance_port]) ||
+          valid_port?(options[:instance_port])
+        raise ArgumentError, "No :session_stickiness_expiration_period provided." if blank?(options[:session_stickiness_expiration_period]) &&
+          !blank?(options[:session_stickiness_enable]) && 'true' == options[:session_stickiness_enable].to_s
+        raise ArgumentError, "Invalid :session_stickiness_enable provided." unless blank?(options[:session_stickiness_enable]) ||
+          BOOLEAN.include?(options[:session_stickiness_enable].to_s)
+        raise ArgumentError, "Invalid :session_stickiness_expiration_period provided." unless blank?(options[:session_stickiness_expiration_period]) ||
+          LOAD_BALANCER_SESSION_STICKINESS_EXPIRATION_PERIOD.include?(options[:session_stickiness_expiration_period].to_s)
+        raise ArgumentError, "No :sorry_page_status_code provided." if blank?(options[:sorry_page_status_code]) &&
+          !blank?(options[:sorry_page_enable]) && 'true' == options[:sorry_page_enable].to_s
+        raise ArgumentError, "Invalid :sorry_page_enable provided." unless blank?(options[:sorry_page_enable]) ||
+          BOOLEAN.include?(options[:sorry_page_enable].to_s)
+        raise ArgumentError, "Invalid :sorry_page_status_code provided." unless blank?(options[:sorry_page_status_code]) ||
+          LOAD_BALANCER_SORRY_PAGE_STATUS_CODE.include?(options[:sorry_page_status_code].to_s)
+        raise ArgumentError, "Invalid :mobile_filter_enable provided." unless blank?(options[:mobile_filter_enable]) ||
+          BOOLEAN.include?(options[:mobile_filter_enable].to_s)
+
+        params = {
+          'Action' => 'UpdateLoadBalancerOption',
+          'SessionStickinessOptionUpdate.Enable' => options[:session_stickiness_enable].to_s,
+          'SessionStickinessOptionUpdate.ExpirationPeriod' => options[:session_stickiness_expiration_period].to_s,
+          'SorryPageOptionUpdate.Enable' => options[:sorry_page_enable].to_s,
+          'SorryPageOptionUpdate.StatusCode' => options[:sorry_page_status_code].to_s,
+          'MobileFilterOptionUpdate.Enable' => options[:mobile_filter_enable].to_s
+        }
+        params.merge!(opts_to_prms(options, [:load_balancer_name, :load_balancer_port, :instance_port]))
+       
+        return response_generator(params)
+      end
+
+
+      # API「SetLoadBalancerListenerSSLCertificate」を実行し、指定したロードバランサーに対してSSL証明書を取り付けます。
+      #
+      # ロードバランサーを指定するためには、ロードバランサー名・ポート番号が必要です。
+      # 削除済みのロードバランサーを指定した、管理外のロードバランサーを指定したなど、無効なロードバランサーを指定した場合は、エラーが返されます。
+      #
+      # SSL証明書を指定するためには、SSL証明書の発行識別子が必要です。
+      # 削除済みのSSL証明書を指定した、管理外のSSL証明書を指定したなど、無効なSSL証明書を指定した場合は、エラーが返されます。
+      #
+      # 指定したSSL証明書のステータスが「有効」かつ、鍵長が1024bitかつ数量無制限の証明書のみ設定することができます。それ以外のSSL証明書を指定した場合はエラーが返されます。
+      #
+      #  @option options [String] :load_balancer_name    対象のロードバランサー名(必須)
+      #  @option options [Integer] :load_balancer_port   対象の待ち受けポート(必須)
+      #  @option options [Integer] :instance_port        対象の宛先ポート(必須)
+      #  @option options [String] :ssl_certificate_id    SSL証明書の発行識別子(必須)
+      #  @return [Hash] レスポンスXML解析結果
+      #
+      #  @example
+      #   set_load_balancer_listener_ssl_certificate(:load_balancer_name => 'lb0001', :load_balancer_port => 80, :instance_port => 80, :ssl_certificate_id => 111)
+      #
+      def set_load_balancer_listener_ssl_certificate( options={} )
+        raise ArgumentError, "No :load_balancer_name provided." if blank?(options[:load_balancer_name])
+        raise ArgumentError, "Invalid :load_balancer_name provided." unless LOAD_BALANCER_NAME =~ options[:load_balancer_name].to_s
+        raise ArgumentError, "No :load_balancer_port provided." if blank?(options[:load_balancer_port])
+        raise ArgumentError, "Invalid :load_balancer_port provided." unless blank?(options[:load_balancer_port]) ||
+          valid_port?(options[:load_balancer_port])
+        raise ArgumentError, "No :instance_port provided." if blank?(options[:instance_port])
+        raise ArgumentError, "Invalid :instance_port provided." unless blank?(options[:instance_port]) ||
+          valid_port?(options[:instance_port])
+        raise ArgumentError, "No :ssl_certificate_id provided." if blank?(options[:ssl_certificate_id])
+
+        params = {
+          'Action' => 'SetLoadBalancerListenerSSLCertificate',
+          'SSLCertificateId' => options[:ssl_certificate_id].to_s
+        }
+        params.merge!(opts_to_prms(options, [:load_balancer_name, :load_balancer_port, :instance_port]))
+       
+        return response_generator(params)
+      end
+
+      # API「UnsetLoadBalancerListenerSSLCertificate」を実行し、指定したロードバランサーに設定されているSSL証明書をはずします。
+      #
+      # ロードバランサーを指定するためには、ロードバランサー名・ポート番号が必要です。
+      # 削除済みのロードバランサーを指定した、管理外のロードバランサーを指定したなど、無効なロードバランサーを指定した場合は、エラーが返されます。
+      #
+      # SSL証明書が設定されてないロードバランサー名を指定した場合は、エラーが返されます。
+      #
+      #  @option options [String] :load_balancer_name    対象のロードバランサー名(必須)
+      #  @option options [Integer] :load_balancer_port   対象の待ち受けポート(必須)
+      #  @option options [Integer] :instance_port        対象の宛先ポート(必須)
+      #  @return [Hash] レスポンスXML解析結果
+      #
+      #  @example
+      #   unset_load_balancer_listener_ssl_certificate(:load_balancer_name => 'lb0001', :load_balancer_port => 80, :instance_port => 80)
+      #
+      def unset_load_balancer_listener_ssl_certificate( options={} )
+        raise ArgumentError, "No :load_balancer_name provided." if blank?(options[:load_balancer_name])
+        raise ArgumentError, "Invalid :load_balancer_name provided." unless LOAD_BALANCER_NAME =~ options[:load_balancer_name].to_s
+        raise ArgumentError, "No :load_balancer_port provided." if blank?(options[:load_balancer_port])
+        raise ArgumentError, "Invalid :load_balancer_port provided." unless blank?(options[:load_balancer_port]) ||
+          valid_port?(options[:load_balancer_port])
+        raise ArgumentError, "No :instance_port provided." if blank?(options[:instance_port])
+        raise ArgumentError, "Invalid :instance_port provided." unless blank?(options[:instance_port]) ||
+          valid_port?(options[:instance_port])
+
+        params = {'Action' => 'UnsetLoadBalancerListenerSSLCertificate'}
+        params.merge!(opts_to_prms(options, [:load_balancer_name, :load_balancer_port, :instance_port]))
+       
+        return response_generator(params)
+      end
+
+
+      # API「ClearLoadBalancerSession」を実行し、指定したセッション固定オプションを申し込んでいるロードバランサーのセッション情報を削除します。
+      #
+      # ロードバランサーを指定するためには、ロードバランサー名・ポート番号が必要です。
+      # 削除済みのロードバランサーを指定した、管理外のロードバランサーを指定したなど、無効なロードバランサーを指定した場合は、エラーが返されます。
+      #
+      # セッション固定オプションを申し込んでいないロードバランサー名を指定した場合は、エラーが返されます。
+      #
+      #  @option options [String] :load_balancer_name    対象のロードバランサー名(必須)
+      #  @option options [Integer] :load_balancer_port   対象の待ち受けポート(必須)
+      #  @option options [Integer] :instance_port        対象の宛先ポート(必須)
+      #  @return [Hash] レスポンスXML解析結果
+      #
+      #  @example
+      #   clear_load_balancer_session(:load_balancer_name => 'lb0001', :load_balancer_port => 80, :instance_port => 80)
+      #
+      def clear_load_balancer_session( options={} )
+        raise ArgumentError, "No :load_balancer_name provided." if blank?(options[:load_balancer_name])
+        raise ArgumentError, "Invalid :load_balancer_name provided." unless LOAD_BALANCER_NAME =~ options[:load_balancer_name].to_s
+        raise ArgumentError, "No :load_balancer_port provided." if blank?(options[:load_balancer_port])
+        raise ArgumentError, "Invalid :load_balancer_port provided." unless blank?(options[:load_balancer_port]) ||
+          valid_port?(options[:load_balancer_port])
+        raise ArgumentError, "No :instance_port provided." if blank?(options[:instance_port])
+        raise ArgumentError, "Invalid :instance_port provided." unless blank?(options[:instance_port]) ||
+          valid_port?(options[:instance_port])
+
+        params = {'Action' => 'ClearLoadBalancerSession'}
+        params.merge!(opts_to_prms(options, [:load_balancer_name, :load_balancer_port, :instance_port]))
+
+        return response_generator(params)
+      end
     end
   end
 end

data/lib/NIFTY/Cloud/resources.rb

@@ -0,0 +1,90 @@
+module NIFTY
+  module Cloud
+    class Base < NIFTY::Base
+      RESOURCES_DATE = /^\d{4}(\/|\-)?\d{2}(\/|\-)?\d{2}$/
+      RESOURCES_YEAR_MONTH = /^\d{4}(\/|\-)?\d{2}$/
+
+      # API「DescribeResources」を実行し、サービスの稼働情報を返却します。
+      # コントロールパネル画面のダッシュボードに当たります。
+      #
+      #  @return [Hash] レスポンスXML解析結果
+      #
+      #  @example
+      #   describe_resources()
+      #
+      def describe_resources( options={} )
+        params = {'Action' => 'DescribeResources'}
+
+        return response_generator(params)
+      end
+
+
+      # API「DescribeServiceStatus」を実行し、サービスの稼働情報を返却します。
+      # コントロールパネル画面のダッシュボードに当たります。
+      #
+      #  @option options [String] :from_date 取得開始日
+      #  @option options [String] :to_date 取得終了日
+      #  @return [Hash] レスポンスXML解析結果
+      #
+      #  @example
+      #   describe_service_status(:from_date => '2012/02/01', :to_date => '2012/02/10')
+      #
+      def describe_service_status( options={} )
+        raise ArgumentError, "Invalid :from_date provided." unless blank?(options[:from_date]) || RESOURCES_DATE =~ options[:from_date].to_s
+        raise ArgumentError, "Invalid :to_date provided." unless blank?(options[:to_date]) || RESOURCES_DATE =~ options[:to_date].to_s
+
+        params = {'Action' => 'DescribeServiceStatus'}
+        params.merge!(opts_to_prms(options, [:from_date, :to_date]))
+
+        return response_generator(params)
+      end
+
+
+      # API「DescribeUsage」を実行し、リソースの利用状況を返却します。
+      # コントロールパネル画面の料金明細に当たりますが、金額は含まれません。
+      #
+      # 存在する情報のみ、レスポンス内にタグが生成されます。
+      #
+      # 取得対象リージョンを設定した場合はサーバー利用情報などそのリージョンに属する個別情報を、
+      # 指定しなかった場合はSSL証明書利用情報などリージョン共通情報と東日本リージョンの個別情報を返却します。
+      #
+      #  @option options [String] :year_month 取得対象年月
+      #  @option options [String] :region     取得対象リージョン
+      #  @return [Hash] レスポンスXML解析結果
+      #
+      #  @example
+      #   describe_usage(:year_month => '2011-02', :region => 'east-1')
+      #
+      def describe_usage( options={} )
+        raise ArgumentError, "Invalid :year_month provided." unless blank?(options[:year_month]) || RESOURCES_YEAR_MONTH =~ options[:year_month].to_s
+
+        params = {'Action' => 'DescribeUsage'}
+        params.merge!(opts_to_prms(options, [:year_month, :region]))
+
+        return response_generator(params)
+      end
+
+
+      # API「DescribeUserActivities」を実行し、APIおよびコントロールパネルの利用履歴を返却します。
+      # コントロールパネル画面のログ取得に当たります。
+      #
+      # マルチアカウントの子アカウントでは、自身の利用履歴のみ返却されます。
+      # アップロード中のタスク情報を返却します。
+      #
+      #  @option options [String] :year_month 取得対象年月
+      #  @return [Hash] レスポンスXML解析結果
+      #
+      #  @example
+      #   describe_user_activities(:year_month => '201101')
+      #
+      def describe_user_activities( options={} )
+        raise ArgumentError, "Invalid :year_month provided." unless blank?(options[:year_month]) || RESOURCES_YEAR_MONTH =~ options[:year_month].to_s
+
+        params = {'Action' => 'DescribeUserActivities'}
+        params.merge!(opts_to_prms(options, [:year_month]))
+
+        return response_generator(params)
+      end
+    end   # end of Base class
+  end     # end of Cloud module
+end       # end of NIFTY module

data/lib/NIFTY/Cloud/security_groups.rb

@@ -9,6 +9,8 @@ module NIFTY
       SECURITY_GROUPS_IGNORED_PARAMS = Regexp.union(/UserId/, 
                                                     /IpPermissions\.\d+\.ToPort/, 
                                                     /IpPermissions\.\d+\.Groups\.\d+\.UserId/)
+      SECURITY_GROUP_COURSE = ['1', '2']
+      NUMERIC = /^[0-9]+$/
 
       # API「AuthorizeSecurityGroupIngress」を実行し、指定したファイアウォールグループへ許可ルールを追加します。
       # 許可ルールの上限数を超える場合は、エラーが返されます。
@@ -333,9 +335,17 @@ module NIFTY
       # ファイアウォールグループを指定するためには、ファイアウォールグループ名が必要です。削除済みのファイアウォールグループを指定した、
       # 管理外のファイアウォールグループを指定したなど、無効なファイアウォールグループを指定した場合は、エラーが返されます。
       #
-      #  @option options [String] :group_name                 ファイアウォールグループ名(必須)
-      #  @option options [String] :group_name_update          ファイアウォールグループ名の変更
-      #  @option options [String] :group_description_update   ファイアウォールグループのメモの変更
+      # ファイアウォールグループの設定情報の更新には、時間がかかることがあります。
+      #
+      # API「DescribeSecurityGroups」のレスポンス値「groupStatus」でファイアウォールグループのステータスを確認できます。
+      # また、ファイアウォールグループのステータスが「適用済み」の場合、更新した情報が正しくファイアウォールグループに反映されているかの確認が必要です。
+      # 同じくAPI「DescribeSecurityGroups」のレスポンス値で確認できます。
+      #
+      #  @option options [String] :group_name                   ファイアウォールグループ名(必須)
+      #  @option options [String] :group_name_update            ファイアウォールグループ名の変更
+      #  @option options [String] :group_description_update     ファイアウォールグループのメモの変更
+      #  @option options [Integer] :group_log_limit_update      ファイアウォールグループのログ取得件数の変更
+      #  @option options [Boolean] :group_log_filter_net_bios   WindowsサーバのBroadcast通信ログの抑止状態
       #  @return [Hash] レスポンスXML解析結果
       #
       #  @example
@@ -345,9 +355,54 @@ module NIFTY
         raise ArgumentError, "No :group_name provided." if blank?(options[:group_name])
         raise ArgumentError, "Invalid :group_name provided." unless GROUP_NAME =~ options[:group_name].to_s
         raise ArgumentError, "Invalid :group_name_update provided." unless blank?(options[:group_name_update]) || ALPHANUMERIC =~ options[:group_name_update].to_s
+        raise ArgumentError, "Invalid :group_log_limit_update provided." unless blank?(options[:group_log_limit_update]) || NUMERIC =~ options[:group_log_limit_update].to_s
+        raise ArgumentError, "Invalid :group_log_filter_net_bios provided." unless blank?(options[:group_log_filter_net_bios]) || BOOLEAN.include?(options[:group_log_filter_net_bios].to_s)
 
         params = {'Action' => 'UpdateSecurityGroup'}
-        params.merge!(opts_to_prms(options, [:group_name, :group_name_update, :group_description_update]))
+        params.merge!(opts_to_prms(options, [:group_name, :group_name_update, :group_description_update, :group_log_limit_update, :group_log_filter_net_bios]))
+
+        return response_generator(params)
+      end
+
+
+      # API「UpdateSecurityGroupOption」を実行し、ファイアウォールのオプション情報を更新します。
+      #
+      # 利用コースを変更する場合は、注意事項に同意しなければ、エラーが返されます。
+      #
+      # （※）当該APIはv1.11以降、正常応答では常に応答フィールドreturnにtrueが返されます。
+      #
+      #  @option options [String] :course_update                 有償・無償の指定
+      #   許可値: 1(無償) | 2(有償)
+      #  @option options [Boolean] :agreement                    注意事項に同意(:course_updateが2の場合は必須)
+      #  @option options [Integer] :security_group_limit_update  ファイアウォールグループ数上限
+      #  @return [Hash] レスポンスXML解析結果
+      #
+      #  @example
+      #   update_security_group_option(:course_update => 2, :agreement => true)
+      #
+      def update_security_group_option( options={} )
+        raise ArgumentError, "No :agreement provided." if options[:course_update].to_s == '2' && blank?(options[:agreement])
+        raise ArgumentError, "Invalid :course_update provided." unless blank?(options[:course_update]) || SECURITY_GROUP_COURSE.include?(options[:course_update].to_s)
+        raise ArgumentError, "Invalid :agreement provided." unless blank?(options[:agreement]) || BOOLEAN.include?(options[:agreement].to_s)
+        raise ArgumentError, "Invalid :security_group_limit_update provided." unless blank?(options[:security_group_limit_update]) || NUMERIC =~ options[:security_group_limit_update].to_s
+
+        params = {'Action' => 'UpdateSecurityGroupOption'}
+        params.merge!(opts_to_prms(options, [:course_update, :security_group_limit_update]))
+        params.merge!(opts_to_prms(options, [:agreement], 'CourseUpdate'))
+
+        return response_generator(params)
+      end
+
+
+      # API「DescribeSecurityGroupOption」を実行し、ファイアウォールのオプション利用情報を取得します。
+      #
+      #  @return [Hash] レスポンスXML解析結果
+      #
+      #  @example
+      #   describe_security_group_option()
+      #
+      def describe_security_group_option( options={} )
+        params = {'Action' => 'DescribeSecurityGroupOption'}
 
         return response_generator(params)
       end

data/lib/NIFTY/Cloud/uploads.rb

@@ -0,0 +1,51 @@
+module NIFTY
+  module Cloud
+    class Base < NIFTY::Base
+      ATTRIBUTE = 'test'
+
+      # API「DescribeUploads」を実行し、アップロード中のタスク情報を返却します。
+      #
+      # アップロードタスクを指定するためには、タスクIDが必要です。
+      #
+      # タスクIDを指定した場合、指定したIDのアップロードタスクの情報が返されます。
+      # タスクIDを指定しなかった場合は、現在アップロード・インポート中のすべてのタスクが返されます。
+      #
+      # すでにインポートが完了したタスクやキャンセル済みのタスクなど、無効なタスクIDを指定した場合は、エラーが返されます。
+      #
+      #  @option options [Array<String>] :conversion_task_id タスクID
+      #  @return [Hash] レスポンスXML解析結果
+      #
+      #  @example
+      #   describe_uploads(:conversion_task_id => ['d6f1ba72-0a76-4b1d-8421-a4f6089d3d7a', 'd6f1ba72-0a76-4b1d-8421-a4f6089d3d7b'])
+      #
+      def describe_uploads( options={} )
+        params = {'Action' => 'DescribeUploads'}
+        params.merge!(pathlist('ConversionTaskId', options[:conversion_task_id]))
+
+        return response_generator(params)
+      end
+
+
+      # API「CancelUpload」を実行し、サーバーインポートの処理をキャンセルします。
+      # アップロード済みのVMDKファイルは削除されます。
+      #
+      # アップロードタスクを指定するためには、タスクIDが必要です。
+      # すでにインポートが完了したタスクやキャンセル済みのタスクなど、無効なタスクIDを指定した場合は、エラーが返されます。
+      #
+      #  @option options [String] :conversion_task_id  タスクID(必須) 
+      #  @return [Hash] レスポンスXML解析結果
+      #
+      #  @example
+      #   cancel_upload(:conversion_task_id => 'f6dd8353-eb6b-6b4fd32e4f05')
+      #
+      def cancel_upload( options={} )
+        raise ArgumentError, "No :conversion_task_id provided." if blank?(options[:conversion_task_id])
+
+        params = {'Action' => 'CancelUpload'}
+        params.merge!(opts_to_prms(options, [:conversion_task_id]))
+
+        return response_generator(params)
+      end
+    end   # end of Base class
+  end     # end of Cloud module
+end       # end of NIFTY module

data/lib/NIFTY/version.rb

@@ -1,3 +1,3 @@
 module NIFTY
-  VERSION = '1.8.beta1'
+  VERSION = '1.9.beta1'
 end