aws-sdk-elasticbeanstalk 1.34.0 → 1.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ac6559fb1cf7ea7dce359370e30c8b1c8e2c6f4095b535d6095bae135d0ace2
-  data.tar.gz: b90c59a5c690527c41ca4cc5844402c8aa7234c883155e08cb871bcae6c01db0
+  metadata.gz: b479a886a9f936c4685ea92e16532996976308a2455569b3a680f382dabb4780
+  data.tar.gz: fa92d7fa8ceabc1cdf4d190e8f46d6316c10a258a5188fcab252b7a660d346a5
 SHA512:
-  metadata.gz: f69cfb1b8140201dd3025376e5447987c6bb1cf0399cd749693944bb6a23b581164010752b89ee08de477a745fa218fe41f675a133f68bdd7e8b6dd1685134f3
-  data.tar.gz: d79a58f8a5a432a3596d1433fc3d1c0dfe25f597e25b835b19a5ba26fc03a136c7eced6456a4dddda81240c0a566db82442204f056a00a6cdcee32d4db0a2709
+  metadata.gz: 72722e564f44a98dc4f442c20cf7c8cd305fee08c33bd5989fb00d9cfedc376061fe3f8b6ba102029bf461c80800f1f39072e939b25028191a1263e8a313a989
+  data.tar.gz: de5b28e55f745d69c0dc61d3388a116327e4309f3aa22ecfbd373d286c3986ea2106a016b8dc3cfd64de8ce1e5424a75f634e478d209f4240cea5d2cd4b07fe0

data/lib/aws-sdk-elasticbeanstalk.rb

@@ -7,6 +7,7 @@
 #
 # WARNING ABOUT GENERATED CODE
 
+
 require 'aws-sdk-core'
 require 'aws-sigv4'
 
@@ -14,6 +15,7 @@ require_relative 'aws-sdk-elasticbeanstalk/types'
 require_relative 'aws-sdk-elasticbeanstalk/client_api'
 require_relative 'aws-sdk-elasticbeanstalk/client'
 require_relative 'aws-sdk-elasticbeanstalk/errors'
+require_relative 'aws-sdk-elasticbeanstalk/waiters'
 require_relative 'aws-sdk-elasticbeanstalk/resource'
 require_relative 'aws-sdk-elasticbeanstalk/customizations'
 
@@ -44,9 +46,9 @@ require_relative 'aws-sdk-elasticbeanstalk/customizations'
 #
 # See {Errors} for more information.
 #
-# @service
+# @!group service
 module Aws::ElasticBeanstalk
 
-  GEM_VERSION = '1.34.0'
+  GEM_VERSION = '1.39.0'
 
 end

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

@@ -85,13 +85,28 @@ module Aws::ElasticBeanstalk
     #     * `Aws::Credentials` - Used for configuring static, non-refreshing
     #       credentials.
     #
+    #     * `Aws::SharedCredentials` - Used for loading static credentials from a
+    #       shared file, such as `~/.aws/config`.
+    #
+    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #
+    #     * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
+    #       assume a role after providing credentials via the web.
+    #
+    #     * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
+    #       access token generated from `aws login`.
+    #
+    #     * `Aws::ProcessCredentials` - Used for loading credentials from a
+    #       process that outputs to stdout.
+    #
     #     * `Aws::InstanceProfileCredentials` - Used for loading credentials
     #       from an EC2 IMDS on an EC2 instance.
     #
-    #     * `Aws::SharedCredentials` - Used for loading credentials from a
-    #       shared file, such as `~/.aws/config`.
+    #     * `Aws::ECSCredentials` - Used for loading credentials from
+    #       instances running in ECS.
     #
-    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #     * `Aws::CognitoIdentityCredentials` - Used for loading credentials
+    #       from the Cognito Identity service.
     #
     #     When `:credentials` are not configured directly, the following
     #     locations will be searched for credentials:
@@ -101,10 +116,10 @@ module Aws::ElasticBeanstalk
     #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
     #     * `~/.aws/credentials`
     #     * `~/.aws/config`
-    #     * EC2 IMDS instance profile - When used by default, the timeouts are
-    #       very aggressive. Construct and pass an instance of
-    #       `Aws::InstanceProfileCredentails` to enable retries and extended
-    #       timeouts.
+    #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
+    #       are very aggressive. Construct and pass an instance of
+    #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
+    #       enable retries and extended timeouts.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -534,7 +549,7 @@ module Aws::ElasticBeanstalk
     #   resp.environments[0].cname #=> String
     #   resp.environments[0].date_created #=> Time
     #   resp.environments[0].date_updated #=> Time
