aws-sdk-opsworks 1.20.0 → 1.25.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/lib/aws-sdk-opsworks.rb +7 -4
- data/lib/aws-sdk-opsworks/client.rb +98 -22
- data/lib/aws-sdk-opsworks/errors.rb +24 -2
- data/lib/aws-sdk-opsworks/layer.rb +15 -11
- data/lib/aws-sdk-opsworks/resource.rb +12 -0
- data/lib/aws-sdk-opsworks/stack.rb +15 -11
- data/lib/aws-sdk-opsworks/stack_summary.rb +15 -11
- data/lib/aws-sdk-opsworks/waiters.rb +66 -0
- metadata +5 -5
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
|
-
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
2
|
+
SHA256:
|
3
|
+
metadata.gz: b7dab410d1f51070aed3509ff9e021991b200046ab68644abb6985c2551050d4
|
4
|
+
data.tar.gz: 879b7b31d3d32f5e8663fd6b0694960aaae135564bee3beb96916e6fb9dbb767
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 72187f2a7b3a15436039f39cb54c516fa7c2cdb717af28241ba707ae58c7a41179613d71f649a7856901cdbf0b66fbaaef8b915bb3d6224979d5e3aabc5a3f4e
|
7
|
+
data.tar.gz: bc70b65e5abe7f2493921cb616c1854af951588a4fdb343aad3ba625dcc0c3e1b1737bea40d1a0cd672ffb613cca8ddfa84c60e5c171919746fdd869180e7513
|
data/lib/aws-sdk-opsworks.rb
CHANGED
@@ -28,17 +28,20 @@ require_relative 'aws-sdk-opsworks/customizations'
|
|
28
28
|
# methods each accept a hash of request parameters and return a response
|
29
29
|
# structure.
|
30
30
|
#
|
31
|
+
# ops_works = Aws::OpsWorks::Client.new
|
32
|
+
# resp = ops_works.assign_instance(params)
|
33
|
+
#
|
31
34
|
# See {Client} for more information.
|
32
35
|
#
|
33
36
|
# # Errors
|
34
37
|
#
|
35
|
-
# Errors returned from AWS OpsWorks
|
36
|
-
# extend {Errors::ServiceError}.
|
38
|
+
# Errors returned from AWS OpsWorks are defined in the
|
39
|
+
# {Errors} module and all extend {Errors::ServiceError}.
|
37
40
|
#
|
38
41
|
# begin
|
39
42
|
# # do stuff
|
40
43
|
# rescue Aws::OpsWorks::Errors::ServiceError
|
41
|
-
# # rescues all
|
44
|
+
# # rescues all AWS OpsWorks API errors
|
42
45
|
# end
|
43
46
|
#
|
44
47
|
# See {Errors} for more information.
|
@@ -46,6 +49,6 @@ require_relative 'aws-sdk-opsworks/customizations'
|
|
46
49
|
# @service
|
47
50
|
module Aws::OpsWorks
|
48
51
|
|
49
|
-
GEM_VERSION = '1.
|
52
|
+
GEM_VERSION = '1.25.1'
|
50
53
|
|
51
54
|
end
|
@@ -24,12 +24,25 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
|
|
24
24
|
require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
|
25
25
|
require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
|
26
26
|
require 'aws-sdk-core/plugins/transfer_encoding.rb'
|
27
|
+
require 'aws-sdk-core/plugins/http_checksum.rb'
|
27
28
|
require 'aws-sdk-core/plugins/signature_v4.rb'
|
28
29
|
require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
|
29
30
|
|
30
31
|
Aws::Plugins::GlobalConfiguration.add_identifier(:opsworks)
|
31
32
|
|
32
33
|
module Aws::OpsWorks
|
34
|
+
# An API client for OpsWorks. To construct a client, you need to configure a `:region` and `:credentials`.
|
35
|
+
#
|
36
|
+
# client = Aws::OpsWorks::Client.new(
|
37
|
+
# region: region_name,
|
38
|
+
# credentials: credentials,
|
39
|
+
# # ...
|
40
|
+
# )
|
41
|
+
#
|
42
|
+
# For details on configuring region and credentials see
|
43
|
+
# the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
|
44
|
+
#
|
45
|
+
# See {#initialize} for a full list of supported configuration options.
|
33
46
|
class Client < Seahorse::Client::Base
|
34
47
|
|
35
48
|
include Aws::ClientStubs
|
@@ -57,6 +70,7 @@ module Aws::OpsWorks
|
|
57
70
|
add_plugin(Aws::Plugins::ClientMetricsPlugin)
|
58
71
|
add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
|
59
72
|
add_plugin(Aws::Plugins::TransferEncoding)
|
73
|
+
add_plugin(Aws::Plugins::HttpChecksum)
|
60
74
|
add_plugin(Aws::Plugins::SignatureV4)
|
61
75
|
add_plugin(Aws::Plugins::Protocols::JsonRpc)
|
62
76
|
|
@@ -93,7 +107,7 @@ module Aws::OpsWorks
|
|
93
107
|
# @option options [required, String] :region
|
94
108
|
# The AWS region to connect to. The configured `:region` is
|
95
109
|
# used to determine the service `:endpoint`. When not passed,
|
96
|
-
# a default `:region` is
|
110
|
+
# a default `:region` is searched for in the following locations:
|
97
111
|
#
|
98
112
|
# * `Aws.config[:region]`
|
99
113
|
# * `ENV['AWS_REGION']`
|
@@ -108,6 +122,12 @@ module Aws::OpsWorks
|
|
108
122
|
# When set to `true`, a thread polling for endpoints will be running in
|
109
123
|
# the background every 60 secs (default). Defaults to `false`.
|
110
124
|
#
|
125
|
+
# @option options [Boolean] :adaptive_retry_wait_to_fill (true)
|
126
|
+
# Used only in `adaptive` retry mode. When true, the request will sleep
|
127
|
+
# until there is sufficent client side capacity to retry the request.
|
128
|
+
# When false, the request will raise a `RetryCapacityNotAvailableError` and will
|
129
|
+
# not retry instead of sleeping.
|
130
|
+
#
|
111
131
|
# @option options [Boolean] :client_side_monitoring (false)
|
112
132
|
# When `true`, client-side metrics will be collected for all API requests from
|
113
133
|
# this client.
|
@@ -132,6 +152,10 @@ module Aws::OpsWorks
|
|
132
152
|
# When `true`, an attempt is made to coerce request parameters into
|
133
153
|
# the required types.
|
134
154
|
#
|
155
|
+
# @option options [Boolean] :correct_clock_skew (true)
|
156
|
+
# Used only in `standard` and adaptive retry modes. Specifies whether to apply
|
157
|
+
# a clock skew correction and retry requests with skewed client clocks.
|
158
|
+
#
|
135
159
|
# @option options [Boolean] :disable_host_prefix_injection (false)
|
136
160
|
# Set to true to disable SDK automatically adding host prefix
|
137
161
|
# to default service endpoint when available.
|
@@ -139,7 +163,7 @@ module Aws::OpsWorks
|
|
139
163
|
# @option options [String] :endpoint
|
140
164
|
# The client endpoint is normally constructed from the `:region`
|
141
165
|
# option. You should only configure an `:endpoint` when connecting
|
142
|
-
# to test endpoints. This should be
|
166
|
+
# to test or custom endpoints. This should be a valid HTTP(S) URI.
|
143
167
|
#
|
144
168
|
# @option options [Integer] :endpoint_cache_max_entries (1000)
|
145
169
|
# Used for the maximum size limit of the LRU cache storing endpoints data
|
@@ -154,7 +178,7 @@ module Aws::OpsWorks
|
|
154
178
|
# requests fetching endpoints information. Defaults to 60 sec.
|
155
179
|
#
|
156
180
|
# @option options [Boolean] :endpoint_discovery (false)
|
157
|
-
# When set to `true`, endpoint discovery will be enabled for operations when available.
|
181
|
+
# When set to `true`, endpoint discovery will be enabled for operations when available.
|
158
182
|
#
|
159
183
|
# @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
|
160
184
|
# The log formatter.
|
@@ -166,15 +190,29 @@ module Aws::OpsWorks
|
|
166
190
|
# The Logger instance to send log messages to. If this option
|
167
191
|
# is not set, logging will be disabled.
|
168
192
|
#
|
193
|
+
# @option options [Integer] :max_attempts (3)
|
194
|
+
# An integer representing the maximum number attempts that will be made for
|
195
|
+
# a single request, including the initial attempt. For example,
|
196
|
+
# setting this value to 5 will result in a request being retried up to
|
197
|
+
# 4 times. Used in `standard` and `adaptive` retry modes.
|
198
|
+
#
|
169
199
|
# @option options [String] :profile ("default")
|
170
200
|
# Used when loading credentials from the shared credentials file
|
171
201
|
# at HOME/.aws/credentials. When not specified, 'default' is used.
|
172
202
|
#
|
203
|
+
# @option options [Proc] :retry_backoff
|
204
|
+
# A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
|
205
|
+
# This option is only used in the `legacy` retry mode.
|
206
|
+
#
|
173
207
|
# @option options [Float] :retry_base_delay (0.3)
|
174
|
-
# The base delay in seconds used by the default backoff function.
|
208
|
+
# The base delay in seconds used by the default backoff function. This option
|
209
|
+
# is only used in the `legacy` retry mode.
|
175
210
|
#
|
176
211
|
# @option options [Symbol] :retry_jitter (:none)
|
177
|
-
# A delay randomiser function used by the default backoff function.
|
212
|
+
# A delay randomiser function used by the default backoff function.
|
213
|
+
# Some predefined functions can be referenced by name - :none, :equal, :full,
|
214
|
+
# otherwise a Proc that takes and returns a number. This option is only used
|
215
|
+
# in the `legacy` retry mode.
|
178
216
|
#
|
179
217
|
# @see https://www.awsarchitectureblog.com/2015/03/backoff.html
|
180
218
|
#
|
@@ -182,11 +220,30 @@ module Aws::OpsWorks
|
|
182
220
|
# The maximum number of times to retry failed requests. Only
|
183
221
|
# ~ 500 level server errors and certain ~ 400 level client errors
|
184
222
|
# are retried. Generally, these are throttling errors, data
|
185
|
-
# checksum errors, networking errors, timeout errors
|
186
|
-
# errors from expired credentials.
|
223
|
+
# checksum errors, networking errors, timeout errors, auth errors,
|
224
|
+
# endpoint discovery, and errors from expired credentials.
|
225
|
+
# This option is only used in the `legacy` retry mode.
|
187
226
|
#
|
188
227
|
# @option options [Integer] :retry_max_delay (0)
|
189
|
-
# The maximum number of seconds to delay between retries (0 for no limit)
|
228
|
+
# The maximum number of seconds to delay between retries (0 for no limit)
|
229
|
+
# used by the default backoff function. This option is only used in the
|
230
|
+
# `legacy` retry mode.
|
231
|
+
#
|
232
|
+
# @option options [String] :retry_mode ("legacy")
|
233
|
+
# Specifies which retry algorithm to use. Values are:
|
234
|
+
#
|
235
|
+
# * `legacy` - The pre-existing retry behavior. This is default value if
|
236
|
+
# no retry mode is provided.
|
237
|
+
#
|
238
|
+
# * `standard` - A standardized set of retry rules across the AWS SDKs.
|
239
|
+
# This includes support for retry quotas, which limit the number of
|
240
|
+
# unsuccessful retries a client can make.
|
241
|
+
#
|
242
|
+
# * `adaptive` - An experimental retry mode that includes all the
|
243
|
+
# functionality of `standard` mode along with automatic client side
|
244
|
+
# throttling. This is a provisional mode that may change behavior
|
245
|
+
# in the future.
|
246
|
+
#
|
190
247
|
#
|
191
248
|
# @option options [String] :secret_access_key
|
192
249
|
#
|
@@ -219,16 +276,15 @@ module Aws::OpsWorks
|
|
219
276
|
# requests through. Formatted like 'http://proxy.com:123'.
|
220
277
|
#
|
221
278
|
# @option options [Float] :http_open_timeout (15) The number of
|
222
|
-
# seconds to wait when opening a HTTP session before
|
279
|
+
# seconds to wait when opening a HTTP session before raising a
|
223
280
|
# `Timeout::Error`.
|
224
281
|
#
|
225
282
|
# @option options [Integer] :http_read_timeout (60) The default
|
226
283
|
# number of seconds to wait for response data. This value can
|
227
|
-
# safely be set
|
228
|
-
# per-request on the session yeidled by {#session_for}.
|
284
|
+
# safely be set per-request on the session.
|
229
285
|
#
|
230
286
|
# @option options [Float] :http_idle_timeout (5) The number of
|
231
|
-
# seconds a connection is allowed to sit
|
287
|
+
# seconds a connection is allowed to sit idle before it is
|
232
288
|
# considered stale. Stale connections are closed and removed
|
233
289
|
# from the pool before making a request.
|
234
290
|
#
|
@@ -237,7 +293,7 @@ module Aws::OpsWorks
|
|
237
293
|
# request body. This option has no effect unless the request has
|
238
294
|
# "Expect" header set to "100-continue". Defaults to `nil` which
|
239
295
|
# disables this behaviour. This value can safely be set per
|
240
|
-
# request on the session
|
296
|
+
# request on the session.
|
241
297
|
#
|
242
298
|
# @option options [Boolean] :http_wire_trace (false) When `true`,
|
243
299
|
# HTTP debug output will be sent to the `:logger`.
|
@@ -2356,6 +2412,11 @@ module Aws::OpsWorks
|
|
2356
2412
|
# resp.apps[0].environment[0].value #=> String
|
2357
2413
|
# resp.apps[0].environment[0].secure #=> Boolean
|
2358
2414
|
#
|
2415
|
+
#
|
2416
|
+
# The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
|
2417
|
+
#
|
2418
|
+
# * app_exists
|
2419
|
+
#
|
2359
2420
|
# @see http://docs.aws.amazon.com/goto/WebAPI/opsworks-2013-02-18/DescribeApps AWS API Documentation
|
2360
2421
|
#
|
2361
2422
|
# @overload describe_apps(params = {})
|
@@ -2492,6 +2553,11 @@ module Aws::OpsWorks
|
|
2492
2553
|
# resp.deployments[0].instance_ids #=> Array
|
2493
2554
|
# resp.deployments[0].instance_ids[0] #=> String
|
2494
2555
|
#
|
2556
|
+
#
|
2557
|
+
# The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
|
2558
|
+
#
|
2559
|
+
# * deployment_successful
|
2560
|
+
#
|
2495
2561
|
# @see http://docs.aws.amazon.com/goto/WebAPI/opsworks-2013-02-18/DescribeDeployments AWS API Documentation
|
2496
2562
|
#
|
2497
2563
|
# @overload describe_deployments(params = {})
|
@@ -2545,6 +2611,8 @@ module Aws::OpsWorks
|
|
2545
2611
|
# * {Types::DescribeEcsClustersResult#ecs_clusters #ecs_clusters} => Array<Types::EcsCluster>
|
2546
2612
|
# * {Types::DescribeEcsClustersResult#next_token #next_token} => String
|
2547
2613
|
#
|
2614
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
2615
|
+
#
|
2548
2616
|
# @example Request syntax with placeholder values
|
2549
2617
|
#
|
2550
2618
|
# resp = client.describe_ecs_clusters({
|
@@ -2793,6 +2861,14 @@ module Aws::OpsWorks
|
|
2793
2861
|
# resp.instances[0].tenancy #=> String
|
2794
2862
|
# resp.instances[0].virtualization_type #=> String, one of "paravirtual", "hvm"
|
2795
2863
|
#
|
2864
|
+
#
|
2865
|
+
# The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
|
2866
|
+
#
|
2867
|
+
# * instance_online
|
2868
|
+
# * instance_registered
|
2869
|
+
# * instance_stopped
|
2870
|
+
# * instance_terminated
|
2871
|
+
#
|
2796
2872
|
# @see http://docs.aws.amazon.com/goto/WebAPI/opsworks-2013-02-18/DescribeInstances AWS API Documentation
|
2797
2873
|
#
|
2798
2874
|
# @overload describe_instances(params = {})
|
@@ -5556,7 +5632,7 @@ module Aws::OpsWorks
|
|
5556
5632
|
params: params,
|
5557
5633
|
config: config)
|
5558
5634
|
context[:gem_name] = 'aws-sdk-opsworks'
|
5559
|
-
context[:gem_version] = '1.
|
5635
|
+
context[:gem_version] = '1.25.1'
|
5560
5636
|
Seahorse::Client::Request.new(handlers, context)
|
5561
5637
|
end
|
5562
5638
|
|
@@ -5622,14 +5698,14 @@ module Aws::OpsWorks
|
|
5622
5698
|
# The following table lists the valid waiter names, the operations they call,
|
5623
5699
|
# and the default `:delay` and `:max_attempts` values.
|
5624
5700
|
#
|
5625
|
-
# | waiter_name | params
|
5626
|
-
# | --------------------- |
|
5627
|
-
# | app_exists | {#describe_apps} | 1 | 40 |
|
5628
|
-
# | deployment_successful | {#describe_deployments} | 15 | 40 |
|
5629
|
-
# | instance_online | {#describe_instances} | 15 | 40 |
|
5630
|
-
# | instance_registered | {#describe_instances} | 15 | 40 |
|
5631
|
-
# | instance_stopped | {#describe_instances} | 15 | 40 |
|
5632
|
-
# | instance_terminated | {#describe_instances} | 15 | 40 |
|
5701
|
+
# | waiter_name | params | :delay | :max_attempts |
|
5702
|
+
# | --------------------- | ----------------------------- | -------- | ------------- |
|
5703
|
+
# | app_exists | {Client#describe_apps} | 1 | 40 |
|
5704
|
+
# | deployment_successful | {Client#describe_deployments} | 15 | 40 |
|
5705
|
+
# | instance_online | {Client#describe_instances} | 15 | 40 |
|
5706
|
+
# | instance_registered | {Client#describe_instances} | 15 | 40 |
|
5707
|
+
# | instance_stopped | {Client#describe_instances} | 15 | 40 |
|
5708
|
+
# | instance_terminated | {Client#describe_instances} | 15 | 40 |
|
5633
5709
|
#
|
5634
5710
|
# @raise [Errors::FailureStateError] Raised when the waiter terminates
|
5635
5711
|
# because the waiter has entered a state that it will not transition
|
@@ -6,6 +6,30 @@
|
|
6
6
|
# WARNING ABOUT GENERATED CODE
|
7
7
|
|
8
8
|
module Aws::OpsWorks
|
9
|
+
|
10
|
+
# When OpsWorks returns an error response, the Ruby SDK constructs and raises an error.
|
11
|
+
# These errors all extend Aws::OpsWorks::Errors::ServiceError < {Aws::Errors::ServiceError}
|
12
|
+
#
|
13
|
+
# You can rescue all OpsWorks errors using ServiceError:
|
14
|
+
#
|
15
|
+
# begin
|
16
|
+
# # do stuff
|
17
|
+
# rescue Aws::OpsWorks::Errors::ServiceError
|
18
|
+
# # rescues all OpsWorks API errors
|
19
|
+
# end
|
20
|
+
#
|
21
|
+
#
|
22
|
+
# ## Request Context
|
23
|
+
# ServiceError objects have a {Aws::Errors::ServiceError#context #context} method that returns
|
24
|
+
# information about the request that generated the error.
|
25
|
+
# See {Seahorse::Client::RequestContext} for more information.
|
26
|
+
#
|
27
|
+
# ## Error Classes
|
28
|
+
# * {ResourceNotFoundException}
|
29
|
+
# * {ValidationException}
|
30
|
+
#
|
31
|
+
# Additionally, error classes are dynamically generated for service errors based on the error code
|
32
|
+
# if they are not defined above.
|
9
33
|
module Errors
|
10
34
|
|
11
35
|
extend Aws::Errors::DynamicErrors
|
@@ -23,7 +47,6 @@ module Aws::OpsWorks
|
|
23
47
|
def message
|
24
48
|
@message || @data[:message]
|
25
49
|
end
|
26
|
-
|
27
50
|
end
|
28
51
|
|
29
52
|
class ValidationException < ServiceError
|
@@ -39,7 +62,6 @@ module Aws::OpsWorks
|
|
39
62
|
def message
|
40
63
|
@message || @data[:message]
|
41
64
|
end
|
42
|
-
|
43
65
|
end
|
44
66
|
|
45
67
|
end
|
@@ -6,6 +6,7 @@
|
|
6
6
|
# WARNING ABOUT GENERATED CODE
|
7
7
|
|
8
8
|
module Aws::OpsWorks
|
9
|
+
|
9
10
|
class Layer
|
10
11
|
|
11
12
|
extend Aws::Deprecations
|
@@ -21,6 +22,7 @@ module Aws::OpsWorks
|
|
21
22
|
@id = extract_id(args, options)
|
22
23
|
@data = options.delete(:data)
|
23
24
|
@client = options.delete(:client) || Client.new(options)
|
25
|
+
@waiter_block_warned = false
|
24
26
|
end
|
25
27
|
|
26
28
|
# @!group Read-Only Attributes
|
@@ -261,7 +263,8 @@ module Aws::OpsWorks
|
|
261
263
|
# Waiter polls an API operation until a resource enters a desired
|
262
264
|
# state.
|
263
265
|
#
|
264
|
-
# @note The waiting operation is performed on a copy. The original resource
|
266
|
+
# @note The waiting operation is performed on a copy. The original resource
|
267
|
+
# remains unchanged.
|
265
268
|
#
|
266
269
|
# ## Basic Usage
|
267
270
|
#
|
@@ -274,13 +277,15 @@ module Aws::OpsWorks
|
|
274
277
|
#
|
275
278
|
# ## Example
|
276
279
|
#
|
277
|
-
# instance.wait_until(max_attempts:10, delay:5)
|
280
|
+
# instance.wait_until(max_attempts:10, delay:5) do |instance|
|
281
|
+
# instance.state.name == 'running'
|
282
|
+
# end
|
278
283
|
#
|
279
284
|
# ## Configuration
|
280
285
|
#
|
281
286
|
# You can configure the maximum number of polling attempts, and the
|
282
|
-
# delay (in seconds) between each polling attempt. The waiting condition is
|
283
|
-
# by passing a block to {#wait_until}:
|
287
|
+
# delay (in seconds) between each polling attempt. The waiting condition is
|
288
|
+
# set by passing a block to {#wait_until}:
|
284
289
|
#
|
285
290
|
# # poll for ~25 seconds
|
286
291
|
# resource.wait_until(max_attempts:5,delay:5) {|resource|...}
|
@@ -311,17 +316,16 @@ module Aws::OpsWorks
|
|
311
316
|
# # resource did not enter the desired state in time
|
312
317
|
# end
|
313
318
|
#
|
319
|
+
# @yieldparam [Resource] resource to be used in the waiting condition.
|
314
320
|
#
|
315
|
-
# @
|
316
|
-
#
|
317
|
-
#
|
318
|
-
# because the waiter has entered a state that it will not transition
|
319
|
-
# out of, preventing success.
|
321
|
+
# @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter
|
322
|
+
# terminates because the waiter has entered a state that it will not
|
323
|
+
# transition out of, preventing success.
|
320
324
|
#
|
321
325
|
# yet successful.
|
322
326
|
#
|
323
|
-
# @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is
|
324
|
-
# while polling for a resource that is not expected.
|
327
|
+
# @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is
|
328
|
+
# encountered while polling for a resource that is not expected.
|
325
329
|
#
|
326
330
|
# @raise [NotImplementedError] Raised when the resource does not
|
327
331
|
#
|
@@ -6,6 +6,18 @@
|
|
6
6
|
# WARNING ABOUT GENERATED CODE
|
7
7
|
|
8
8
|
module Aws::OpsWorks
|
9
|
+
|
10
|
+
# This class provides a resource oriented interface for OpsWorks.
|
11
|
+
# To create a resource object:
|
12
|
+
#
|
13
|
+
# resource = Aws::OpsWorks::Resource.new(region: 'us-west-2')
|
14
|
+
#
|
15
|
+
# You can supply a client object with custom configuration that will be used for all resource operations.
|
16
|
+
# If you do not pass `:client`, a default client will be constructed.
|
17
|
+
#
|
18
|
+
# client = Aws::OpsWorks::Client.new(region: 'us-west-2')
|
19
|
+
# resource = Aws::OpsWorks::Resource.new(client: client)
|
20
|
+
#
|
9
21
|
class Resource
|
10
22
|
|
11
23
|
# @param options ({})
|
@@ -6,6 +6,7 @@
|
|
6
6
|
# WARNING ABOUT GENERATED CODE
|
7
7
|
|
8
8
|
module Aws::OpsWorks
|
9
|
+
|
9
10
|
class Stack
|
10
11
|
|
11
12
|
extend Aws::Deprecations
|
@@ -21,6 +22,7 @@ module Aws::OpsWorks
|
|
21
22
|
@id = extract_id(args, options)
|
22
23
|
@data = options.delete(:data)
|
23
24
|
@client = options.delete(:client) || Client.new(options)
|
25
|
+
@waiter_block_warned = false
|
24
26
|
end
|
25
27
|
|
26
28
|
# @!group Read-Only Attributes
|
@@ -254,7 +256,8 @@ module Aws::OpsWorks
|
|
254
256
|
# Waiter polls an API operation until a resource enters a desired
|
255
257
|
# state.
|
256
258
|
#
|
257
|
-
# @note The waiting operation is performed on a copy. The original resource
|
259
|
+
# @note The waiting operation is performed on a copy. The original resource
|
260
|
+
# remains unchanged.
|
258
261
|
#
|
259
262
|
# ## Basic Usage
|
260
263
|
#
|
@@ -267,13 +270,15 @@ module Aws::OpsWorks
|
|
267
270
|
#
|
268
271
|
# ## Example
|
269
272
|
#
|
270
|
-
# instance.wait_until(max_attempts:10, delay:5)
|
273
|
+
# instance.wait_until(max_attempts:10, delay:5) do |instance|
|
274
|
+
# instance.state.name == 'running'
|
275
|
+
# end
|
271
276
|
#
|
272
277
|
# ## Configuration
|
273
278
|
#
|
274
279
|
# You can configure the maximum number of polling attempts, and the
|
275
|
-
# delay (in seconds) between each polling attempt. The waiting condition is
|
276
|
-
# by passing a block to {#wait_until}:
|
280
|
+
# delay (in seconds) between each polling attempt. The waiting condition is
|
281
|
+
# set by passing a block to {#wait_until}:
|
277
282
|
#
|
278
283
|
# # poll for ~25 seconds
|
279
284
|
# resource.wait_until(max_attempts:5,delay:5) {|resource|...}
|
@@ -304,17 +309,16 @@ module Aws::OpsWorks
|
|
304
309
|
# # resource did not enter the desired state in time
|
305
310
|
# end
|
306
311
|
#
|
312
|
+
# @yieldparam [Resource] resource to be used in the waiting condition.
|
307
313
|
#
|
308
|
-
# @
|
309
|
-
#
|
310
|
-
#
|
311
|
-
# because the waiter has entered a state that it will not transition
|
312
|
-
# out of, preventing success.
|
314
|
+
# @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter
|
315
|
+
# terminates because the waiter has entered a state that it will not
|
316
|
+
# transition out of, preventing success.
|
313
317
|
#
|
314
318
|
# yet successful.
|
315
319
|
#
|
316
|
-
# @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is
|
317
|
-
# while polling for a resource that is not expected.
|
320
|
+
# @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is
|
321
|
+
# encountered while polling for a resource that is not expected.
|
318
322
|
#
|
319
323
|
# @raise [NotImplementedError] Raised when the resource does not
|
320
324
|
#
|
@@ -6,6 +6,7 @@
|
|
6
6
|
# WARNING ABOUT GENERATED CODE
|
7
7
|
|
8
8
|
module Aws::OpsWorks
|
9
|
+
|
9
10
|
class StackSummary
|
10
11
|
|
11
12
|
extend Aws::Deprecations
|
@@ -21,6 +22,7 @@ module Aws::OpsWorks
|
|
21
22
|
@stack_id = extract_stack_id(args, options)
|
22
23
|
@data = options.delete(:data)
|
23
24
|
@client = options.delete(:client) || Client.new(options)
|
25
|
+
@waiter_block_warned = false
|
24
26
|
end
|
25
27
|
|
26
28
|
# @!group Read-Only Attributes
|
@@ -101,7 +103,8 @@ module Aws::OpsWorks
|
|
101
103
|
# Waiter polls an API operation until a resource enters a desired
|
102
104
|
# state.
|
103
105
|
#
|
104
|
-
# @note The waiting operation is performed on a copy. The original resource
|
106
|
+
# @note The waiting operation is performed on a copy. The original resource
|
107
|
+
# remains unchanged.
|
105
108
|
#
|
106
109
|
# ## Basic Usage
|
107
110
|
#
|
@@ -114,13 +117,15 @@ module Aws::OpsWorks
|
|
114
117
|
#
|
115
118
|
# ## Example
|
116
119
|
#
|
117
|
-
# instance.wait_until(max_attempts:10, delay:5)
|
120
|
+
# instance.wait_until(max_attempts:10, delay:5) do |instance|
|
121
|
+
# instance.state.name == 'running'
|
122
|
+
# end
|
118
123
|
#
|
119
124
|
# ## Configuration
|
120
125
|
#
|
121
126
|
# You can configure the maximum number of polling attempts, and the
|
122
|
-
# delay (in seconds) between each polling attempt. The waiting condition is
|
123
|
-
# by passing a block to {#wait_until}:
|
127
|
+
# delay (in seconds) between each polling attempt. The waiting condition is
|
128
|
+
# set by passing a block to {#wait_until}:
|
124
129
|
#
|
125
130
|
# # poll for ~25 seconds
|
126
131
|
# resource.wait_until(max_attempts:5,delay:5) {|resource|...}
|
@@ -151,17 +156,16 @@ module Aws::OpsWorks
|
|
151
156
|
# # resource did not enter the desired state in time
|
152
157
|
# end
|
153
158
|
#
|
159
|
+
# @yieldparam [Resource] resource to be used in the waiting condition.
|
154
160
|
#
|
155
|
-
# @
|
156
|
-
#
|
157
|
-
#
|
158
|
-
# because the waiter has entered a state that it will not transition
|
159
|
-
# out of, preventing success.
|
161
|
+
# @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter
|
162
|
+
# terminates because the waiter has entered a state that it will not
|
163
|
+
# transition out of, preventing success.
|
160
164
|
#
|
161
165
|
# yet successful.
|
162
166
|
#
|
163
|
-
# @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is
|
164
|
-
# while polling for a resource that is not expected.
|
167
|
+
# @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is
|
168
|
+
# encountered while polling for a resource that is not expected.
|
165
169
|
#
|
166
170
|
# @raise [NotImplementedError] Raised when the resource does not
|
167
171
|
#
|
@@ -8,6 +8,72 @@
|
|
8
8
|
require 'aws-sdk-core/waiters'
|
9
9
|
|
10
10
|
module Aws::OpsWorks
|
11
|
+
# Waiters are utility methods that poll for a particular state to occur
|
12
|
+
# on a client. Waiters can fail after a number of attempts at a polling
|
13
|
+
# interval defined for the service client.
|
14
|
+
#
|
15
|
+
# For a list of operations that can be waited for and the
|
16
|
+
# client methods called for each operation, see the table below or the
|
17
|
+
# {Client#wait_until} field documentation for the {Client}.
|
18
|
+
#
|
19
|
+
# # Invoking a Waiter
|
20
|
+
# To invoke a waiter, call #wait_until on a {Client}. The first parameter
|
21
|
+
# is the waiter name, which is specific to the service client and indicates
|
22
|
+
# which operation is being waited for. The second parameter is a hash of
|
23
|
+
# parameters that are passed to the client method called by the waiter,
|
24
|
+
# which varies according to the waiter name.
|
25
|
+
#
|
26
|
+
# # Wait Failures
|
27
|
+
# To catch errors in a waiter, use WaiterFailed,
|
28
|
+
# as shown in the following example.
|
29
|
+
#
|
30
|
+
# rescue rescue Aws::Waiters::Errors::WaiterFailed => error
|
31
|
+
# puts "failed waiting for instance running: #{error.message}
|
32
|
+
# end
|
33
|
+
#
|
34
|
+
# # Configuring a Waiter
|
35
|
+
# Each waiter has a default polling interval and a maximum number of
|
36
|
+
# attempts it will make before returning control to your program.
|
37
|
+
# To set these values, use the `max_attempts` and `delay` parameters
|
38
|
+
# in your `#wait_until` call.
|
39
|
+
# The following example waits for up to 25 seconds, polling every five seconds.
|
40
|
+
#
|
41
|
+
# client.wait_until(...) do |w|
|
42
|
+
# w.max_attempts = 5
|
43
|
+
# w.delay = 5
|
44
|
+
# end
|
45
|
+
#
|
46
|
+
# To disable wait failures, set the value of either of these parameters
|
47
|
+
# to `nil`.
|
48
|
+
#
|
49
|
+
# # Extending a Waiter
|
50
|
+
# To modify the behavior of waiters, you can register callbacks that are
|
51
|
+
# triggered before each polling attempt and before waiting.
|
52
|
+
#
|
53
|
+
# The following example implements an exponential backoff in a waiter
|
54
|
+
# by doubling the amount of time to wait on every attempt.
|
55
|
+
#
|
56
|
+
# client.wait_until(...) do |w|
|
57
|
+
# w.interval = 0 # disable normal sleep
|
58
|
+
# w.before_wait do |n, resp|
|
59
|
+
# sleep(n ** 2)
|
60
|
+
# end
|
61
|
+
# end
|
62
|
+
#
|
63
|
+
# # Available Waiters
|
64
|
+
#
|
65
|
+
# The following table lists the valid waiter names, the operations they call,
|
66
|
+
# and the default `:delay` and `:max_attempts` values.
|
67
|
+
#
|
68
|
+
# | waiter_name | params | :delay | :max_attempts |
|
69
|
+
# | --------------------- | ----------------------------- | -------- | ------------- |
|
70
|
+
# | app_exists | {Client#describe_apps} | 1 | 40 |
|
71
|
+
# | deployment_successful | {Client#describe_deployments} | 15 | 40 |
|
72
|
+
# | instance_online | {Client#describe_instances} | 15 | 40 |
|
73
|
+
# | instance_registered | {Client#describe_instances} | 15 | 40 |
|
74
|
+
# | instance_stopped | {Client#describe_instances} | 15 | 40 |
|
75
|
+
# | instance_terminated | {Client#describe_instances} | 15 | 40 |
|
76
|
+
#
|
11
77
|
module Waiters
|
12
78
|
|
13
79
|
class AppExists
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: aws-sdk-opsworks
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.
|
4
|
+
version: 1.25.1
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Amazon Web Services
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2020-06-11 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: aws-sdk-core
|
@@ -19,7 +19,7 @@ dependencies:
|
|
19
19
|
version: '3'
|
20
20
|
- - ">="
|
21
21
|
- !ruby/object:Gem::Version
|
22
|
-
version: 3.
|
22
|
+
version: 3.99.0
|
23
23
|
type: :runtime
|
24
24
|
prerelease: false
|
25
25
|
version_requirements: !ruby/object:Gem::Requirement
|
@@ -29,7 +29,7 @@ dependencies:
|
|
29
29
|
version: '3'
|
30
30
|
- - ">="
|
31
31
|
- !ruby/object:Gem::Version
|
32
|
-
version: 3.
|
32
|
+
version: 3.99.0
|
33
33
|
- !ruby/object:Gem::Dependency
|
34
34
|
name: aws-sigv4
|
35
35
|
requirement: !ruby/object:Gem::Requirement
|
@@ -85,7 +85,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
85
85
|
version: '0'
|
86
86
|
requirements: []
|
87
87
|
rubyforge_project:
|
88
|
-
rubygems_version: 2.
|
88
|
+
rubygems_version: 2.7.6.2
|
89
89
|
signing_key:
|
90
90
|
specification_version: 4
|
91
91
|
summary: AWS SDK for Ruby - AWS OpsWorks
|