fog-aws 0.11.0 → 0.12.0

data/lib/fog/aws/requests/support/describe_trusted_advisor_check_result.rb

@@ -0,0 +1,31 @@
+module Fog
+  module AWS
+    class Support
+      class Real
+        # Describe Trusted Advisor Check Result
+        # http://docs.aws.amazon.com/awssupport/latest/APIReference/API_DescribeTrustedAdvisorCheckResult.html
+        # ==== Parameters
+        # * checkId <~String>  - Id of the check obtained from #describe_trusted_advisor_checks
+        # * language <~String> - Language to return.  Supported values are 'en' and 'jp'
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>
+        def describe_trusted_advisor_check_result(options={})
+          request(
+            'Action'   => 'DescribeTrustedAdvisorCheckResult',
+            'checkId'  => options[:id],
+            'language' => options[:language] || 'en'
+          )
+        end
+      end
+
+      class Mock
+        def describe_trusted_advisor_check_result(options={})
+          response = Excon::Response.new
+          response.body = {'result' => self.data[:trusted_advisor_check_results][options[:id]]}
+          response
+        end
+      end
+    end
+  end
+end

data/lib/fog/aws/requests/support/describe_trusted_advisor_checks.rb

@@ -0,0 +1,29 @@
+module Fog
+  module AWS
+    class Support
+      class Real
+        # Describe Trusted Advisor Checks
+        # http://docs.aws.amazon.com/awssupport/latest/APIReference/API_DescribeTrustedAdvisorChecks.html
+        # ==== Parameters
+        # * language <~String> - Language to return.  Supported values are 'en' and 'jp'
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>
+        def describe_trusted_advisor_checks(options={})
+          request(
+            'Action'   => 'DescribeTrustedAdvisorChecks',
+            'language' => options[:language] || 'en'
+          )
+        end
+      end
+
+      class Mock
+        def describe_trusted_advisor_checks(options={})
+          response = Excon::Response.new
+          response.body = {'checks' => self.data[:trusted_advisor_checks].values}
+          response
+        end
+      end
+    end
+  end
+end

data/lib/fog/aws/support.rb

