aws-sdk-opsworkscm 1.30.0 → 1.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: '01384885126a1d13265c862fcdcbc2d018858351'
-  data.tar.gz: 7405c459b68e27caed27b1900192d82584e064c8
+  metadata.gz: 6cbfb0e190f1b8d607f6d1cdceb226c72a78abe0
+  data.tar.gz: 479f99ae221b1553cfb5fc6509843aebc11b5df7
 SHA512:
-  metadata.gz: db8a55b1c386162a7a879d2537be3e09ede6a2bdd88545f8a91348764c7decd4033853c5a586a7eaf7208c761644f9a151d1ceac63a8e35ad37afc4ed92bbe35
-  data.tar.gz: f762d9c82aedb96dd8d6dbe0140eae6e50416406271e5673e927d264452fa48b995b2af7d9a247964052d25e840bffaebc8590801448c1979af415fff5202b6b
+  metadata.gz: 96406c6d3b3259b462d26f0597d52359eb05001903fd23a8fe2e38f9285ef8d9ad10245d86c37ef68bf67d090333686f15af5c5e3d8ef275b488265c0920177c
+  data.tar.gz: 93fe7fa98a008481780feb608b5ed04933fb9aa9b4fa64f7839759a8e4afbf0d82532cb01a8d5457609f52a397bc9e2000408ad1dedda54fc18eb6e971cfc5f9

data/lib/aws-sdk-opsworkscm.rb

@@ -46,6 +46,6 @@ require_relative 'aws-sdk-opsworkscm/customizations'
 # @service
 module Aws::OpsWorksCM
 
-  GEM_VERSION = '1.30.0'
+  GEM_VERSION = '1.31.0'
 
 end

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

@@ -32,11 +32,11 @@ Aws::Plugins::GlobalConfiguration.add_identifier(:opsworkscm)
 module Aws::OpsWorksCM
   # An API client for OpsWorksCM.  To construct a client, you need to configure a `:region` and `:credentials`.
   #
-  #   client = Aws::OpsWorksCM::Client.new(
-  #     region: region_name,
-  #     credentials: credentials,
-  #     # ...
-  #   )
+  #     client = Aws::OpsWorksCM::Client.new(
+  #       region: region_name,
+  #       credentials: credentials,
+  #       # ...
+  #     )
   #
   # For details on configuring region and credentials see
   # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
@@ -229,15 +229,19 @@ module Aws::OpsWorksCM
     #
     #   @option options [String] :retry_mode ("legacy")
     #     Specifies which retry algorithm to use. Values are:
-    #       * `legacy` - The pre-existing retry behavior.  This is default value if
-    #         no retry mode is provided.
-    #       * `standard` - A standardized set of retry rules across the AWS SDKs.
-    #         This includes support for retry quotas, which limit the number of
-    #         unsuccessful retries a client can make.
-    #       * `adaptive` - An experimental retry mode that includes all the
-    #         functionality of `standard` mode along with automatic client side
-    #         throttling.  This is a provisional mode that may change behavior
-    #         in the future.
+    #
+    #     * `legacy` - The pre-existing retry behavior.  This is default value if
+    #       no retry mode is provided.
+    #
+    #     * `standard` - A standardized set of retry rules across the AWS SDKs.
+    #       This includes support for retry quotas, which limit the number of
+    #       unsuccessful retries a client can make.
+    #
+    #     * `adaptive` - An experimental retry mode that includes all the
+    #       functionality of `standard` mode along with automatic client side
+    #       throttling.  This is a provisional mode that may change behavior
+    #       in the future.
+    #
     #
     #   @option options [String] :secret_access_key
     #
@@ -275,8 +279,7 @@ module Aws::OpsWorksCM
     #
     #   @option options [Integer] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
-    #     safely be set
-    #     per-request on the session yielded by {#session_for}.
+    #     safely be set per-request on the session.
     #
     #   @option options [Float] :http_idle_timeout (5) The number of
     #     seconds a connection is allowed to sit idle before it is
@@ -288,7 +291,7 @@ module Aws::OpsWorksCM
     #     request body.  This option has no effect unless the request has
     #     "Expect" header set to "100-continue".  Defaults to `nil` which
     #     disables this behaviour.  This value can safely be set per
-    #     request on the session yielded by {#session_for}.
+    #     request on the session.
     #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
@@ -535,22 +538,21 @@ module Aws::OpsWorksCM
     #   Valid values are `true` or `false`. The default value is `true`.
     #
     # @option params [String] :custom_domain