-    #   resp.environments[0].status #=> String, one of "Launching", "Updating", "Ready", "Terminating", "Terminated"
+    #   resp.environments[0].status #=> String, one of "Aborting", "Launching", "Updating", "LinkingFrom", "LinkingTo", "Ready", "Terminating", "Terminated"
     #   resp.environments[0].abortable_operation_in_progress #=> Boolean
     #   resp.environments[0].health #=> String, one of "Green", "Yellow", "Red", "Grey"
     #   resp.environments[0].health_status #=> String, one of "NoData", "Unknown", "Pending", "Ok", "Info", "Warning", "Degraded", "Severe", "Suspended"
@@ -1253,7 +1268,7 @@ module Aws::ElasticBeanstalk
     #   resp.cname #=> String
     #   resp.date_created #=> Time
     #   resp.date_updated #=> Time
-    #   resp.status #=> String, one of "Launching", "Updating", "Ready", "Terminating", "Terminated"
+    #   resp.status #=> String, one of "Aborting", "Launching", "Updating", "LinkingFrom", "LinkingTo", "Ready", "Terminating", "Terminated"
     #   resp.abortable_operation_in_progress #=> Boolean
     #   resp.health #=> String, one of "Green", "Yellow", "Red", "Grey"
     #   resp.health_status #=> String, one of "NoData", "Unknown", "Pending", "Ok", "Info", "Warning", "Degraded", "Severe", "Suspended"
@@ -2232,6 +2247,8 @@ module Aws::ElasticBeanstalk
     #   * {Types::DescribeEnvironmentManagedActionHistoryResult#managed_action_history_items #managed_action_history_items} => Array<Types::ManagedActionHistoryItem>
     #   * {Types::DescribeEnvironmentManagedActionHistoryResult#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_environment_managed_action_history({
@@ -2514,7 +2531,7 @@ module Aws::ElasticBeanstalk
     #   resp.environments[0].cname #=> String
     #   resp.environments[0].date_created #=> Time
     #   resp.environments[0].date_updated #=> Time
-    #   resp.environments[0].status #=> String, one of "Launching", "Updating", "Ready", "Terminating", "Terminated"
+    #   resp.environments[0].status #=> String, one of "Aborting", "Launching", "Updating", "LinkingFrom", "LinkingTo", "Ready", "Terminating", "Terminated"
     #   resp.environments[0].abortable_operation_in_progress #=> Boolean
     #   resp.environments[0].health #=> String, one of "Green", "Yellow", "Red", "Grey"
     #   resp.environments[0].health_status #=> String, one of "NoData", "Unknown", "Pending", "Ok", "Info", "Warning", "Degraded", "Severe", "Suspended"
@@ -2533,6 +2550,13 @@ module Aws::ElasticBeanstalk
     #   resp.environments[0].operations_role #=> String
     #   resp.next_token #=> String
     #
+    #
+    # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
+    #
+    #   * environment_exists
+    #   * environment_terminated
+    #   * environment_updated
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticbeanstalk-2010-12-01/DescribeEnvironments AWS API Documentation
     #
     # @overload describe_environments(params = {})
@@ -3151,6 +3175,8 @@ module Aws::ElasticBeanstalk
     #   * {Types::ListPlatformVersionsResult#platform_summary_list #platform_summary_list} => Array<Types::PlatformSummary>
     #   * {Types::ListPlatformVersionsResult#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_platform_versions({
@@ -3660,7 +3686,7 @@ module Aws::ElasticBeanstalk
     #   resp.cname #=> String
     #   resp.date_created #=> Time
     #   resp.date_updated #=> Time
-    #   resp.status #=> String, one of "Launching", "Updating", "Ready", "Terminating", "Terminated"
+    #   resp.status #=> String, one of "Aborting", "Launching", "Updating", "LinkingFrom", "LinkingTo", "Ready", "Terminating", "Terminated"
     #   resp.abortable_operation_in_progress #=> Boolean
     #   resp.health #=> String, one of "Green", "Yellow", "Red", "Grey"
     #   resp.health_status #=> String, one of "NoData", "Unknown", "Pending", "Ok", "Info", "Warning", "Degraded", "Severe", "Suspended"
@@ -4278,7 +4304,7 @@ module Aws::ElasticBeanstalk
     #   resp.cname #=> String
     #   resp.date_created #=> Time
     #   resp.date_updated #=> Time
