aws-sdk-opsworks 1.55.0 → 1.56.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-opsworks/client.rb +248 -229
- data/lib/aws-sdk-opsworks/client_api.rb +1 -0
- data/lib/aws-sdk-opsworks/endpoint_provider.rb +1 -1
- data/lib/aws-sdk-opsworks/layer.rb +9 -10
- data/lib/aws-sdk-opsworks/resource.rb +65 -60
- data/lib/aws-sdk-opsworks/stack.rb +16 -14
- data/lib/aws-sdk-opsworks/types.rb +346 -319
- data/lib/aws-sdk-opsworks.rb +1 -1
- metadata +2 -2
@@ -1268,6 +1268,7 @@ module Aws::OpsWorks
|
|
1268
1268
|
"endpointPrefix" => "opsworks",
|
1269
1269
|
"jsonVersion" => "1.1",
|
1270
1270
|
"protocol" => "json",
|
1271
|
+
"protocols" => ["json"],
|
1271
1272
|
"serviceFullName" => "AWS OpsWorks",
|
1272
1273
|
"serviceId" => "OpsWorks",
|
1273
1274
|
"signatureVersion" => "v4",
|
@@ -32,7 +32,7 @@ module Aws::OpsWorks
|
|
32
32
|
raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
|
33
33
|
end
|
34
34
|
if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
|
35
|
-
if Aws::Endpoints::Matchers.boolean_equals?(
|
35
|
+
if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true)
|
36
36
|
return Aws::Endpoints::Endpoint.new(url: "https://opsworks-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
|
37
37
|
end
|
38
38
|
raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
|
@@ -58,7 +58,7 @@ module Aws::OpsWorks
|
|
58
58
|
data[:type]
|
59
59
|
end
|
60
60
|
|
61
|
-
# The layer name.
|
61
|
+
# The layer name. Layer names can be a maximum of 32 characters.
|
62
62
|
# @return [String]
|
63
63
|
def name
|
64
64
|
data[:name]
|
@@ -73,10 +73,10 @@ module Aws::OpsWorks
|
|
73
73
|
# The layer attributes.
|
74
74
|
#
|
75
75
|
# For the `HaproxyStatsPassword`, `MysqlRootPassword`, and
|
76
|
-
# `GangliaPassword` attributes,
|
76
|
+
# `GangliaPassword` attributes, OpsWorks Stacks returns
|
77
77
|
# `*****FILTERED*****` instead of the actual value
|
78
78
|
#
|
79
|
-
# For an ECS Cluster layer,
|
79
|
+
# For an ECS Cluster layer, OpsWorks Stacks the `EcsClusterArn`
|
80
80
|
# attribute is set to the cluster's ARN.
|
81
81
|
# @return [Hash<String,String>]
|
82
82
|
def attributes
|
@@ -164,14 +164,13 @@ module Aws::OpsWorks
|
|
164
164
|
data[:auto_assign_public_ips]
|
165
165
|
end
|
166
166
|
|
167
|
-
#
|
167
|
+
# OpsWorks Stacks supports five lifecycle events: **setup**,
|
168
168
|
# **configuration**, **deploy**, **undeploy**, and **shutdown**. For
|
169
|
-
# each layer,
|
170
|
-
#
|
171
|
-
#
|
172
|
-
#
|
173
|
-
#
|
174
|
-
# events.
|
169
|
+
# each layer, OpsWorks Stacks runs a set of standard recipes for each
|
170
|
+
# event. You can also provide custom recipes for any or all layers and
|
171
|
+
# events. OpsWorks Stacks runs custom event recipes after the standard
|
172
|
+
# recipes. `LayerCustomRecipes` specifies the custom recipes for a
|
173
|
+
# particular layer to be run in response to each of the five events.
|
175
174
|
#
|
176
175
|
# To specify a recipe, use the cookbook's directory name in the
|
177
176
|
# repository followed by two colons and the recipe name, which is the
|
@@ -75,28 +75,29 @@ module Aws::OpsWorks
|
|
75
75
|
# })
|
76
76
|
# @param [Hash] options ({})
|
77
77
|
# @option options [required, String] :name
|
78
|
-
# The stack name.
|
78
|
+
# The stack name. Stack names can be a maximum of 64 characters.
|
79
79
|
# @option options [required, String] :region
|
80
|
-
# The stack's
|
81
|
-
# about Amazon
|
82
|
-
#
|
83
|
-
#
|
84
|
-
# the `--stack-region` parameter
|
85
|
-
# `--region`
|
86
|
-
#
|
87
|
-
#
|
88
|
-
#
|
89
|
-
#
|
90
|
-
#
|
91
|
-
# `us-west-1, us-west-2,
|
92
|
-
#
|
93
|
-
# actual API endpoint of the stack is
|
94
|
-
#
|
95
|
-
# endpoint. Because it is a best practice
|
96
|
-
# endpoint that is closest to where you manage
|
97
|
-
#
|
98
|
-
# `--region` parameter always specifies a
|
99
|
-
# cannot be used to specify a classic
|
80
|
+
# The stack's Amazon Web Services Region, such as `ap-south-1`. For
|
81
|
+
# more information about Amazon Web Services Regions, see [Regions and
|
82
|
+
# Endpoints][1].
|
83
|
+
#
|
84
|
+
# <note markdown="1"> In the CLI, this API maps to the `--stack-region` parameter. If the
|
85
|
+
# `--stack-region` parameter and the CLI common parameter `--region` are
|
86
|
+
# set to the same value, the stack uses a *regional* endpoint. If the
|
87
|
+
# `--stack-region` parameter is not set, but the CLI `--region`
|
88
|
+
# parameter is, this also results in a stack with a *regional* endpoint.
|
89
|
+
# However, if the `--region` parameter is set to `us-east-1`, and the
|
90
|
+
# `--stack-region` parameter is set to one of the following, then the
|
91
|
+
# stack uses a legacy or *classic* region: `us-west-1, us-west-2,
|
92
|
+
# sa-east-1, eu-central-1, eu-west-1, ap-northeast-1, ap-southeast-1,
|
93
|
+
# ap-southeast-2`. In this case, the actual API endpoint of the stack is
|
94
|
+
# in `us-east-1`. Only the preceding regions are supported as classic
|
95
|
+
# regions in the `us-east-1` API endpoint. Because it is a best practice
|
96
|
+
# to choose the regional endpoint that is closest to where you manage
|
97
|
+
# Amazon Web Services, we recommend that you use regional endpoints for
|
98
|
+
# new stacks. The CLI common `--region` parameter always specifies a
|
99
|
+
# regional API endpoint; it cannot be used to specify a classic OpsWorks
|
100
|
+
# Stacks region.
|
100
101
|
#
|
101
102
|
# </note>
|
102
103
|
#
|
@@ -115,8 +116,8 @@ module Aws::OpsWorks
|
|
115
116
|
#
|
116
117
|
# If the VPC ID corresponds to a default VPC and you have specified
|
117
118
|
# either the `DefaultAvailabilityZone` or the `DefaultSubnetId`
|
118
|
-
# parameter only,
|
119
|
-
# parameter. If you specify neither parameter,
|
119
|
+
# parameter only, OpsWorks Stacks infers the value of the other
|
120
|
+
# parameter. If you specify neither parameter, OpsWorks Stacks sets
|
120
121
|
# these parameters to the first valid Availability Zone for the
|
121
122
|
# specified region and the corresponding default VPC subnet ID,
|
122
123
|
# respectively.
|
@@ -128,9 +129,9 @@ module Aws::OpsWorks
|
|
128
129
|
#
|
129
130
|
# * You must specify a value for `DefaultSubnetId`.
|
130
131
|
#
|
131
|
-
# For more information about how to use
|
132
|
-
#
|
133
|
-
#
|
132
|
+
# For more information about how to use OpsWorks Stacks with a VPC, see
|
133
|
+
# [Running a Stack in a VPC][1]. For more information about default VPC
|
134
|
+
# and EC2-Classic, see [Supported Platforms][2].
|
134
135
|
#
|
135
136
|
#
|
136
137
|
#
|
@@ -140,11 +141,10 @@ module Aws::OpsWorks
|
|
140
141
|
# One or more user-defined key-value pairs to be added to the stack
|
141
142
|
# attributes.
|
142
143
|
# @option options [required, String] :service_role_arn
|
143
|
-
# The stack's
|
144
|
-
#
|
145
|
-
#
|
146
|
-
#
|
147
|
-
# Identifiers][1].
|
144
|
+
# The stack's IAM role, which allows OpsWorks Stacks to work with
|
145
|
+
# Amazon Web Services resources on your behalf. You must set this
|
146
|
+
# parameter to the Amazon Resource Name (ARN) for an existing IAM role.
|
147
|
+
# For more information about IAM ARNs, see [Using Identifiers][1].
|
148
148
|
#
|
149
149
|
#
|
150
150
|
#
|
@@ -163,12 +163,12 @@ module Aws::OpsWorks
|
|
163
163
|
# create the instance. You can specify one of the following.
|
164
164
|
#
|
165
165
|
# * A supported Linux operating system: An Amazon Linux version, such as
|
166
|
-
# `Amazon Linux 2018.03`, `Amazon Linux 2017.09`,
|
167
|
-
# 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux
|
168
|
-
# Linux 2015.09`, or `Amazon Linux 2015.03`.
|
166
|
+
# `Amazon Linux 2`, `Amazon Linux 2018.03`, `Amazon Linux 2017.09`,
|
167
|
+
# `Amazon Linux 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux
|
168
|
+
# 2016.03`, `Amazon Linux 2015.09`, or `Amazon Linux 2015.03`.
|
169
169
|
#
|
170
|
-
# * A supported Ubuntu operating system, such as `Ubuntu
|
171
|
-
# `Ubuntu 14.04 LTS`, or `Ubuntu 12.04 LTS`.
|
170
|
+
# * A supported Ubuntu operating system, such as `Ubuntu 18.04 LTS`,
|
171
|
+
# `Ubuntu 16.04 LTS`, `Ubuntu 14.04 LTS`, or `Ubuntu 12.04 LTS`.
|
172
172
|
#
|
173
173
|
# * `CentOS Linux 7`
|
174
174
|
#
|
@@ -184,9 +184,10 @@ module Aws::OpsWorks
|
|
184
184
|
# when you create instances. For more information, see [ Using Custom
|
185
185
|
# AMIs][1].
|
186
186
|
#
|
187
|
-
# The default option is the current Amazon Linux version.
|
188
|
-
#
|
189
|
-
#
|
187
|
+
# The default option is the current Amazon Linux version. Not all
|
188
|
+
# operating systems are supported with all versions of Chef. For more
|
189
|
+
# information about supported operating systems, see [OpsWorks Stacks
|
190
|
+
# Operating Systems][2].
|
190
191
|
#
|
191
192
|
#
|
192
193
|
#
|
@@ -271,26 +272,26 @@ module Aws::OpsWorks
|
|
271
272
|
# @option options [Boolean] :use_custom_cookbooks
|
272
273
|
# Whether the stack uses custom cookbooks.
|
273
274
|
# @option options [Boolean] :use_opsworks_security_groups
|
274
|
-
# Whether to associate the
|
275
|
-
#
|
275
|
+
# Whether to associate the OpsWorks Stacks built-in security groups with
|
276
|
+
# the stack's layers.
|
276
277
|
#
|
277
|
-
#
|
278
|
-
#
|
279
|
-
#
|
280
|
-
#
|
281
|
-
#
|
278
|
+
# OpsWorks Stacks provides a standard set of built-in security groups,
|
279
|
+
# one for each layer, which are associated with layers by default. With
|
280
|
+
# `UseOpsworksSecurityGroups` you can instead provide your own custom
|
281
|
+
# security groups. `UseOpsworksSecurityGroups` has the following
|
282
|
+
# settings:
|
282
283
|
#
|
283
|
-
# * True -
|
284
|
+
# * True - OpsWorks Stacks automatically associates the appropriate
|
284
285
|
# built-in security group with each layer (default setting). You can
|
285
286
|
# associate additional security groups with a layer after you create
|
286
287
|
# it, but you cannot delete the built-in security group.
|
287
288
|
#
|
288
|
-
# * False -
|
289
|
-
#
|
290
|
-
#
|
291
|
-
#
|
292
|
-
#
|
293
|
-
#
|
289
|
+
# * False - OpsWorks Stacks does not associate built-in security groups
|
290
|
+
# with layers. You must create appropriate EC2 security groups and
|
291
|
+
# associate a security group with each layer that you create. However,
|
292
|
+
# you can still manually associate a built-in security group with a
|
293
|
+
# layer on creation; custom security groups are required only for
|
294
|
+
# those layers that need custom settings.
|
294
295
|
#
|
295
296
|
# For more information, see [Create a New Stack][1].
|
296
297
|
#
|
@@ -308,7 +309,7 @@ module Aws::OpsWorks
|
|
308
309
|
# [2]: https://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook.html
|
309
310
|
# @option options [String] :default_ssh_key_name
|
310
311
|
# A default Amazon EC2 key pair name. The default value is none. If you
|
311
|
-
# specify a key pair name,
|
312
|
+
# specify a key pair name, OpsWorks installs the public key on the
|
312
313
|
# instance and you can use the private key with an SSH client to log in
|
313
314
|
# to the instance. For more information, see [ Using SSH to Communicate
|
314
315
|
# with an Instance][1] and [ Managing SSH Access][2]. You can override
|
@@ -330,17 +331,17 @@ module Aws::OpsWorks
|
|
330
331
|
#
|
331
332
|
# [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ComponentsAMIs.html#storage-for-the-root-device
|
332
333
|
# @option options [String] :agent_version
|
333
|
-
# The default
|
334
|
+
# The default OpsWorks Stacks agent version. You have the following
|
334
335
|
# options:
|
335
336
|
#
|
336
|
-
# * Auto-update - Set this parameter to `LATEST`.
|
337
|
+
# * Auto-update - Set this parameter to `LATEST`. OpsWorks Stacks
|
337
338
|
# automatically installs new agent versions on the stack's instances
|
338
339
|
# as soon as they are available.
|
339
340
|
#
|
340
341
|
# * Fixed version - Set this parameter to your preferred agent version.
|
341
342
|
# To update the agent version, you must edit the stack configuration
|
342
|
-
# and specify a new version.
|
343
|
-
#
|
343
|
+
# and specify a new version. OpsWorks Stacks installs that version on
|
344
|
+
# the stack's instances.
|
344
345
|
#
|
345
346
|
# The default setting is the most recent release of the agent. To
|
346
347
|
# specify an agent version, you must use the complete version number,
|
@@ -391,8 +392,12 @@ module Aws::OpsWorks
|
|
391
392
|
# @param [Hash] options ({})
|
392
393
|
# @option options [Array<String>] :stack_ids
|
393
394
|
# An array of stack IDs that specify the stacks to be described. If you
|
394
|
-
# omit this parameter,
|
395
|
-
# stack.
|
395
|
+
# omit this parameter, and have permissions to get information about all
|
396
|
+
# stacks, `DescribeStacks` returns a description of every stack. If the
|
397
|
+
# IAM policy that is attached to an IAM user limits the `DescribeStacks`
|
398
|
+
# action to specific stack ARNs, this parameter is required, and the
|
399
|
+
# user must specify a stack ARN that is allowed by the policy.
|
400
|
+
# Otherwise, `DescribeStacks` returns an `AccessDenied` error.
|
396
401
|
# @return [Stack::Collection]
|
397
402
|
def stacks(options = {})
|
398
403
|
batches = Enumerator.new do |y|
|
@@ -40,7 +40,7 @@ module Aws::OpsWorks
|
|
40
40
|
data[:stack_id]
|
41
41
|
end
|
42
42
|
|
43
|
-
# The stack name.
|
43
|
+
# The stack name. Stack names can be a maximum of 64 characters.
|
44
44
|
# @return [String]
|
45
45
|
def name
|
46
46
|
data[:name]
|
@@ -52,8 +52,9 @@ module Aws::OpsWorks
|
|
52
52
|
data[:arn]
|
53
53
|
end
|
54
54
|
|
55
|
-
# The stack
|
56
|
-
# about
|
55
|
+
# The stack Amazon Web Services Region, such as `ap-northeast-2`. For
|
56
|
+
# more information about Amazon Web Services Regions, see [Regions and
|
57
|
+
# Endpoints][1].
|
57
58
|
#
|
58
59
|
#
|
59
60
|
#
|
@@ -75,7 +76,7 @@ module Aws::OpsWorks
|
|
75
76
|
data[:attributes]
|
76
77
|
end
|
77
78
|
|
78
|
-
# The stack
|
79
|
+
# The stack Identity and Access Management (IAM) role.
|
79
80
|
# @return [String]
|
80
81
|
def service_role_arn
|
81
82
|
data[:service_role_arn]
|
@@ -166,7 +167,7 @@ module Aws::OpsWorks
|
|
166
167
|
data[:use_custom_cookbooks]
|
167
168
|
end
|
168
169
|
|
169
|
-
# Whether the stack automatically associates the
|
170
|
+
# Whether the stack automatically associates the OpsWorks Stacks
|
170
171
|
# built-in security groups with the stack's layers.
|
171
172
|
# @return [Boolean]
|
172
173
|
def use_opsworks_security_groups
|
@@ -423,17 +424,18 @@ module Aws::OpsWorks
|
|
423
424
|
# the same type. It can have any number of custom layers. Built-in
|
424
425
|
# layers are not available in Chef 12 stacks.
|
425
426
|
# @option options [required, String] :name
|
426
|
-
# The layer name, which is used by the console.
|
427
|
+
# The layer name, which is used by the console. Layer names can be a
|
428
|
+
# maximum of 32 characters.
|
427
429
|
# @option options [required, String] :shortname
|
428
430
|
# For custom layers only, use this parameter to specify the layer's
|
429
|
-
# short name, which is used internally by
|
430
|
-
#
|
431
|
-
#
|
432
|
-
#
|
433
|
-
# '
|
431
|
+
# short name, which is used internally by OpsWorks Stacks and by Chef
|
432
|
+
# recipes. The short name is also used as the name for the directory
|
433
|
+
# where your app files are installed. It can have a maximum of 32
|
434
|
+
# characters, which are limited to the alphanumeric characters, '-',
|
435
|
+
# '\_', and '.'.
|
434
436
|
#
|
435
|
-
#
|
436
|
-
#
|
437
|
+
# Built-in layer short names are defined by OpsWorks Stacks. For more
|
438
|
+
# information, see the [Layer Reference][1].
|
437
439
|
#
|
438
440
|
#
|
439
441
|
#
|
@@ -458,7 +460,7 @@ module Aws::OpsWorks
|
|
458
460
|
# A JSON-formatted string containing custom stack configuration and
|
459
461
|
# deployment attributes to be installed on the layer's instances. For
|
460
462
|
# more information, see [ Using Custom JSON][1]. This feature is
|
461
|
-
# supported as of version 1.7.42 of the
|
463
|
+
# supported as of version 1.7.42 of the CLI.
|
462
464
|
#
|
463
465
|
#
|
464
466
|
#
|