-    #   Supported on servers running Chef Automate 2. An optional public
-    #   endpoint of a server, such as `https://aws.my-company.com`. To access
-    #   the server, create a CNAME DNS record in your preferred DNS service
-    #   that points the custom domain to the endpoint that is generated when
-    #   the server is created (the value of the CreateServer Endpoint
-    #   attribute). You cannot access the server by using the generated
-    #   `Endpoint` value if the server is using a custom domain. If you
-    #   specify a custom domain, you must also specify values for
-    #   `CustomCertificate` and `CustomPrivateKey`.
+    #   An optional public endpoint of a server, such as
+    #   `https://aws.my-company.com`. To access the server, create a CNAME DNS
+    #   record in your preferred DNS service that points the custom domain to
+    #   the endpoint that is generated when the server is created (the value
+    #   of the CreateServer Endpoint attribute). You cannot access the server
+    #   by using the generated `Endpoint` value if the server is using a
+    #   custom domain. If you specify a custom domain, you must also specify
+    #   values for `CustomCertificate` and `CustomPrivateKey`.
     #
     # @option params [String] :custom_certificate
-    #   Supported on servers running Chef Automate 2. A PEM-formatted HTTPS
-    #   certificate. The value can be be a single, self-signed certificate, or
-    #   a certificate chain. If you specify a custom certificate, you must
-    #   also specify values for `CustomDomain` and `CustomPrivateKey`. The
-    #   following are requirements for the `CustomCertificate` value:
+    #   A PEM-formatted HTTPS certificate. The value can be be a single,
+    #   self-signed certificate, or a certificate chain. If you specify a
+    #   custom certificate, you must also specify values for `CustomDomain`
+    #   and `CustomPrivateKey`. The following are requirements for the
+    #   `CustomCertificate` value:
     #
     #   * You can provide either a self-signed, custom certificate, or the
     #     full certificate chain.
@@ -569,11 +571,10 @@ module Aws::OpsWorksCM
     #   * The certificate must match the value of `CustomPrivateKey`.
     #
     # @option params [String] :custom_private_key
-    #   Supported on servers running Chef Automate 2. A private key in PEM
-    #   format for connecting to the server by using HTTPS. The private key
-    #   must not be encrypted; it cannot be protected by a password or
-    #   passphrase. If you specify a custom private key, you must also specify
-    #   values for `CustomDomain` and `CustomCertificate`.
+    #   A private key in PEM format for connecting to the server by using
+    #   HTTPS. The private key must not be encrypted; it cannot be protected
+    #   by a password or passphrase. If you specify a custom private key, you
+    #   must also specify values for `CustomDomain` and `CustomCertificate`.
     #
     # @option params [Boolean] :disable_automated_backup
     #   Enable or disable scheduled backups. Valid values are `true` or
@@ -589,8 +590,8 @@ module Aws::OpsWorksCM
     #
     # @option params [String] :engine_version
     #   The major release version of the engine that you want to use. For a
-    #   Chef server, the valid value for EngineVersion is currently `12`. For
-    #   a Puppet server, the valid value is `2017`.
+    #   Chef server, the valid value for EngineVersion is currently `2`. For a
+    #   Puppet server, the valid value is `2017`.
     #
     # @option params [Array<Types::EngineAttribute>] :engine_attributes
     #   Optional engine attributes on a specified server.
@@ -656,10 +657,10 @@ module Aws::OpsWorksCM
     # @option params [String] :preferred_maintenance_window
     #   The start time for a one-hour period each week during which AWS
     #   OpsWorks CM performs maintenance on the instance. Valid values must be
-    #   specified in the following format: `DDD:HH:MM`. The specified time is
-    #   in coordinated universal time (UTC). The default value is a random
-    #   one-hour period on Tuesday, Wednesday, or Friday. See
-    #   `TimeWindowDefinition` for more information.
+    #   specified in the following format: `DDD:HH:MM`. `MM` must be specified
+    #   as `00`. The specified time is in coordinated universal time (UTC).
+    #   The default value is a random one-hour period on Tuesday, Wednesday,
+    #   or Friday. See `TimeWindowDefinition` for more information.
     #
     #   **Example:** `Mon:08:00`, which represents a start time of every
     #   Monday at 08:00 UTC. (8:00 a.m.)
@@ -674,8 +675,8 @@ module Aws::OpsWorksCM
     #
     #   * `DDD:HH:MM` for weekly backups
     #