-    #   resp.status #=> String, one of "Launching", "Updating", "Ready", "Terminating", "Terminated"
+    #   resp.status #=> String, one of "Aborting", "Launching", "Updating", "LinkingFrom", "LinkingTo", "Ready", "Terminating", "Terminated"
     #   resp.abortable_operation_in_progress #=> Boolean
     #   resp.health #=> String, one of "Green", "Yellow", "Red", "Grey"
     #   resp.health_status #=> String, one of "NoData", "Unknown", "Pending", "Ok", "Info", "Warning", "Degraded", "Severe", "Suspended"
@@ -4475,14 +4501,131 @@ module Aws::ElasticBeanstalk
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-elasticbeanstalk'
-      context[:gem_version] = '1.34.0'
+      context[:gem_version] = '1.39.0'
       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.wait_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 |
+    # | ---------------------- | ------------------------------ | -------- | ------------- |
+    # | environment_exists     | {Client#describe_environments} | 20       | 20            |
+    # | environment_terminated | {Client#describe_environments} | 20       | 20            |
+    # | environment_updated    | {Client#describe_environments} | 20       | 20            |
+    #
+    # @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
+      {
+        environment_exists: Waiters::EnvironmentExists,
+        environment_terminated: Waiters::EnvironmentTerminated,
+        environment_updated: Waiters::EnvironmentUpdated
+      }
     end
 
     class << self

data/lib/aws-sdk-elasticbeanstalk/client_api.rb

