aws-sdk-opsworks 1.55.0 → 1.56.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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
|
#
|