-    #   The specified time is in coordinated universal time (UTC). The default
-    #   value is a random, daily start time.
+    #   `MM` must be specified as `00`. The specified time is in coordinated
+    #   universal time (UTC). The default value is a random, daily start time.
     #
     #   **Example:** `08:00`, which represents a daily start time of 08:00
     #   UTC.
@@ -729,11 +730,11 @@ module Aws::OpsWorksCM
     #
     #   * The key can be a maximum of 127 characters, and can contain only
     #     Unicode letters, numbers, or separators, or the following special
-    #     characters: `+ - = . _ : /`
+    #     characters: `+ - = . _ : / @`
     #
     #   * The value can be a maximum 255 characters, and contain only Unicode
     #     letters, numbers, or separators, or the following special
-    #     characters: `+ - = . _ : /`
+    #     characters: `+ - = . _ : / @`
     #
     #   * Leading and trailing white spaces are trimmed from both the key and
     #     value.
@@ -1082,6 +1083,11 @@ module Aws::OpsWorksCM
     #   resp.engine_attributes[0].name #=> String
     #   resp.engine_attributes[0].value #=> String
     #
+    #
+    # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
+    #
+    #   * node_associated
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/opsworkscm-2016-11-01/DescribeNodeAssociationStatus AWS API Documentation
     #
     # @overload describe_node_association_status(params = {})
@@ -1751,7 +1757,7 @@ module Aws::OpsWorksCM
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-opsworkscm'
-      context[:gem_version] = '1.30.0'
+      context[:gem_version] = '1.31.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 
@@ -1817,9 +1823,9 @@ module Aws::OpsWorksCM
     # 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 |
-    # | --------------- | ----------------------------------- | -------- | ------------- |
-    # | node_associated | {#describe_node_association_status} | 15       | 15            |
+    # | waiter_name     | params                                    | :delay   | :max_attempts |
+    # | --------------- | ----------------------------------------- | -------- | ------------- |
+    # | node_associated | {Client#describe_node_association_status} | 15       | 15            |
     #
     # @raise [Errors::FailureStateError] Raised when the waiter terminates
     #   because the waiter has entered a state that it will not transition

data/lib/aws-sdk-opsworkscm/resource.rb

@@ -6,13 +6,7 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::OpsWorksCM
-  # This class provides a resource oriented interface for OpsWorksCM.
-  # To create a resource object:
-  #     resource = Aws::OpsWorksCM::Resource.new(region: 'us-west-2')
-  # You can supply a client object with custom configuration that will be used for all resource operations.
-  # If you do not pass +:client+, a default client will be constructed.
-  #     client = Aws::OpsWorksCM::Client.new(region: 'us-west-2')
-  #     resource = Aws::OpsWorksCM::Resource.new(client: client)
+
   class Resource
 
     # @param options ({})

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

@@ -355,23 +355,23 @@ module Aws::OpsWorksCM
     #   @return [Boolean]
     #
     # @!attribute [rw] custom_domain
-    #   Supported on servers running Chef Automate 2. An optional public
-    #   endpoint of a server, such as `https://aws.my-company.com`. To
-    #   access the server, create a CNAME DNS record in your preferred DNS
-    #   service that points the custom domain to the endpoint that is
-    #   generated when the server is created (the value of the CreateServer
-    #   Endpoint attribute). You cannot access the server by using the
-    #   generated `Endpoint` value if the server is using a custom domain.
-    #   If you specify a custom domain, you must also specify values for
-    #   `CustomCertificate` and `CustomPrivateKey`.
+    #   An optional public endpoint of a server, such as
+    #   `https://aws.my-company.com`. To access the server, create a CNAME
+    #   DNS record in your preferred DNS service that points the custom
+    #   domain to the endpoint that is generated when the server is created
+    #   (the value of the CreateServer Endpoint attribute). You cannot
+    #   access the server by using the generated `Endpoint` value if the
+    #   server is using a custom domain. If you specify a custom domain, you
+    #   must also specify values for `CustomCertificate` and
+    #   `CustomPrivateKey`.
     #   @return [String]
     #
     # @!attribute [rw] custom_certificate
-    #   Supported on servers running Chef Automate 2. A PEM-formatted HTTPS
-    #   certificate. The value can be be a single, self-signed certificate,
-    #   or a certificate chain. If you specify a custom certificate, you
-    #   must also specify values for `CustomDomain` and `CustomPrivateKey`.
-    #   The following are requirements for the `CustomCertificate` value:
+    #   A PEM-formatted HTTPS certificate. The value can be be a single,
+    #   self-signed certificate, or a certificate chain. If you specify a
+    #   custom certificate, you must also specify values for `CustomDomain`
+    #   and `CustomPrivateKey`. The following are requirements for the
+    #   `CustomCertificate` value:
     #
     #   * You can provide either a self-signed, custom certificate, or the
     #     full certificate chain.
@@ -391,11 +391,11 @@ module Aws::OpsWorksCM
     #   @return [String]
     #
     # @!attribute [rw] custom_private_key
-    #   Supported on servers running Chef Automate 2. A private key in PEM
-    #   format for connecting to the server by using HTTPS. The private key
-    #   must not be encrypted; it cannot be protected by a password or
-    #   passphrase. If you specify a custom private key, you must also
-    #   specify values for `CustomDomain` and `CustomCertificate`.
+    #   A private key in PEM format for connecting to the server by using
+    #   HTTPS. The private key must not be encrypted; it cannot be protected
+    #   by a password or passphrase. If you specify a custom private key,
+    #   you must also specify values for `CustomDomain` and
+    #   `CustomCertificate`.
     #   @return [String]
     #
     # @!attribute [rw] disable_automated_backup
@@ -415,8 +415,8 @@ module Aws::OpsWorksCM
     #
     # @!attribute [rw] engine_version
     #   The major release version of the engine that you want to use. For a
-    #   Chef server, the valid value for EngineVersion is currently `12`.
-    #   For a Puppet server, the valid value is `2017`.
+    #   Chef server, the valid value for EngineVersion is currently `2`. For
+    #   a Puppet server, the valid value is `2017`.
     #   @return [String]
     #
     # @!attribute [rw] engine_attributes
@@ -489,10 +489,11 @@ module Aws::OpsWorksCM
     # @!attribute [rw] preferred_maintenance_window
     #   The start time for a one-hour period each week during which AWS
     #   OpsWorks CM performs maintenance on the instance. Valid values must
-    #   be specified in the following format: `DDD:HH:MM`. The specified
-    #   time is in coordinated universal time (UTC). The default value is a
-    #   random one-hour period on Tuesday, Wednesday, or Friday. See
-    #   `TimeWindowDefinition` for more information.
+    #   be specified in the following format: `DDD:HH:MM`. `MM` must be
+    #   specified as `00`. The specified time is in coordinated universal
+    #   time (UTC). The default value is a random one-hour period on
+    #   Tuesday, Wednesday, or Friday. See `TimeWindowDefinition` for more
+    #   information.
     #
     #   **Example:** `Mon:08:00`, which represents a start time of every
     #   Monday at 08:00 UTC. (8:00 a.m.)
@@ -508,8 +509,9 @@ module Aws::OpsWorksCM
     #
     #   * `DDD:HH:MM` for weekly backups
     #
-    #   The specified time is in coordinated universal time (UTC). The
-    #   default value is a random, daily start time.
+    #   `MM` must be specified as `00`. The specified time is in coordinated
+    #   universal time (UTC). The default value is a random, daily start
+    #   time.
     #
     #   **Example:** `08:00`, which represents a daily start time of 08:00
     #   UTC.
@@ -568,11 +570,11 @@ module Aws::OpsWorksCM
     #
     #   * The key can be a maximum of 127 characters, and can contain only
     #     Unicode letters, numbers, or separators, or the following special
-    #     characters: `+ - = . _ : /`
+    #     characters: `+ - = . _ : / @`
     #
     #   * The value can be a maximum 255 characters, and contain only
     #     Unicode letters, numbers, or separators, or the following special
-    #     characters: `+ - = . _ : /`
+    #     characters: `+ - = . _ : / @`
     #
     #   * Leading and trailing white spaces are trimmed from both the key
     #     and value.
@@ -1335,7 +1337,7 @@ module Aws::OpsWorksCM
     #
     # @!attribute [rw] engine_version
     #   The engine version of the server. For a Chef server, the valid value
-    #   for EngineVersion is currently `12`. For a Puppet server, the valid
+    #   for EngineVersion is currently `2`. For a Puppet server, the valid
     #   value is `2017`.
     #   @return [String]
     #

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

@@ -8,6 +8,67 @@
 require 'aws-sdk-core/waiters'
 
 module Aws::OpsWorksCM
+  # 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 |
+  # | --------------- | ----------------------------------------- | -------- | ------------- |
+  # | node_associated | {Client#describe_node_association_status} | 15       | 15            |
+  #
   module Waiters
 
     # Wait until node is associated or disassociated.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-opsworkscm
 version: !ruby/object:Gem::Version
-  version: 1.30.0
+  version: 1.31.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-09 00:00:00.000000000 Z
+date: 2020-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core