@@ -0,0 +1,170 @@
+module Fog
+  module AWS
+    class Support < Fog::Service
+      extend Fog::AWS::CredentialFetcher::ServiceMethods
+
+      requires :aws_access_key_id, :aws_secret_access_key
+      recognizes :host, :path, :port, :scheme, :instrumentor, :instrumentor_name, :region, :persistent, :aws_session_token
+
+      model_path 'fog/aws/models/support'
+      request_path 'fog/aws/requests/support'
+
+      collection :flagged_resources
+      collection :trusted_advisor_checks
+
+      model :flagged_resource
+      model :trusted_advisor_check
+
+      request :describe_trusted_advisor_checks
+      request :describe_trusted_advisor_check_result
+
+      class Mock
+        def self.data
+          @data ||= Hash.new do |hash, region|
+            hash[region] = Hash.new do |region_hash, key|
+              tac_id = Fog::Mock.random_hex(5)
+              region_hash[key] = {
+                :trusted_advisor_checks => {
+                  tac_id => {
+                    "category"=>"cost_optimizing",
+                    "description"=>"Checks the Amazon Elastic Compute Cloud (Amazon EC2) instances that were running at any time during the last 14 days and alerts you if the daily CPU utilization was 10% or less and network I/O was 5 MB or less on 4 or more days. Running instances generate hourly usage charges. Although some scenarios can result in low utilization by design, you can often lower your costs by managing the number and size of your instances.\n<br><br>\nEstimated monthly savings are calculated by using the current usage rate for On-Demand Instances and the estimated number of days the instance might be underutilized. Actual savings will vary if you are using Reserved Instances or Spot Instances, or if the instance is not running for a full day. To get daily utilization data, download the report for this check. \n<br>\n<br>\n<b>Alert Criteria</b><br>\nYellow: An instance had 10% or less daily average CPU utilization and 5 MB or less network I/O on at least 4 of the previous 14 days.<br>\n<br>\n<b>Recommended Action</b><br>\nConsider stopping or terminating instances that have low utilization, or scale the number of instances by using Auto Scaling. For more information, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Stop_Start.html\" target=\"_blank\">Stop and Start Your Instance</a>, <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html\" target=\"_blank\">Terminate Your Instance</a>, and <a href=\"http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/WhatIsAutoScaling.html\" target=\"_blank\">What is Auto Scaling?</a><br>\n<br>\n<b>Additional Resources</b><br>\n<a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-monitoring.html\" target=\"_blank\">Monitoring Amazon EC2</a><br>\n<a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AESDG-chapter-instancedata.html\" target=\"_blank\">Instance Metadata and User Data</a><br>\n<a href=\"http://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/Welcome.html\" target=\"_blank\">Amazon CloudWatch Developer Guide</a><br>\n<a href=\"http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/WhatIsAutoScaling.html\" target=\"_blank\">Auto Scaling Developer Guide</a>",
+                    "id"=>tac_id,
+                    "metadata"=>["Region/AZ", "Instance ID", "Instance Name", "Instance Type", "Estimated Monthly Savings", "Day 1", "Day 2", "Day 3", "Day 4", "Day 5", "Day 6", "Day 7", "Day 8", "Day 9", "Day 10", "Day 11", "Day 12", "Day 13", "Day 14", "14-Day Average CPU Utilization", "14-Day Average Network I/O", "Number of Days Low Utilization"],
+                    "name"=>"Low Utilization Amazon EC2 Instances"
+                  }
+                },
+                :trusted_advisor_check_results => {
+                  tac_id => {
+                    'checkId'          => tac_id,
+                    'status'           => "warning",
+                    'timestamp'        => "2016-09-18T13:19:35Z",
+                    'resourcesSummary' => {
+                      "resourcesFlagged"    => 40,
+                      "resourcesIgnored"    => 0,
+                      "resourcesProcessed"  => 47,
+                      "resourcesSuppressed" => 0
+                    },
+                    'categorySpecificSummary' => {
+                      "costOptimizing" => {
+                        "estimatedMonthlySavings"        => 4156.920000000003,
+                        "estimatedPercentMonthlySavings" => 0.9918398900532555
+                      }
+                    },
+                    'flaggedResources' => [{
+                      "region"       => "us-west-2",
+                      "resourceId"   => Fog::Mock.random_hex(22),
+                      "status"       => "warning",
+                      "isSuppressed" => false,
+                      "metadata"     => ["us-west-2a", "i-#{Fog::Mock.random_hex(5)}", "instance_tags", "m3.large", "$95.76", "2.3%  0.23MB", "2.3%  0.20MB", "2.3%  0.21MB", "2.4%  0.28MB", "2.3%  0.20MB", "2.3%  0.20MB", "2.3%  0.20MB", "2.3%  0.20MB", "2.3%  0.20MB", "2.3%  0.20MB", "2.6%  0.54MB", "2.4%  0.31MB", "2.3%  0.21MB", "2.3%  0.20MB", "2.3%", "0.24MB", "14 days"]
+                    }]
+                  }
+                }
+              }
+            end
+          end
+        end
+
+        def self.reset
+          @data = nil
+        end
+
+        def reset
+          self.class.reset
+        end
+
+        attr_accessor :region
+
+        def initialize(options={})
+          @region = 'us-east-1'
+        end
+
+        def data
+          self.class.data[@region][@aws_access_key_id]
+        end
+      end
+
+      class Real
+        include Fog::AWS::CredentialFetcher::ConnectionMethods
+
+        def initialize(options={})
+          @connection_options = options[:connection_options] || {}
+          @instrumentor       = options[:instrumentor]
+          @instrumentor_name  = options[:instrumentor_name] || 'fog.aws.support'
+
+          @region     = 'us-east-1'
+          @host       = options[:host]       || "support.#{@region}.amazonaws.com"
+          @path       = options[:path]       || "/"
+          @port       = options[:port]       || 443
+          @scheme     = options[:scheme]     || "https"
+          @persistent = options[:persistent] || false
+          @connection = Fog::XML::Connection.new("#{@scheme}://#{@host}:#{@port}#{@path}", @persistent, @connection_options)
+          @version    = options[:version]    || '2013-04-15'
+
+          setup_credentials(options)
+        end
+
+        def reload
+          @connection.reset
+        end
+
+        def setup_credentials(options)
+          @aws_access_key_id         = options[:aws_access_key_id]
+          @aws_secret_access_key     = options[:aws_secret_access_key]
+          @aws_session_token         = options[:aws_session_token]
+          @aws_credentials_expire_at = options[:aws_credentials_expire_at]
+
+          #global services that have no region are signed with the us-east-1 region
+          #the only exception is GovCloud, which requires the region to be explicitly specified as us-gov-west-1
+          @signer = Fog::AWS::SignatureV4.new(@aws_access_key_id, @aws_secret_access_key, @region, 'support')
+        end
+
+        def request(params)
+          refresh_credentials_if_expired
+          idempotent   = params.delete(:idempotent)
+          parser       = params.delete(:parser)
+          action       = params.delete('Action')
+          request_body = Fog::JSON.encode(params)
+
+          body, headers = Fog::AWS.signed_params_v4(
+            params,
+            {
+              'Content-Type' => "application/x-amz-json-1.1",
+              "X-Amz-Target" => "AWSSupport_#{@version.gsub("-", "")}.#{action}"
+            },
+            {
+              :host               => @host,
+              :path               => @path,
+              :port               => @port,
+              :version            => @version,
+              :signer             => @signer,
+              :aws_session_token  => @aws_session_token,
+              :method             => 'POST',
+              :body               => request_body
+            }
+          )
+
+          if @instrumentor
+            @instrumentor.instrument("#{@instrumentor_name}.request", params) do
+              _request(body, headers, idempotent, parser)
+            end
+          else
+            _request(body, headers, idempotent, parser)
+          end
+        end
+
+        def _request(body, headers, idempotent, parser)
+          response = @connection.request({
+            :body       => body,
+            :expects    => 200,
+            :idempotent => idempotent,
+            :headers    => headers,
+            :method     => 'POST',
+            :parser     => parser
+          })
+          response.body = Fog::JSON.decode(response.body)
+          response
+        end
+      end
+    end
+  end
+end