@@ -1440,6 +1440,12 @@ module Aws::ElasticBeanstalk
         o.input = Shapes::ShapeRef.new(shape: DescribeEnvironmentManagedActionHistoryRequest)
         o.output = Shapes::ShapeRef.new(shape: DescribeEnvironmentManagedActionHistoryResult)
         o.errors << Shapes::ShapeRef.new(shape: ElasticBeanstalkServiceException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_items",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
       end)
 
       api.add_operation(:describe_environment_managed_actions, Seahorse::Model::Operation.new.tap do |o|
@@ -1541,6 +1547,12 @@ module Aws::ElasticBeanstalk
         o.output = Shapes::ShapeRef.new(shape: ListPlatformVersionsResult)
         o.errors << Shapes::ShapeRef.new(shape: InsufficientPrivilegesException)
         o.errors << Shapes::ShapeRef.new(shape: ElasticBeanstalkServiceException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_records",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
       end)
 
       api.add_operation(:list_tags_for_resource, Seahorse::Model::Operation.new.tap do |o|

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

@@ -0,0 +1,210 @@
+# frozen_string_literal: true
+
+# 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::ElasticBeanstalk
+  # Waiters are utility methods that poll for a particular state to occur
+  # on a client. Waiters can fail after a number of attempts at a polling
+  # interval defined for the service client.
+  #
+  # For a list of operations that can be waited for and the
+  # client methods called for each operation, see the table below or the
+  # {Client#wait_until} field documentation for the {Client}.
+  #
+  # # Invoking a Waiter
+  # To invoke a waiter, call #wait_until on a {Client}. The first parameter
+  # is the waiter name, which is specific to the service client and indicates
+  # which operation is being waited for. The second parameter is a hash of
+  # parameters that are passed to the client method called by the waiter,
+  # which varies according to the waiter name.
+  #
+  # # Wait Failures
+  # To catch errors in a waiter, use WaiterFailed,
+  # as shown in the following example.
+  #
+  #     rescue rescue Aws::Waiters::Errors::WaiterFailed => error
+  #       puts "failed waiting for instance running: #{error.message}
+  #     end
+  #
+  # # Configuring a Waiter
+  # Each waiter has a default polling interval and a maximum number of
+  # attempts it will make before returning control to your program.
+  # To set these values, use the `max_attempts` and `delay` parameters
+  # in your `#wait_until` call.
+  # The following example waits for up to 25 seconds, polling every five seconds.
+  #
+  #     client.wait_until(...) do |w|
+  #       w.max_attempts = 5
+  #       w.delay = 5
+  #     end
+  #
+  # To disable wait failures, set the value of either of these parameters
+  # to `nil`.
+  #
+  # # Extending a Waiter
+  # To modify the behavior of waiters, you can register callbacks that are
+  # triggered before each polling attempt and before waiting.
+  #
+  # The following example implements an exponential backoff in a waiter
+  # by doubling the amount of time to wait on every attempt.
+  #
+  #     client.wait_until(...) do |w|
+  #       w.interval = 0 # disable normal sleep
+  #       w.before_wait do |n, resp|
+  #         sleep(n ** 2)
+  #       end
+  #     end
+  #
+  # # Available 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 |
+  # | ---------------------- | ------------------------------ | -------- | ------------- |
+  # | environment_exists     | {Client#describe_environments} | 20       | 20            |
+  # | environment_terminated | {Client#describe_environments} | 20       | 20            |
+  # | environment_updated    | {Client#describe_environments} | 20       | 20            |
+  #
+  module Waiters
+
+    class EnvironmentExists
+
+      # @param [Hash] options
+      # @option options [required, Client] :client
+      # @option options [Integer] :max_attempts (20)
+      # @option options [Integer] :delay (20)
+      # @option options [Proc] :before_attempt
+      # @option options [Proc] :before_wait
+      def initialize(options)
+        @client = options.fetch(:client)
+        @waiter = Aws::Waiters::Waiter.new({
+          max_attempts: 20,
+          delay: 20,
+          poller: Aws::Waiters::Poller.new(
+            operation_name: :describe_environments,
+            acceptors: [
+              {
+                "state" => "success",
+                "matcher" => "pathAll",
+                "argument" => "environments[].status",
+                "expected" => "Ready"
+              },
+              {
+                "state" => "retry",
+                "matcher" => "pathAll",
+                "argument" => "environments[].status",
+                "expected" => "Launching"
+              }
+            ]
+          )
+        }.merge(options))
+      end
+
+      # @option (see Client#describe_environments)
+      # @return (see Client#describe_environments)
+      def wait(params = {})
+        @waiter.wait(client: @client, params: params)
+      end
+
+      # @api private
+      attr_reader :waiter
+
+    end
+
+    class EnvironmentTerminated
+
+      # @param [Hash] options
+      # @option options [required, Client] :client
+      # @option options [Integer] :max_attempts (20)
+      # @option options [Integer] :delay (20)
+      # @option options [Proc] :before_attempt
+      # @option options [Proc] :before_wait
+      def initialize(options)
+        @client = options.fetch(:client)
+        @waiter = Aws::Waiters::Waiter.new({
+          max_attempts: 20,
+          delay: 20,
+          poller: Aws::Waiters::Poller.new(
+            operation_name: :describe_environments,
+            acceptors: [
+              {
+                "state" => "success",
+                "matcher" => "pathAll",
+                "argument" => "environments[].status",
+                "expected" => "Terminated"
+              },
+              {
+                "state" => "retry",
+                "matcher" => "pathAll",
+                "argument" => "environments[].status",
+                "expected" => "Terminating"
+              }
+            ]
+          )
+        }.merge(options))
+      end
+
+      # @option (see Client#describe_environments)
+      # @return (see Client#describe_environments)
+      def wait(params = {})
+        @waiter.wait(client: @client, params: params)
+      end
+
+      # @api private
+      attr_reader :waiter
+
+    end
+
+    class EnvironmentUpdated
+
+      # @param [Hash] options
+      # @option options [required, Client] :client
+      # @option options [Integer] :max_attempts (20)
+      # @option options [Integer] :delay (20)
+      # @option options [Proc] :before_attempt
+      # @option options [Proc] :before_wait
+      def initialize(options)
+        @client = options.fetch(:client)
+        @waiter = Aws::Waiters::Waiter.new({
+          max_attempts: 20,
+          delay: 20,
+          poller: Aws::Waiters::Poller.new(
+            operation_name: :describe_environments,
+            acceptors: [
+              {
+                "state" => "success",
+                "matcher" => "pathAll",
+                "argument" => "environments[].status",
+                "expected" => "Ready"
+              },
+              {
+                "state" => "retry",
+                "matcher" => "pathAll",
+                "argument" => "environments[].status",
+                "expected" => "Updating"
+              }
+            ]
+          )
+        }.merge(options))
+      end
+
+      # @option (see Client#describe_environments)
+      # @return (see Client#describe_environments)
+      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-elasticbeanstalk
 version: !ruby/object:Gem::Version
-  version: 1.34.0
+  version: 1.39.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-07-02 00:00:00.000000000 Z
+date: 2020-10-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.99.0
+        version: 3.109.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.99.0
+        version: 3.109.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement
@@ -59,6 +59,7 @@ files:
 - lib/aws-sdk-elasticbeanstalk/errors.rb
 - lib/aws-sdk-elasticbeanstalk/resource.rb
 - lib/aws-sdk-elasticbeanstalk/types.rb
+- lib/aws-sdk-elasticbeanstalk/waiters.rb
 homepage: https://github.com/aws/aws-sdk-ruby
 licenses:
 - Apache-2.0