aws-sdk-elasticloadbalancingv2 1.0.0.rc2 → 1.0.0.rc3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: af5c053bcc0272f80625c9c68bebf6d7aeb0290c
-  data.tar.gz: 14a797c248f598786f0ff103c1c3c811aaa9622f
+  metadata.gz: c18f0db5c10dc0281b5469ff82e2e9e37f3edb64
+  data.tar.gz: 44a3329aa749df6888386dbe9abad796f8690486
 SHA512:
-  metadata.gz: 124c9ee14b89f932e604f0398bb489a2f9e773039332099e5a9ed7c2a397d558529519b5569389d1ffcfc22a622979b3d3681a1c23919c7af3a3b822b6babf1f
-  data.tar.gz: d4ba145deda9be880ad2053aba1deeba45ce571e5a59fae0c6da7058a20d87459b906a4899d382d2454c7692efb0ecc138b442eedda2dd38c9fa6cb2207afb0a
+  metadata.gz: 4038263c275bc13e0052c17f53a1b25b5990325f56c53679de0fb45a413156eeaed0547920dd68e2e01727ff5faf0657cc792e0e0074c13c37ff4950ece0a0c1
+  data.tar.gz: 78d9c4953b75edcaaf82f04f429f13f3a11bc6ae6934052e18ea4ae6c58bd6702a3276d0513efe147a1614e94ff12b628f830386d221bd838abff988cab3a5a9

data/lib/aws-sdk-elasticloadbalancingv2.rb

@@ -12,6 +12,7 @@ require_relative 'aws-sdk-elasticloadbalancingv2/types'
 require_relative 'aws-sdk-elasticloadbalancingv2/client_api'
 require_relative 'aws-sdk-elasticloadbalancingv2/client'
 require_relative 'aws-sdk-elasticloadbalancingv2/errors'
+require_relative 'aws-sdk-elasticloadbalancingv2/waiters'
 require_relative 'aws-sdk-elasticloadbalancingv2/resource'
 require_relative 'aws-sdk-elasticloadbalancingv2/customizations'
 
@@ -42,6 +43,6 @@ require_relative 'aws-sdk-elasticloadbalancingv2/customizations'
 # @service
 module Aws::ElasticLoadBalancingV2
 
-  GEM_VERSION = '1.0.0.rc2'
+  GEM_VERSION = '1.0.0.rc3'
 
 end

data/lib/aws-sdk-elasticloadbalancingv2/client.rb

@@ -18,6 +18,7 @@ require 'aws-sdk-core/plugins/regional_endpoint.rb'
 require 'aws-sdk-core/plugins/response_paging.rb'
 require 'aws-sdk-core/plugins/stub_responses.rb'
 require 'aws-sdk-core/plugins/idempotency_token.rb'
+require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/query.rb'
 
@@ -45,6 +46,7 @@ module Aws::ElasticLoadBalancingV2
     add_plugin(Aws::Plugins::ResponsePaging)
     add_plugin(Aws::Plugins::StubResponses)
     add_plugin(Aws::Plugins::IdempotencyToken)
+    add_plugin(Aws::Plugins::JsonvalueConverter)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::Query)
 
@@ -291,9 +293,9 @@ module Aws::ElasticLoadBalancingV2
     # @option params [required, String] :name
     #   The name of the load balancer.
     #
-    #   This name must be unique within your AWS account, can have a maximum
-    #   of 32 characters, must contain only alphanumeric characters or
-    #   hyphens, and must not begin or end with a hyphen.
+    #   This name must be unique per region per account, can have a maximum of
+    #   32 characters, must contain only alphanumeric characters or hyphens,
+    #   and must not begin or end with a hyphen.
     #
     # @option params [required, Array<String>] :subnets
     #   The IDs of the subnets to attach to the load balancer. You can specify
@@ -397,11 +399,25 @@ module Aws::ElasticLoadBalancingV2
     #   The Amazon Resource Name (ARN) of the listener.
     #
     # @option params [required, Array<Types::RuleCondition>] :conditions
-    #   A condition. Each condition has the field `path-pattern` and specifies
-    #   one path pattern. A path pattern is case sensitive, can be up to 128
-    #   characters in length, and can contain any of the following characters.
-    #   Note that you can include up to three wildcard characters in a path
-    #   pattern.
+    #   A condition. Each condition specifies a field name and a single value.
+    #
+    #   If the field name is `host-header`, you can specify a single host name
+    #   (for example, my.example.com). A host name is case insensitive, can be
+    #   up to 128 characters in length, and can contain any of the following
+    #   characters. Note that you can include up to three wildcard characters.
+    #
+    #   * A-Z, a-z, 0-9
+    #
+    #   * \- .
+    #
+    #   * * (matches 0 or more characters)
+    #
+    #   * ? (matches exactly 1 character)
+    #
+    #   If the field name is `path-pattern`, you can specify a single path
+    #   pattern. A path pattern is case sensitive, can be up to 128 characters
+    #   in length, and can contain any of the following characters. Note that
+    #   you can include up to three wildcard characters.
     #
     #   * A-Z, a-z, 0-9
     #
@@ -489,6 +505,10 @@ module Aws::ElasticLoadBalancingV2
     # @option params [required, String] :name
     #   The name of the target group.
     #
+    #   This name must be unique per region per account, can have a maximum of
+    #   32 characters, must contain only alphanumeric characters or hyphens,
+    #   and must not begin or end with a hyphen.
+    #
     # @option params [required, String] :protocol
     #   The protocol to use for routing traffic to the targets.
     #
@@ -815,7 +835,8 @@ module Aws::ElasticLoadBalancingV2
     # DescribeLoadBalancerAttributes.
     #
     # @option params [Array<String>] :load_balancer_arns
-    #   The Amazon Resource Names (ARN) of the load balancers.
+    #   The Amazon Resource Names (ARN) of the load balancers. You can specify
+    #   up to 20 load balancers in a single call.
     #
     # @option params [Array<String>] :names
     #   The names of the load balancers.
@@ -917,8 +938,12 @@ module Aws::ElasticLoadBalancingV2
     # Describes the specified policies or all policies used for SSL
     # negotiation.
     #
-    # Note that the only supported policy at this time is
-    # ELBSecurityPolicy-2015-05.
+    # For more information, see [Security Policies][1] in the *Application
+    # Load Balancers Guide*.
+    #
+    #
+    #
+    # [1]: http://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-https-listener.html#describe-ssl-policies
     #
     # @option params [Array<String>] :names
     #   The names of the policies.
@@ -963,7 +988,8 @@ module Aws::ElasticLoadBalancingV2
       req.send_request(options)
     end
 
-    # Describes the tags for the specified resources.
+    # Describes the tags for the specified resources. You can describe the
+    # tags for one or more Application Load Balancers and target groups.
     #
     # @option params [required, Array<String>] :resource_arns
     #   The Amazon Resource Names (ARN) of the resources.
@@ -1143,7 +1169,8 @@ module Aws::ElasticLoadBalancingV2
     # Any properties that you do not specify retain their current values.
     # However, changing the protocol from HTTPS to HTTP removes the security
     # policy and SSL certificate properties. If you change the protocol from
-    # HTTP to HTTPS, you must add the security policy.
+    # HTTP to HTTPS, you must add the security policy and server
+    # certificate.
     #
     # @option params [required, String] :listener_arn
     #   The Amazon Resource Name (ARN) of the listener.
@@ -1155,8 +1182,13 @@ module Aws::ElasticLoadBalancingV2
     #   The protocol for connections from clients to the load balancer.
     #
     # @option params [String] :ssl_policy
-    #   The security policy that defines which ciphers and protocols are
-    #   supported.
+    #   The security policy that defines which protocols and ciphers are
+    #   supported. For more information, see [Security Policies][1] in the
+    #   *Application Load Balancers Guide*.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-https-listener.html#describe-ssl-policies
     #
     # @option params [Array<Types::Certificate>] :certificates
     #   The SSL server certificate.
@@ -1679,14 +1711,131 @@ module Aws::ElasticLoadBalancingV2
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-elasticloadbalancingv2'
-      context[:gem_version] = '1.0.0.rc2'
+      context[:gem_version] = '1.0.0.rc3'
       Seahorse::Client::Request.new(handlers, context)
     end
 