data/lib/fog/aws/version.rb

@@ -1,5 +1,5 @@
 module Fog
   module AWS
-    VERSION = "0.11.0"
+    VERSION = "0.12.0"
   end
 end

data/tests/models/compute/security_group_tests.rb

@@ -35,6 +35,30 @@ Shindo.tests("Fog::Compute[:aws] | security_group", ['aws']) do
       @group.ip_permissions.empty?
     end
 
+    test("authorize access at a port range (egress rule)") do
+      @group.authorize_port_range(5000..6000, :direction => 'egress')
+      @group.reload
+      ip_permission_egress = @group.ip_permissions_egress.find do |permission|
+        permission['fromPort'] == 5000 &&
+          permission['toPort'] == 6000 &&
+          permission['ipProtocol'] == 'tcp' &&
+          permission['ipRanges'] == [{ 'cidrIp' => '0.0.0.0/0' }]
+      end
+      !ip_permission_egress.nil?
+    end
+
+    test("revoke access at a port range (egress rule)") do
+      @group.revoke_port_range(5000..6000, :direction => 'egress')
+      @group.reload
+      ip_permission_egress = @group.ip_permissions_egress.find do |permission|
+        permission['fromPort'] == 5000 &&
+          permission['toPort'] == 6000 &&
+          permission['ipProtocol'] == 'tcp' &&
+          permission['ipRanges'] == [{ 'cidrIp' => '0.0.0.0/0' }]
+      end
+      ip_permission_egress.nil?
+    end
+
     group_forms = [
       "#{@other_group.owner_id}:#{@other_group.group_id}", # deprecated form
       @other_group.group_id,

data/tests/models/support/trusted_advisor_tests.rb

@@ -0,0 +1,25 @@
+Shindo.tests("AWS::Support | trusted_advisor_checks", ["aws", "support"]) do
+  tests("collection#all").succeeds do
+    Fog::AWS[:support].trusted_advisor_checks.all
+  end
+
+  @identity = Fog::AWS[:support].trusted_advisor_checks.all.first.identity
+
+  tests("collection#get(#{@identity})").returns(@identity) do
+    Fog::AWS[:support].trusted_advisor_checks.get(@identity).identity
+  end
+
+  @model = Fog::AWS[:support].trusted_advisor_checks.all.detect { |tac| tac.id == @identity }
+
+  tests("model#flagged_resources").returns(nil) do
+    @model.flagged_resources
+  end
+
+  tests("model#flagged_resources").returns(true) do
+    @model.flagged_resources(false).is_a?(Fog::AWS::Support::FlaggedResources)
+  end
+
+  tests("model#flagged_resources").returns(true) do
+    @model.flagged_resources.first.metadata.keys.sort == @model.metadata.sort
+  end
+end

data/tests/requests/support/helper.rb

@@ -0,0 +1,43 @@
+class AWS
+  module Support
+    module Formats
+      TRUSTED_ADVISOR_CHECK_FORMAT = {
+        'id'          => String,
+        'name'        => String,
+        'description' => String,
+        'metadata'    => Array,
+        'category'    => String,
+      }
+
+      FLAGGED_RESOURCE = {
+        'isSuppressed' => Fog::Boolean,
+        'metadata'     => Array,
+        'region'       => String,
+        'resourceId'   => String,
+        'status'       => String
+      }
+
+      TRUSTED_ADVISOR_CHECK_RESULT_FORMAT = {
+        'categorySpecificSummary' => Hash,
+        'checkId'                 => String,
+        'flaggedResources'        => [FLAGGED_RESOURCE],
+        'resourcesSummary'        => {
+          'resourcesFlagged'    => Integer,
+          'resourcesIgnored'    => Integer,
+          'resourcesProcessed'  => Integer,
+          'resourcesSuppressed' => Integer
+        },
+        'status'                  => String,
+        'timestamp'               => String
+      }
+
+      DESCRIBE_TRUSTED_ADVISOR_CHECKS = {
+        'checks' => [TRUSTED_ADVISOR_CHECK_FORMAT]
+      }
+
+      DESCRIBE_TRUSTED_ADVISOR_CHECK_RESULT = {
+        'result' => TRUSTED_ADVISOR_CHECK_RESULT_FORMAT
+      }
+    end
+  end
+end

data/tests/requests/support/trusted_advisor_check_tests.rb

@@ -0,0 +1,16 @@
+Shindo.tests("AWS::Support | describe_trusted_advisor_checks", ['aws', 'support']) do
+  tests("#describe_trusted_advisor_checks").formats(AWS::Support::Formats::DESCRIBE_TRUSTED_ADVISOR_CHECKS) do
+    Fog::AWS[:support].describe_trusted_advisor_checks.body
+  end
+
+  # things get weird in the mocked data depending on the order the model and requests run in
+  if Fog.mocking?
+    Fog::AWS[:support].reset
+  end
+
+  @check_id = Fog::AWS[:support].describe_trusted_advisor_checks.body['checks'].first['id']
+
+  tests("#describe_trusted_advisor_check_result(id: #{@check_id})").formats(AWS::Support::Formats::DESCRIBE_TRUSTED_ADVISOR_CHECK_RESULT) do
+    Fog::AWS[:support].describe_trusted_advisor_check_result(:id => @check_id).body
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fog-aws
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Josh Lane
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-08-04 00:00:00.000000000 Z
+date: 2016-09-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -319,6 +319,10 @@ files:
 - lib/fog/aws/models/storage/files.rb
 - lib/fog/aws/models/storage/version.rb
 - lib/fog/aws/models/storage/versions.rb
+- lib/fog/aws/models/support/flagged_resource.rb
+- lib/fog/aws/models/support/flagged_resources.rb
+- lib/fog/aws/models/support/trusted_advisor_check.rb
+- lib/fog/aws/models/support/trusted_advisor_checks.rb
 - lib/fog/aws/parsers/auto_scaling/basic.rb
 - lib/fog/aws/parsers/auto_scaling/describe_adjustment_types.rb
 - lib/fog/aws/parsers/auto_scaling/describe_auto_scaling_groups.rb
@@ -367,11 +371,19 @@ files:
 - lib/fog/aws/parsers/cdn/post_invalidation.rb
 - lib/fog/aws/parsers/cdn/streaming_distribution.rb
 - lib/fog/aws/parsers/cloud_formation/basic.rb
+- lib/fog/aws/parsers/cloud_formation/create_change_set.rb
 - lib/fog/aws/parsers/cloud_formation/create_stack.rb
+- lib/fog/aws/parsers/cloud_formation/describe_account_limits.rb
+- lib/fog/aws/parsers/cloud_formation/describe_change_set.rb
 - lib/fog/aws/parsers/cloud_formation/describe_stack_events.rb
+- lib/fog/aws/parsers/cloud_formation/describe_stack_resource.rb
 - lib/fog/aws/parsers/cloud_formation/describe_stack_resources.rb
 - lib/fog/aws/parsers/cloud_formation/describe_stacks.rb
+- lib/fog/aws/parsers/cloud_formation/estimate_template_cost.rb
+- lib/fog/aws/parsers/cloud_formation/get_stack_policy.rb
 - lib/fog/aws/parsers/cloud_formation/get_template.rb
+- lib/fog/aws/parsers/cloud_formation/get_template_summary.rb
+- lib/fog/aws/parsers/cloud_formation/list_change_sets.rb
 - lib/fog/aws/parsers/cloud_formation/list_stack_resources.rb
 - lib/fog/aws/parsers/cloud_formation/list_stacks.rb
 - lib/fog/aws/parsers/cloud_formation/update_stack.rb
@@ -791,14 +803,28 @@ files:
 - lib/fog/aws/requests/cdn/post_streaming_distribution.rb
 - lib/fog/aws/requests/cdn/put_distribution_config.rb
 - lib/fog/aws/requests/cdn/put_streaming_distribution_config.rb
+- lib/fog/aws/requests/cloud_formation/cancel_update_stack.rb
+- lib/fog/aws/requests/cloud_formation/continue_update_rollback.rb
+- lib/fog/aws/requests/cloud_formation/create_change_set.rb
 - lib/fog/aws/requests/cloud_formation/create_stack.rb
+- lib/fog/aws/requests/cloud_formation/delete_change_set.rb
 - lib/fog/aws/requests/cloud_formation/delete_stack.rb
+- lib/fog/aws/requests/cloud_formation/describe_account_limits.rb
+- lib/fog/aws/requests/cloud_formation/describe_change_set.rb
 - lib/fog/aws/requests/cloud_formation/describe_stack_events.rb
+- lib/fog/aws/requests/cloud_formation/describe_stack_resource.rb
 - lib/fog/aws/requests/cloud_formation/describe_stack_resources.rb
 - lib/fog/aws/requests/cloud_formation/describe_stacks.rb
+- lib/fog/aws/requests/cloud_formation/estimate_template_cost.rb
+- lib/fog/aws/requests/cloud_formation/execute_change_set.rb
+- lib/fog/aws/requests/cloud_formation/get_stack_policy.rb
 - lib/fog/aws/requests/cloud_formation/get_template.rb
+- lib/fog/aws/requests/cloud_formation/get_template_summary.rb
+- lib/fog/aws/requests/cloud_formation/list_change_sets.rb
 - lib/fog/aws/requests/cloud_formation/list_stack_resources.rb
 - lib/fog/aws/requests/cloud_formation/list_stacks.rb
+- lib/fog/aws/requests/cloud_formation/set_stack_policy.rb
+- lib/fog/aws/requests/cloud_formation/signal_resource.rb
 - lib/fog/aws/requests/cloud_formation/update_stack.rb
 - lib/fog/aws/requests/cloud_formation/validate_template.rb
 - lib/fog/aws/requests/cloud_watch/delete_alarms.rb
@@ -821,6 +847,7 @@ files:
 - lib/fog/aws/requests/compute/attach_internet_gateway.rb
 - lib/fog/aws/requests/compute/attach_network_interface.rb
 - lib/fog/aws/requests/compute/attach_volume.rb
+- lib/fog/aws/requests/compute/authorize_security_group_egress.rb
 - lib/fog/aws/requests/compute/authorize_security_group_ingress.rb
 - lib/fog/aws/requests/compute/cancel_spot_instance_requests.rb
 - lib/fog/aws/requests/compute/copy_image.rb
@@ -918,6 +945,7 @@ files:
 - lib/fog/aws/requests/compute/replace_route.rb
 - lib/fog/aws/requests/compute/request_spot_instances.rb
 - lib/fog/aws/requests/compute/reset_network_interface_attribute.rb
+- lib/fog/aws/requests/compute/revoke_security_group_egress.rb
 - lib/fog/aws/requests/compute/revoke_security_group_ingress.rb
 - lib/fog/aws/requests/compute/run_instances.rb
 - lib/fog/aws/requests/compute/start_instances.rb
@@ -1351,6 +1379,8 @@ files:
 - lib/fog/aws/requests/sts/assume_role_with_web_identity.rb
 - lib/fog/aws/requests/sts/get_federation_token.rb
 - lib/fog/aws/requests/sts/get_session_token.rb
+- lib/fog/aws/requests/support/describe_trusted_advisor_check_result.rb
+- lib/fog/aws/requests/support/describe_trusted_advisor_checks.rb
 - lib/fog/aws/ses.rb
 - lib/fog/aws/signaturev4.rb
 - lib/fog/aws/simpledb.rb
@@ -1358,6 +1388,7 @@ files:
 - lib/fog/aws/sqs.rb
 - lib/fog/aws/storage.rb
 - lib/fog/aws/sts.rb
+- lib/fog/aws/support.rb
 - lib/fog/aws/version.rb
 - tests/credentials_tests.rb
 - tests/helper.rb
@@ -1463,6 +1494,7 @@ files:
 - tests/models/storage/url_tests.rb
 - tests/models/storage/version_tests.rb
 - tests/models/storage/versions_tests.rb
+- tests/models/support/trusted_advisor_tests.rb
 - tests/parsers/elb/describe_load_balancers.rb
 - tests/requests/auto_scaling/auto_scaling_tests.rb
 - tests/requests/auto_scaling/describe_types_tests.rb
@@ -1601,6 +1633,8 @@ files:
 - tests/requests/sts/assume_role_with_web_identity_tests.rb
 - tests/requests/sts/get_federation_token_tests.rb
 - tests/requests/sts/session_token_tests.rb
+- tests/requests/support/helper.rb
+- tests/requests/support/trusted_advisor_check_tests.rb
 - tests/signaturev4_tests.rb
 - tests/signed_params_tests.rb
 - tests/storage_tests.rb
@@ -1629,4 +1663,3 @@ signing_key:
 specification_version: 4
 summary: Module for the 'fog' gem to support Amazon Web Services.
 test_files: []
-has_rdoc: