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.
@@ -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
  #