+    # Polls an API operation until a resource enters a desired state.
+    #
+    # ## Basic Usage
+    #
+    # A waiter will call an API operation until:
+    #
+    # * It is successful
+    # * It enters a terminal state
+    # * It makes the maximum number of attempts
+    #
+    # In between attempts, the waiter will sleep.
+    #
+    #     # polls in a loop, sleeping between attempts
+    #     client.waiter_until(waiter_name, params)
+    #
+    # ## Configuration
+    #
+    # You can configure the maximum number of polling attempts, and the
+    # delay (in seconds) between each polling attempt. You can pass
+    # configuration as the final arguments hash.
+    #
+    #     # poll for ~25 seconds
+    #     client.wait_until(waiter_name, params, {
+    #       max_attempts: 5,
+    #       delay: 5,
+    #     })
+    #
+    # ## Callbacks
+    #
+    # You can be notified before each polling attempt and before each
+    # delay. If you throw `:success` or `:failure` from these callbacks,
+    # it will terminate the waiter.
+    #
+    #     started_at = Time.now
+    #     client.wait_until(waiter_name, params, {
+    #
+    #       # disable max attempts
+    #       max_attempts: nil,
+    #
+    #       # poll for 1 hour, instead of a number of attempts
+    #       before_wait: -> (attempts, response) do
+    #         throw :failure if Time.now - started_at > 3600
+    #       end
+    #     })
+    #
+    # ## Handling Errors
+    #
+    # When a waiter is unsuccessful, it will raise an error.
+    # All of the failure errors extend from
+    # {Aws::Waiters::Errors::WaiterFailed}.
+    #
+    #     begin
+    #       client.wait_until(...)
+    #     rescue Aws::Waiters::Errors::WaiterFailed
+    #       # resource did not enter the desired state in time
+    #     end
+    #
+    # ## Valid Waiters
+    #
+    # The following table lists the valid waiter names, the operations they call,
+    # and the default `:delay` and `:max_attempts` values.
+    #
+    # | waiter_name             | params                     | :delay   | :max_attempts |
+    # | ----------------------- | -------------------------- | -------- | ------------- |
+    # | load_balancer_available | {#describe_load_balancers} | 15       | 40            |
+    # | load_balancer_exists    | {#describe_load_balancers} | 15       | 40            |
+    # | load_balancers_deleted  | {#describe_load_balancers} | 15       | 40            |
+    #
+    # @raise [Errors::FailureStateError] Raised when the waiter terminates
+    #   because the waiter has entered a state that it will not transition
+    #   out of, preventing success.
+    #
+    # @raise [Errors::TooManyAttemptsError] Raised when the configured
+    #   maximum number of attempts have been made, and the waiter is not
+    #   yet successful.
+    #
+    # @raise [Errors::UnexpectedError] Raised when an error is encounted
+    #   while polling for a resource that is not expected.
+    #
+    # @raise [Errors::NoSuchWaiterError] Raised when you request to wait
+    #   for an unknown state.
+    #
+    # @return [Boolean] Returns `true` if the waiter was successful.
+    # @param [Symbol] waiter_name
+    # @param [Hash] params ({})
+    # @param [Hash] options ({})
+    # @option options [Integer] :max_attempts
+    # @option options [Integer] :delay
+    # @option options [Proc] :before_attempt
+    # @option options [Proc] :before_wait
+    def wait_until(waiter_name, params = {}, options = {})
+      w = waiter(waiter_name, options)
+      yield(w.waiter) if block_given? # deprecated
+      w.wait(params)
+    end
+
     # @api private
     # @deprecated
     def waiter_names
-      []
+      waiters.keys
+    end
+
+    private
+
+    # @param [Symbol] waiter_name
+    # @param [Hash] options ({})
+    def waiter(waiter_name, options = {})
+      waiter_class = waiters[waiter_name]
+      if waiter_class
+        waiter_class.new(options.merge(client: self))
+      else
+        raise Aws::Waiters::Errors::NoSuchWaiterError.new(waiter_name, waiters.keys)
+      end
+    end
+
+    def waiters
+      {
+        load_balancer_available: Waiters::LoadBalancerAvailable,
+        load_balancer_exists: Waiters::LoadBalancerExists,
+        load_balancers_deleted: Waiters::LoadBalancersDeleted
+      }
     end
 
     class << self

data/lib/aws-sdk-elasticloadbalancingv2/types.rb

@@ -214,7 +214,7 @@ module Aws::ElasticLoadBalancingV2
     # @!attribute [rw] name
     #   The name of the load balancer.
     #
-    #   This name must be unique within your AWS account, can have a maximum
+    #   This name must be unique per region per account, can have a maximum
     #   of 32 characters, must contain only alphanumeric characters or
     #   hyphens, and must not begin or end with a hyphen.
     #   @return [String]
@@ -304,11 +304,28 @@ module Aws::ElasticLoadBalancingV2
     #   @return [String]
     #
     # @!attribute [rw] conditions
