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.
@@ -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?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
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, AWS OpsWorks Stacks returns
76
+ # `GangliaPassword` attributes, OpsWorks Stacks returns
77
77
  # `*****FILTERED*****` instead of the actual value
78
78
  #
79
- # For an ECS Cluster layer, AWS OpsWorks Stacks the `EcsClusterArn`
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
- # AWS OpsWorks Stacks supports five lifecycle events: **setup**,
167
+ # OpsWorks Stacks supports five lifecycle events: **setup**,
168
168
  # **configuration**, **deploy**, **undeploy**, and **shutdown**. For
169
- # each layer, AWS OpsWorks Stacks runs a set of standard recipes for
170
- # each event. You can also provide custom recipes for any or all layers
171
- # and events. AWS OpsWorks Stacks runs custom event recipes after the
172
- # standard recipes. `LayerCustomRecipes` specifies the custom recipes
173
- # for a particular layer to be run in response to each of the five
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 AWS region, such as `ap-south-1`. For more information
81
- # about Amazon regions, see [Regions and Endpoints][1].
82
- #
83
- # <note markdown="1"> In the AWS CLI, this API maps to the `--stack-region` parameter. If
84
- # the `--stack-region` parameter and the AWS CLI common parameter
85
- # `--region` are set to the same value, the stack uses a *regional*
86
- # endpoint. If the `--stack-region` parameter is not set, but the AWS
87
- # CLI `--region` parameter is, this also results in a stack with a
88
- # *regional* endpoint. However, if the `--region` parameter is set to
89
- # `us-east-1`, and the `--stack-region` parameter is set to one of the
90
- # following, then the stack uses a legacy or *classic* region:
91
- # `us-west-1, us-west-2, sa-east-1, eu-central-1, eu-west-1,
92
- # ap-northeast-1, ap-southeast-1, ap-southeast-2`. In this case, the
93
- # actual API endpoint of the stack is in `us-east-1`. Only the preceding
94
- # regions are supported as classic regions in the `us-east-1` API
95
- # endpoint. Because it is a best practice to choose the regional
96
- # endpoint that is closest to where you manage AWS, we recommend that
97
- # you use regional endpoints for new stacks. The AWS CLI common
98
- # `--region` parameter always specifies a regional API endpoint; it
99
- # cannot be used to specify a classic AWS OpsWorks Stacks region.
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, AWS OpsWorks Stacks infers the value of the other
119
- # parameter. If you specify neither parameter, AWS OpsWorks Stacks sets
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 AWS OpsWorks Stacks with a VPC,
132
- # see [Running a Stack in a VPC][1]. For more information about default
133
- # VPC and EC2-Classic, see [Supported Platforms][2].
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 AWS Identity and Access Management (IAM) role, which
144
- # allows AWS OpsWorks Stacks to work with AWS resources on your behalf.
145
- # You must set this parameter to the Amazon Resource Name (ARN) for an
146
- # existing IAM role. For more information about IAM ARNs, see [Using
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`, `Amazon Linux
167
- # 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux 2016.03`, `Amazon
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 16.04 LTS`,
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. For more
188
- # information about supported operating systems, see [AWS OpsWorks
189
- # Stacks Operating Systems][2].
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 AWS OpsWorks Stacks built-in security groups
275
- # with the stack's layers.
275
+ # Whether to associate the OpsWorks Stacks built-in security groups with
276
+ # the stack's layers.
276
277
  #
277
- # AWS OpsWorks Stacks provides a standard set of built-in security
278
- # groups, one for each layer, which are associated with layers by
279
- # default. With `UseOpsworksSecurityGroups` you can instead provide your
280
- # own custom security groups. `UseOpsworksSecurityGroups` has the
281
- # following settings:
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 - AWS OpsWorks Stacks automatically associates the appropriate
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 - AWS OpsWorks Stacks does not associate built-in security
289
- # groups with layers. You must create appropriate EC2 security groups
290
- # and associate a security group with each layer that you create.
291
- # However, you can still manually associate a built-in security group
292
- # with a layer on creation; custom security groups are required only
293
- # for those layers that need custom settings.
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, AWS OpsWorks installs the public key on the
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 AWS OpsWorks Stacks agent version. You have the following
334
+ # The default OpsWorks Stacks agent version. You have the following
334
335
  # options:
335
336
  #
336
- # * Auto-update - Set this parameter to `LATEST`. AWS OpsWorks Stacks
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. AWS OpsWorks Stacks then automatically
343
- # installs that version on the stack's instances.
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, `DescribeStacks` returns a description of every
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 AWS region, such as "ap-northeast-2". For more information
56
- # about AWS regions, see [Regions and Endpoints][1].
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 AWS Identity and Access Management (IAM) role.
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 AWS OpsWorks Stacks
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 AWS OpsWorks Stacks and by
430
- # Chef recipes. The short name is also used as the name for the
431
- # directory where your app files are installed. It can have a maximum of
432
- # 200 characters, which are limited to the alphanumeric characters,
433
- # '-', '\_', and '.'.
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
- # The built-in layers' short names are defined by AWS OpsWorks Stacks.
436
- # For more information, see the [Layer Reference][1].
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 AWS CLI.
463
+ # supported as of version 1.7.42 of the CLI.
462
464
  #
463
465
  #
464
466
  #