-    #   A condition. Each condition has the field `path-pattern` and
-    #   specifies one path pattern. A path pattern is case sensitive, can be
-    #   up to 128 characters in length, and can contain any of the following
+    #   A condition. Each condition specifies a field name and a single
+    #   value.
+    #
+    #   If the field name is `host-header`, you can specify a single host
+    #   name (for example, my.example.com). A host name is case insensitive,
+    #   can be up to 128 characters in length, and can contain any of the
+    #   following characters. Note that you can include up to three wildcard
+    #   characters.
+    #
+    #   * A-Z, a-z, 0-9
+    #
+    #   * \- .
+    #
+    #   * * (matches 0 or more characters)
+    #
+    #   * ? (matches exactly 1 character)
+    #
+    #   If the field name is `path-pattern`, you can specify a single path
+    #   pattern. A path pattern is case sensitive, can be up to 128
+    #   characters in length, and can contain any of the following
     #   characters. Note that you can include up to three wildcard
-    #   characters in a path pattern.
+    #   characters.
     #
     #   * A-Z, a-z, 0-9
     #
@@ -374,6 +391,10 @@ module Aws::ElasticLoadBalancingV2
     #
     # @!attribute [rw] name
     #   The name of the target group.
+    #
+    #   This name must be unique per region per account, can have a maximum
+    #   of 32 characters, must contain only alphanumeric characters or
+    #   hyphens, and must not begin or end with a hyphen.
     #   @return [String]
     #
     # @!attribute [rw] protocol
@@ -676,7 +697,8 @@ module Aws::ElasticLoadBalancingV2
     #       }
     #
     # @!attribute [rw] load_balancer_arns
-    #   The Amazon Resource Names (ARN) of the load balancers.
+    #   The Amazon Resource Names (ARN) of the load balancers. You can
+    #   specify up to 20 load balancers in a single call.
     #   @return [Array<String>]
     #
     # @!attribute [rw] names
@@ -1163,9 +1185,9 @@ module Aws::ElasticLoadBalancingV2
     #       }
     #
     # @!attribute [rw] http_code
-    #   The HTTP codes. The default value is 200. You can specify multiple
-    #   values (for example, "200,202") or a range of values (for example,
-    #   "200-299").
+    #   The HTTP codes. You can specify values between 200 and 499. The
+    #   default value is 200. You can specify multiple values (for example,
+    #   "200,202") or a range of values (for example, "200-299").
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancingv2-2015-12-01/Matcher AWS API Documentation
@@ -1209,8 +1231,13 @@ module Aws::ElasticLoadBalancingV2
     #   @return [String]
     #
     # @!attribute [rw] ssl_policy
-    #   The security policy that defines which ciphers and protocols are
-    #   supported.
+    #   The security policy that defines which protocols and ciphers are
+    #   supported. For more information, see [Security Policies][1] in the
+    #   *Application Load Balancers Guide*.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-https-listener.html#describe-ssl-policies
     #   @return [String]
     #
     # @!attribute [rw] certificates
@@ -1567,15 +1594,32 @@ module Aws::ElasticLoadBalancingV2
     #       }
     #
     # @!attribute [rw] field
-    #   The only possible value is `path-pattern`.
+    #   The name of the field. The possible values are `host-header` and
+    #   `path-pattern`.
     #   @return [String]
     #
     # @!attribute [rw] values
-    #   The path pattern. You can specify a single path pattern.
+    #   The condition value.
+    #
+    #   If the field name is `host-header`, you can specify a single host
+    #   name (for example, my.example.com). A host name is case insensitive,
+    #   can be up to 128 characters in length, and can contain any of the
+    #   following characters. Note that you can include up to three wildcard
+    #   characters.
+    #
+    #   * A-Z, a-z, 0-9
+    #
+    #   * \- .
+    #
+    #   * * (matches 0 or more characters)
+    #
+    #   * ? (matches exactly 1 character)
     #
-    #   A path pattern is case sensitive, can be up to 128 characters in
-    #   length, and can contain any of the following characters. Note that
-    #   you can include up to three wildcard characters in a path pattern.
+    #   If the field name is `path-pattern`, you can specify a single path
+    #   pattern (for example, /img/*). A path pattern is case sensitive,
+    #   can be up to 128 characters in length, and can contain any of the
+    #   following characters. Note that you can include up to three wildcard
+    #   characters.
     #
     #   * A-Z, a-z, 0-9
     #

data/lib/aws-sdk-elasticloadbalancingv2/waiters.rb

@@ -0,0 +1,147 @@
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing guide for more information:
+# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+require 'aws-sdk-core/waiters'
+
+module Aws::ElasticLoadBalancingV2
+  module Waiters
+
+    class LoadBalancerAvailable
+
+      # @param [Hash] options
+      # @option options [required, Client] :client
+      # @option options [Integer] :max_attempts (40)
+      # @option options [Integer] :delay (15)
+      # @option options [Proc] :before_attempt
+      # @option options [Proc] :before_wait
+      def initialize(options)
+        @client = options.fetch(:client)
+        @waiter = Aws::Waiters::Waiter.new({
+          max_attempts: 40,
+          delay: 15,
+          poller: Aws::Waiters::Poller.new(
+            operation_name: :describe_load_balancers,
+            acceptors: [
+              {
+                "state" => "success",
+                "matcher" => "pathAll",
+                "argument" => "load_balancers[].state.code",
+                "expected" => "active"
+              },
+              {
+                "state" => "retry",
+                "matcher" => "pathAny",
+                "argument" => "load_balancers[].state.code",
+                "expected" => "provisioning"
+              },
+              {
+                "state" => "retry",
+                "matcher" => "error",
+                "expected" => "LoadBalancerNotFound"
+              }
+            ]
+          )
+        }.merge(options))
+      end
+
+      # @option (see Client#describe_load_balancers)
+      # @return (see Client#describe_load_balancers)
+      def wait(params = {})
+        @waiter.wait(client: @client, params: params)
+      end
+
+      # @api private
+      attr_reader :waiter
+
+    end
+
+    class LoadBalancerExists
+
+      # @param [Hash] options
+      # @option options [required, Client] :client
+      # @option options [Integer] :max_attempts (40)
+      # @option options [Integer] :delay (15)
+      # @option options [Proc] :before_attempt
+      # @option options [Proc] :before_wait
+      def initialize(options)
+        @client = options.fetch(:client)
+        @waiter = Aws::Waiters::Waiter.new({
+          max_attempts: 40,
+          delay: 15,
+          poller: Aws::Waiters::Poller.new(
+            operation_name: :describe_load_balancers,
+            acceptors: [
+              {
+                "matcher" => "status",
+                "expected" => 200,
+                "state" => "success"
+              },
+              {
+                "matcher" => "error",
+                "expected" => "LoadBalancerNotFound",
+                "state" => "retry"
+              }
+            ]
+          )
+        }.merge(options))
+      end
+
+      # @option (see Client#describe_load_balancers)
+      # @return (see Client#describe_load_balancers)
+      def wait(params = {})
+        @waiter.wait(client: @client, params: params)
+      end
+
+      # @api private
+      attr_reader :waiter
+
+    end
+
+    class LoadBalancersDeleted
+
+      # @param [Hash] options
+      # @option options [required, Client] :client
+      # @option options [Integer] :max_attempts (40)
+      # @option options [Integer] :delay (15)
+      # @option options [Proc] :before_attempt
+      # @option options [Proc] :before_wait
+      def initialize(options)
+        @client = options.fetch(:client)
+        @waiter = Aws::Waiters::Waiter.new({
+          max_attempts: 40,
+          delay: 15,
+          poller: Aws::Waiters::Poller.new(
+            operation_name: :describe_load_balancers,
+            acceptors: [
+              {
+                "state" => "retry",
+                "matcher" => "pathAll",
+                "argument" => "load_balancers[].state.code",
+                "expected" => "active"
+              },
+              {
+                "matcher" => "error",
+                "expected" => "LoadBalancerNotFound",
+                "state" => "success"
+              }
+            ]
+          )
+        }.merge(options))
+      end
+
+      # @option (see Client#describe_load_balancers)
+      # @return (see Client#describe_load_balancers)
+      def wait(params = {})
+        @waiter.wait(client: @client, params: params)
+      end
+
+      # @api private
+      attr_reader :waiter
+
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-elasticloadbalancingv2
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc2
+  version: 1.0.0.rc3
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-03-07 00:00:00.000000000 Z
+date: 2017-04-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -53,6 +53,7 @@ files:
 - lib/aws-sdk-elasticloadbalancingv2/errors.rb
 - lib/aws-sdk-elasticloadbalancingv2/resource.rb
 - lib/aws-sdk-elasticloadbalancingv2/types.rb
+- lib/aws-sdk-elasticloadbalancingv2/waiters.rb
 homepage: http://github.com/aws/aws-sdk-ruby
 licenses:
 - Apache-2.0