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.
Files changed (12) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +5 -0
  3. data/VERSION +1 -1
  4. data/lib/aws-sdk-opsworks/client.rb +248 -229
  5. data/lib/aws-sdk-opsworks/client_api.rb +1 -0
  6. data/lib/aws-sdk-opsworks/endpoint_provider.rb +1 -1
  7. data/lib/aws-sdk-opsworks/layer.rb +9 -10
  8. data/lib/aws-sdk-opsworks/resource.rb +65 -60
  9. data/lib/aws-sdk-opsworks/stack.rb +16 -14
  10. data/lib/aws-sdk-opsworks/types.rb +346 -319
  11. data/lib/aws-sdk-opsworks.rb +1 -1
  12. metadata +2 -2
data/lib/aws-sdk-opsworks/client.rb CHANGED
@@ -430,13 +430,13 @@ module Aws::OpsWorks
430
430
  # * You can assign registered Amazon EC2 instances only to custom
431
431
  # layers.
432
432
  #
433
- # * You cannot use this action with instances that were created with AWS
433
+ # * You cannot use this action with instances that were created with
434
434
  # OpsWorks Stacks.
435
435
  #
436
- # **Required Permissions**: To use this action, an AWS Identity and
437
- # Access Management (IAM) user must have a Manage permissions level for
438
- # the stack or an attached policy that explicitly grants permissions.
439
- # For more information on user permissions, see [Managing User
436
+ # **Required Permissions**: To use this action, an Identity and Access
437
+ # Management (IAM) user must have a Manage permissions level for the
438
+ # stack or an attached policy that explicitly grants permissions. For
439
+ # more information on user permissions, see [Managing User
440
440
  # Permissions][1].
441
441
  #
442
442
  #
@@ -548,13 +548,13 @@ module Aws::OpsWorks
548
548
  end
549
549
 
550
550
  # Attaches an Elastic Load Balancing load balancer to a specified layer.
551
- # AWS OpsWorks Stacks does not support Application Load Balancer. You
552
- # can only use Classic Load Balancer with AWS OpsWorks Stacks. For more
551
+ # OpsWorks Stacks does not support Application Load Balancer. You can
552
+ # only use Classic Load Balancer with OpsWorks Stacks. For more
553
553
  # information, see [Elastic Load Balancing][1].
554
554
  #
555
555
  # <note markdown="1"> You must create the Elastic Load Balancing instance separately, by
556
556
  # using the Elastic Load Balancing console, API, or CLI. For more
557
- # information, see [ Elastic Load Balancing Developer Guide][2].
557
+ # information, see the [Elastic Load Balancing Developer Guide][2].
558
558
  #
559
559
  # </note>
560
560
  #
@@ -612,11 +612,12 @@ module Aws::OpsWorks
612
612
  # The source stack ID.
613
613
  #
614
614
  # @option params [String] :name
615
- # The cloned stack name.
615
+ # The cloned stack name. Stack names can be a maximum of 64 characters.
616
616
  #
617
617
  # @option params [String] :region
618
- # The cloned stack AWS region, such as "ap-northeast-2". For more
619
- # information about AWS regions, see [Regions and Endpoints][1].
618
+ # The cloned stack Amazon Web Services Region, such as `ap-northeast-2`.
619
+ # For more information about Amazon Web Services Regions, see [Regions
620
+ # and Endpoints][1].
620
621
  #
621
622
  #
622
623
  #
@@ -634,8 +635,8 @@ module Aws::OpsWorks
634
635
  #
635
636
  # If the VPC ID corresponds to a default VPC and you have specified
636
637
  # either the `DefaultAvailabilityZone` or the `DefaultSubnetId`
637
- # parameter only, AWS OpsWorks Stacks infers the value of the other
638
- # parameter. If you specify neither parameter, AWS OpsWorks Stacks sets
638
+ # parameter only, OpsWorks Stacks infers the value of the other
639
+ # parameter. If you specify neither parameter, OpsWorks Stacks sets
639
640
  # these parameters to the first valid Availability Zone for the
640
641
  # specified region and the corresponding default VPC subnet ID,
641
642
  # respectively.
@@ -647,9 +648,9 @@ module Aws::OpsWorks
647
648
  #
648
649
  # * You must specify a value for `DefaultSubnetId`.
649
650
  #
650
- # For more information about how to use AWS OpsWorks Stacks with a VPC,
651
- # see [Running a Stack in a VPC][1]. For more information about default
652
- # VPC and EC2 Classic, see [Supported Platforms][2].
651
+ # For more information about how to use OpsWorks Stacks with a VPC, see
652
+ # [Running a Stack in a VPC][1]. For more information about default VPC
653
+ # and EC2 Classic, see [Supported Platforms][2].
653
654
  #
654
655
  #
655
656
  #
@@ -661,10 +662,10 @@ module Aws::OpsWorks
661
662
  # to the cloned stack.
662
663
  #
663
664
  # @option params [required, String] :service_role_arn
664
- # The stack AWS Identity and Access Management (IAM) role, which allows
665
- # AWS OpsWorks Stacks to work with AWS resources on your behalf. You
666
- # must set this parameter to the Amazon Resource Name (ARN) for an
667
- # existing IAM role. If you create a stack by using the AWS OpsWorks
665
+ # The stack Identity and Access Management (IAM) role, which allows
666
+ # OpsWorks Stacks to work with Amazon Web Services resources on your
667
+ # behalf. You must set this parameter to the Amazon Resource Name (ARN)
668
+ # for an existing IAM role. If you create a stack by using the OpsWorkss
668
669
  # Stacks console, it creates the role for you. You can obtain an
669
670
  # existing stack's IAM ARN programmatically by calling
670
671
  # DescribePermissions. For more information about IAM ARNs, see [Using
@@ -695,12 +696,12 @@ module Aws::OpsWorks
695
696
  # following.
696
697
  #
697
698
  # * A supported Linux operating system: An Amazon Linux version, such as
698
- # `Amazon Linux 2018.03`, `Amazon Linux 2017.09`, `Amazon Linux
699
- # 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux 2016.03`, `Amazon
700
- # Linux 2015.09`, or `Amazon Linux 2015.03`.
699
+ # `Amazon Linux 2`, `Amazon Linux 2018.03`, `Amazon Linux 2017.09`,
700
+ # `Amazon Linux 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux
701
+ # 2016.03`, `Amazon Linux 2015.09`, or `Amazon Linux 2015.03`.
701
702
  #
702
- # * A supported Ubuntu operating system, such as `Ubuntu 16.04 LTS`,
703
- # `Ubuntu 14.04 LTS`, or `Ubuntu 12.04 LTS`.
703
+ # * A supported Ubuntu operating system, such as `Ubuntu 18.04 LTS`,
704
+ # `Ubuntu 16.04 LTS`, `Ubuntu 14.04 LTS`, or `Ubuntu 12.04 LTS`.
704
705
  #
705
706
  # * `CentOS Linux 7`
706
707
  #
@@ -715,9 +716,10 @@ module Aws::OpsWorks
715
716
  # when you create instances. For more information about how to use
716
717
  # custom AMIs with OpsWorks, see [Using Custom AMIs][1].
717
718
  #
718
- # The default option is the parent stack's operating system. For more
719
- # information about supported operating systems, see [AWS OpsWorks
720
- # Stacks Operating Systems][2].
719
+ # The default option is the parent stack's operating system. Not all
720
+ # operating systems are supported with all versions of Chef. For more
721
+ # information about supported operating systems, see [OpsWorks Stacks
722
+ # Operating Systems][2].
721
723
  #
722
724
  # <note markdown="1"> You can specify a different Linux operating system for the cloned
723
725
  # stack, but you cannot change from Linux to Windows or Windows to
@@ -815,27 +817,26 @@ module Aws::OpsWorks
815
817
  # Whether to use custom cookbooks.
816
818
  #
817
819
  # @option params [Boolean] :use_opsworks_security_groups
818
- # Whether to associate the AWS OpsWorks Stacks built-in security groups
819
- # with the stack's layers.
820
+ # Whether to associate the OpsWorks Stacks built-in security groups with
821
+ # the stack's layers.
820
822
  #
821
- # AWS OpsWorks Stacks provides a standard set of built-in security
822
- # groups, one for each layer, which are associated with layers by
823
- # default. With `UseOpsworksSecurityGroups` you can instead provide your
824
- # own custom security groups. `UseOpsworksSecurityGroups` has the
825
- # following settings:
823
+ # OpsWorks Stacks provides a standard set of security groups, one for
824
+ # each layer, which are associated with layers by default. With
825
+ # `UseOpsworksSecurityGroups` you can instead provide your own custom
826
+ # security groups. `UseOpsworksSecurityGroups` has the following
827
+ # settings:
826
828
  #
827
- # * True - AWS OpsWorks Stacks automatically associates the appropriate
829
+ # * True - OpsWorks Stacks automatically associates the appropriate
828
830
  # built-in security group with each layer (default setting). You can
829
831
  # associate additional security groups with a layer after you create
830
832
  # it but you cannot delete the built-in security group.
831
833
  #
832
- # * False - AWS OpsWorks Stacks does not associate built-in security
833
- # groups with layers. You must create appropriate Amazon Elastic
834
- # Compute Cloud (Amazon EC2) security groups and associate a security
835
- # group with each layer that you create. However, you can still
836
- # manually associate a built-in security group with a layer on
837
- # creation; custom security groups are required only for those layers
838
- # that need custom settings.
834
+ # * False - OpsWorks Stacks does not associate built-in security groups
835
+ # with layers. You must create appropriate Amazon EC2 security groups
836
+ # and associate a security group with each layer that you create.
837
+ # However, you can still manually associate a built-in security group
838
+ # with a layer on creation; custom security groups are required only
839
+ # for those layers that need custom settings.
839
840
  #
840
841
  # For more information, see [Create a New Stack][1].
841
842
  #
@@ -855,7 +856,7 @@ module Aws::OpsWorks
855
856
  #
856
857
  # @option params [String] :default_ssh_key_name
857
858
  # A default Amazon EC2 key pair name. The default value is none. If you
858
- # specify a key pair name, AWS OpsWorks installs the public key on the
859
+ # specify a key pair name, OpsWorks installs the public key on the
859
860
  # instance and you can use the private key with an SSH client to log in
860
861
  # to the instance. For more information, see [ Using SSH to Communicate
861
862
  # with an Instance][1] and [ Managing SSH Access][2]. You can override
@@ -885,17 +886,17 @@ module Aws::OpsWorks
885
886
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ComponentsAMIs.html#storage-for-the-root-device
886
887
  #
887
888
  # @option params [String] :agent_version
888
- # The default AWS OpsWorks Stacks agent version. You have the following
889
+ # The default OpsWorks Stacks agent version. You have the following
889
890
  # options:
890
891
  #
891
- # * Auto-update - Set this parameter to `LATEST`. AWS OpsWorks Stacks
892
+ # * Auto-update - Set this parameter to `LATEST`. OpsWorks Stacks
892
893
  # automatically installs new agent versions on the stack's instances
893
894
  # as soon as they are available.
894
895
  #
895
896
  # * Fixed version - Set this parameter to your preferred agent version.
896
897
  # To update the agent version, you must edit the stack configuration
897
- # and specify a new version. AWS OpsWorks Stacks then automatically
898
- # installs that version on the stack's instances.
898
+ # and specify a new version. OpsWorks Stacks automatically installs
899
+ # that version on the stack's instances.
899
900
  #
900
901
  # The default setting is `LATEST`. To specify an agent version, you must
901
902
  # use the complete version number, not the abbreviated number shown on
@@ -997,7 +998,7 @@ module Aws::OpsWorks
997
998
  # @option params [required, String] :type
998
999
  # The app type. Each supported type is associated with a particular
999
1000
  # layer. For example, PHP applications are associated with a PHP layer.
1000
- # AWS OpsWorks Stacks deploys an application to those instances that are
1001
+ # OpsWorks Stacks deploys an application to those instances that are
1001
1002
  # members of the corresponding layer. If your app isn't one of the
1002
1003
  # standard types, or you prefer to implement your own Deploy recipes,
1003
1004
  # specify `other`.
@@ -1221,19 +1222,24 @@ module Aws::OpsWorks
1221
1222
  # use only time-based instances.
1222
1223
  #
1223
1224
  # @option params [String] :hostname
1224
- # The instance host name.
1225
+ # The instance host name. The following are character limits for
1226
+ # instance host names.
1227
+ #
1228
+ # * Linux-based instances: 63 characters
1229
+ #
1230
+ # * Windows-based instances: 15 characters
1225
1231
  #
1226
1232
  # @option params [String] :os
1227
1233
  # The instance's operating system, which must be set to one of the
1228
1234
  # following.
1229
1235
  #
1230
1236
  # * A supported Linux operating system: An Amazon Linux version, such as
1231
- # `Amazon Linux 2018.03`, `Amazon Linux 2017.09`, `Amazon Linux
1232
- # 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux 2016.03`, `Amazon
1233
- # Linux 2015.09`, or `Amazon Linux 2015.03`.
1237
+ # `Amazon Linux 2`, `Amazon Linux 2018.03`, `Amazon Linux 2017.09`,
1238
+ # `Amazon Linux 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux
1239
+ # 2016.03`, `Amazon Linux 2015.09`, or `Amazon Linux 2015.03`.
1234
1240
  #
1235
- # * A supported Ubuntu operating system, such as `Ubuntu 16.04 LTS`,
1236
- # `Ubuntu 14.04 LTS`, or `Ubuntu 12.04 LTS`.
1241
+ # * A supported Ubuntu operating system, such as `Ubuntu 18.04 LTS`,
1242
+ # `Ubuntu 16.04 LTS`, `Ubuntu 14.04 LTS`, or `Ubuntu 12.04 LTS`.
1237
1243
  #
1238
1244
  # * `CentOS Linux 7`
1239
1245
  #
@@ -1247,16 +1253,16 @@ module Aws::OpsWorks
1247
1253
  #
1248
1254
  # * A custom AMI: `Custom`.
1249
1255
  #
1250
- # For more information about the supported operating systems, see [AWS
1251
- # OpsWorks Stacks Operating Systems][1].
1256
+ # Not all operating systems are supported with all versions of Chef. For
1257
+ # more information about the supported operating systems, see [OpsWorks
1258
+ # Stacks Operating Systems][1].
1252
1259
  #
1253
1260
  # The default option is the current Amazon Linux version. If you set
1254
1261
  # this parameter to `Custom`, you must use the CreateInstance action's
1255
1262
  # AmiId parameter to specify the custom AMI that you want to use. Block
1256
1263
  # device mappings are not supported if the value is `Custom`. For more
1257
- # information about supported operating systems, see [Operating
1258
- # Systems][1]For more information about how to use custom AMIs with AWS
1259
- # OpsWorks Stacks, see [Using Custom AMIs][2].
1264
+ # information about how to use custom AMIs with OpsWorks Stacks, see
1265
+ # [Using Custom AMIs][2].
1260
1266
  #
1261
1267
  #
1262
1268
  #
@@ -1293,8 +1299,8 @@ module Aws::OpsWorks
1293
1299
  # @option params [String] :subnet_id
1294
1300
  # The ID of the instance's subnet. If the stack is running in a VPC,
1295
1301
  # you can use this parameter to override the stack's default subnet ID
1296
- # value and direct AWS OpsWorks Stacks to launch the instance in a
1297
- # different subnet.
1302
+ # value and direct OpsWorks Stacks to launch the instance in a different
1303
+ # subnet.
1298
1304
  #
1299
1305
  # @option params [String] :architecture
1300
1306
  # The instance architecture. The default option is `x86_64`. Instance
@@ -1340,16 +1346,15 @@ module Aws::OpsWorks
1340
1346
  # Whether to create an Amazon EBS-optimized instance.
1341
1347
  #
1342
1348
  # @option params [String] :agent_version
1343
- # The default AWS OpsWorks Stacks agent version. You have the following
1349
+ # The default OpsWorks Stacks agent version. You have the following
1344
1350
  # options:
1345
1351
  #
1346
1352
  # * `INHERIT` - Use the stack's default agent version setting.
1347
1353
  #
1348
1354
  # * *version\_number* - Use the specified agent version. This value
1349
1355
  # overrides the stack's default setting. To update the agent version,
1350
- # edit the instance configuration and specify a new version. AWS
1351
- # OpsWorks Stacks then automatically installs that version on the
1352
- # instance.
1356
+ # edit the instance configuration and specify a new version. OpsWorks
1357
+ # Stacks installs that version on the instance.
1353
1358
  #
1354
1359
  # The default setting is `INHERIT`. To specify an agent version, you
1355
1360
  # must use the complete version number, not the abbreviated number shown
@@ -1456,18 +1461,19 @@ module Aws::OpsWorks
1456
1461
  # layers are not available in Chef 12 stacks.
1457
1462
  #
1458
1463
  # @option params [required, String] :name
1459
- # The layer name, which is used by the console.
1464
+ # The layer name, which is used by the console. Layer names can be a
1465
+ # maximum of 32 characters.
1460
1466
  #
1461
1467
  # @option params [required, String] :shortname
1462
1468
  # For custom layers only, use this parameter to specify the layer's
1463
- # short name, which is used internally by AWS OpsWorks Stacks and by
1464
- # Chef recipes. The short name is also used as the name for the
1465
- # directory where your app files are installed. It can have a maximum of
1466
- # 200 characters, which are limited to the alphanumeric characters,
1467
- # '-', '\_', and '.'.
1469
+ # short name, which is used internally by OpsWorks Stacks and by Chef
1470
+ # recipes. The short name is also used as the name for the directory
1471
+ # where your app files are installed. It can have a maximum of 32
1472
+ # characters, which are limited to the alphanumeric characters, '-',
1473
+ # '\_', and '.'.
1468
1474
  #
1469
- # The built-in layers' short names are defined by AWS OpsWorks Stacks.
1470
- # For more information, see the [Layer Reference][1].
1475
+ # Built-in layer short names are defined by OpsWorks Stacks. For more
1476
+ # information, see the [Layer Reference][1].
1471
1477
  #
1472
1478
  #
1473
1479
  #
@@ -1496,7 +1502,7 @@ module Aws::OpsWorks
1496
1502
  # A JSON-formatted string containing custom stack configuration and
1497
1503
  # deployment attributes to be installed on the layer's instances. For
1498
1504
  # more information, see [ Using Custom JSON][1]. This feature is
1499
- # supported as of version 1.7.42 of the AWS CLI.
1505
+ # supported as of version 1.7.42 of the CLI.
1500
1506
  #
1501
1507
  #
1502
1508
  #
@@ -1652,29 +1658,30 @@ module Aws::OpsWorks
1652
1658
  # [2]: https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html
1653
1659
  #
1654
1660
  # @option params [required, String] :name
1655
- # The stack name.
1661
+ # The stack name. Stack names can be a maximum of 64 characters.
1656
1662
  #
1657
1663
  # @option params [required, String] :region
1658
- # The stack's AWS region, such as `ap-south-1`. For more information
1659
- # about Amazon regions, see [Regions and Endpoints][1].
1660
- #
1661
- # <note markdown="1"> In the AWS CLI, this API maps to the `--stack-region` parameter. If
1662
- # the `--stack-region` parameter and the AWS CLI common parameter
1663
- # `--region` are set to the same value, the stack uses a *regional*
1664
- # endpoint. If the `--stack-region` parameter is not set, but the AWS
1665
- # CLI `--region` parameter is, this also results in a stack with a
1666
- # *regional* endpoint. However, if the `--region` parameter is set to
1667
- # `us-east-1`, and the `--stack-region` parameter is set to one of the
1668
- # following, then the stack uses a legacy or *classic* region:
1669
- # `us-west-1, us-west-2, sa-east-1, eu-central-1, eu-west-1,
1670
- # ap-northeast-1, ap-southeast-1, ap-southeast-2`. In this case, the
1671
- # actual API endpoint of the stack is in `us-east-1`. Only the preceding
1672
- # regions are supported as classic regions in the `us-east-1` API
1673
- # endpoint. Because it is a best practice to choose the regional
1674
- # endpoint that is closest to where you manage AWS, we recommend that
1675
- # you use regional endpoints for new stacks. The AWS CLI common
1676
- # `--region` parameter always specifies a regional API endpoint; it
1677
- # cannot be used to specify a classic AWS OpsWorks Stacks region.
1664
+ # The stack's Amazon Web Services Region, such as `ap-south-1`. For
1665
+ # more information about Amazon Web Services Regions, see [Regions and
1666
+ # Endpoints][1].
1667
+ #
1668
+ # <note markdown="1"> In the CLI, this API maps to the `--stack-region` parameter. If the
1669
+ # `--stack-region` parameter and the CLI common parameter `--region` are
1670
+ # set to the same value, the stack uses a *regional* endpoint. If the
1671
+ # `--stack-region` parameter is not set, but the CLI `--region`
1672
+ # parameter is, this also results in a stack with a *regional* endpoint.
1673
+ # However, if the `--region` parameter is set to `us-east-1`, and the
1674
+ # `--stack-region` parameter is set to one of the following, then the
1675
+ # stack uses a legacy or *classic* region: `us-west-1, us-west-2,
1676
+ # sa-east-1, eu-central-1, eu-west-1, ap-northeast-1, ap-southeast-1,
1677
+ # ap-southeast-2`. In this case, the actual API endpoint of the stack is
1678
+ # in `us-east-1`. Only the preceding regions are supported as classic
1679
+ # regions in the `us-east-1` API endpoint. Because it is a best practice
1680
+ # to choose the regional endpoint that is closest to where you manage
1681
+ # Amazon Web Services, we recommend that you use regional endpoints for
1682
+ # new stacks. The CLI common `--region` parameter always specifies a
1683
+ # regional API endpoint; it cannot be used to specify a classic OpsWorks
1684
+ # Stacks region.
1678
1685
  #
1679
1686
  # </note>
1680
1687
  #
@@ -1694,8 +1701,8 @@ module Aws::OpsWorks
1694
1701
  #
1695
1702
  # If the VPC ID corresponds to a default VPC and you have specified
1696
1703
  # either the `DefaultAvailabilityZone` or the `DefaultSubnetId`
1697
- # parameter only, AWS OpsWorks Stacks infers the value of the other
1698
- # parameter. If you specify neither parameter, AWS OpsWorks Stacks sets
1704
+ # parameter only, OpsWorks Stacks infers the value of the other
1705
+ # parameter. If you specify neither parameter, OpsWorks Stacks sets
1699
1706
  # these parameters to the first valid Availability Zone for the
1700
1707
  # specified region and the corresponding default VPC subnet ID,
1701
1708
  # respectively.
@@ -1707,9 +1714,9 @@ module Aws::OpsWorks
1707
1714
  #
1708
1715
  # * You must specify a value for `DefaultSubnetId`.
1709
1716
  #
1710
- # For more information about how to use AWS OpsWorks Stacks with a VPC,
1711
- # see [Running a Stack in a VPC][1]. For more information about default
1712
- # VPC and EC2-Classic, see [Supported Platforms][2].
1717
+ # For more information about how to use OpsWorks Stacks with a VPC, see
1718
+ # [Running a Stack in a VPC][1]. For more information about default VPC
1719
+ # and EC2-Classic, see [Supported Platforms][2].
1713
1720
  #
1714
1721
  #
1715
1722
  #
@@ -1721,11 +1728,10 @@ module Aws::OpsWorks
1721
1728
  # attributes.
1722
1729
  #
1723
1730
  # @option params [required, String] :service_role_arn
1724
- # The stack's AWS Identity and Access Management (IAM) role, which
1725
- # allows AWS OpsWorks Stacks to work with AWS resources on your behalf.
1726
- # You must set this parameter to the Amazon Resource Name (ARN) for an
1727
- # existing IAM role. For more information about IAM ARNs, see [Using
1728
- # Identifiers][1].
1731
+ # The stack's IAM role, which allows OpsWorks Stacks to work with
1732
+ # Amazon Web Services resources on your behalf. You must set this
1733
+ # parameter to the Amazon Resource Name (ARN) for an existing IAM role.
1734
+ # For more information about IAM ARNs, see [Using Identifiers][1].
1729
1735
  #
1730
1736
  #
1731
1737
  #
@@ -1746,12 +1752,12 @@ module Aws::OpsWorks
1746
1752
  # create the instance. You can specify one of the following.
1747
1753
  #
1748
1754
  # * A supported Linux operating system: An Amazon Linux version, such as
1749
- # `Amazon Linux 2018.03`, `Amazon Linux 2017.09`, `Amazon Linux
1750
- # 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux 2016.03`, `Amazon
1751
- # Linux 2015.09`, or `Amazon Linux 2015.03`.
1755
+ # `Amazon Linux 2`, `Amazon Linux 2018.03`, `Amazon Linux 2017.09`,
1756
+ # `Amazon Linux 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux
1757
+ # 2016.03`, `Amazon Linux 2015.09`, or `Amazon Linux 2015.03`.
1752
1758
  #
1753
- # * A supported Ubuntu operating system, such as `Ubuntu 16.04 LTS`,
1754
- # `Ubuntu 14.04 LTS`, or `Ubuntu 12.04 LTS`.
1759
+ # * A supported Ubuntu operating system, such as `Ubuntu 18.04 LTS`,
1760
+ # `Ubuntu 16.04 LTS`, `Ubuntu 14.04 LTS`, or `Ubuntu 12.04 LTS`.
1755
1761
  #
1756
1762
  # * `CentOS Linux 7`
1757
1763
  #
@@ -1767,9 +1773,10 @@ module Aws::OpsWorks
1767
1773
  # when you create instances. For more information, see [ Using Custom
1768
1774
  # AMIs][1].
1769
1775
  #
1770
- # The default option is the current Amazon Linux version. For more
1771
- # information about supported operating systems, see [AWS OpsWorks
1772
- # Stacks Operating Systems][2].
1776
+ # The default option is the current Amazon Linux version. Not all
1777
+ # operating systems are supported with all versions of Chef. For more
1778
+ # information about supported operating systems, see [OpsWorks Stacks
1779
+ # Operating Systems][2].
1773
1780
  #
1774
1781
  #
1775
1782
  #
@@ -1862,26 +1869,26 @@ module Aws::OpsWorks
1862
1869
  # Whether the stack uses custom cookbooks.
1863
1870
  #
1864
1871
  # @option params [Boolean] :use_opsworks_security_groups
1865
- # Whether to associate the AWS OpsWorks Stacks built-in security groups
1866
- # with the stack's layers.
1872
+ # Whether to associate the OpsWorks Stacks built-in security groups with
1873
+ # the stack's layers.
1867
1874
  #
1868
- # AWS OpsWorks Stacks provides a standard set of built-in security
1869
- # groups, one for each layer, which are associated with layers by
1870
- # default. With `UseOpsworksSecurityGroups` you can instead provide your
1871
- # own custom security groups. `UseOpsworksSecurityGroups` has the
1872
- # following settings:
1875
+ # OpsWorks Stacks provides a standard set of built-in security groups,
1876
+ # one for each layer, which are associated with layers by default. With
1877
+ # `UseOpsworksSecurityGroups` you can instead provide your own custom
1878
+ # security groups. `UseOpsworksSecurityGroups` has the following
1879
+ # settings:
1873
1880
  #
1874
- # * True - AWS OpsWorks Stacks automatically associates the appropriate
1881
+ # * True - OpsWorks Stacks automatically associates the appropriate
1875
1882
  # built-in security group with each layer (default setting). You can
1876
1883
  # associate additional security groups with a layer after you create
1877
1884
  # it, but you cannot delete the built-in security group.
1878
1885
  #
1879
- # * False - AWS OpsWorks Stacks does not associate built-in security
1880
- # groups with layers. You must create appropriate EC2 security groups
1881
- # and associate a security group with each layer that you create.
1882
- # However, you can still manually associate a built-in security group
1883
- # with a layer on creation; custom security groups are required only
1884
- # for those layers that need custom settings.
1886
+ # * False - OpsWorks Stacks does not associate built-in security groups
1887
+ # with layers. You must create appropriate EC2 security groups and
1888
+ # associate a security group with each layer that you create. However,
1889
+ # you can still manually associate a built-in security group with a
1890
+ # layer on creation; custom security groups are required only for
1891
+ # those layers that need custom settings.
1885
1892
  #
1886
1893
  # For more information, see [Create a New Stack][1].
1887
1894
  #
@@ -1901,7 +1908,7 @@ module Aws::OpsWorks
1901
1908
  #
1902
1909
  # @option params [String] :default_ssh_key_name
1903
1910
  # A default Amazon EC2 key pair name. The default value is none. If you
1904
- # specify a key pair name, AWS OpsWorks installs the public key on the
1911
+ # specify a key pair name, OpsWorks installs the public key on the
1905
1912
  # instance and you can use the private key with an SSH client to log in
1906
1913
  # to the instance. For more information, see [ Using SSH to Communicate
1907
1914
  # with an Instance][1] and [ Managing SSH Access][2]. You can override
@@ -1925,17 +1932,17 @@ module Aws::OpsWorks
1925
1932
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ComponentsAMIs.html#storage-for-the-root-device
1926
1933
  #
1927
1934
  # @option params [String] :agent_version
1928
- # The default AWS OpsWorks Stacks agent version. You have the following
1935
+ # The default OpsWorks Stacks agent version. You have the following
1929
1936
  # options:
1930
1937
  #
1931
- # * Auto-update - Set this parameter to `LATEST`. AWS OpsWorks Stacks
1938
+ # * Auto-update - Set this parameter to `LATEST`. OpsWorks Stacks
1932
1939
  # automatically installs new agent versions on the stack's instances
1933
1940
  # as soon as they are available.
1934
1941
  #
1935
1942
  # * Fixed version - Set this parameter to your preferred agent version.
1936
1943
  # To update the agent version, you must edit the stack configuration
1937
- # and specify a new version. AWS OpsWorks Stacks then automatically
1938
- # installs that version on the stack's instances.
1944
+ # and specify a new version. OpsWorks Stacks installs that version on
1945
+ # the stack's instances.
1939
1946
  #
1940
1947
  # The default setting is the most recent release of the agent. To
1941
1948
  # specify an agent version, you must use the complete version number,
@@ -2021,10 +2028,9 @@ module Aws::OpsWorks
2021
2028
  # @option params [String] :ssh_username
2022
2029
  # The user's SSH user name. The allowable characters are \[a-z\],
2023
2030
  # \[A-Z\], \[0-9\], '-', and '\_'. If the specified name includes
2024
- # other punctuation marks, AWS OpsWorks Stacks removes them. For
2025
- # example, `my.name` will be changed to `myname`. If you do not specify
2026
- # an SSH user name, AWS OpsWorks Stacks generates one from the IAM user
2027
- # name.
2031
+ # other punctuation marks, OpsWorks Stacks removes them. For example,
2032
+ # `my.name` is changed to `myname`. If you do not specify an SSH user
2033
+ # name, OpsWorks Stacks generates one from the IAM user name.
2028
2034
  #
2029
2035
  # @option params [String] :ssh_public_key
2030
2036
  # The user's public SSH key.
@@ -2271,9 +2277,9 @@ module Aws::OpsWorks
2271
2277
  req.send_request(options)
2272
2278
  end
2273
2279
 
2274
- # Deregisters a specified Elastic IP address. The address can then be
2275
- # registered by another stack. For more information, see [Resource
2276
- # Management][1].
2280
+ # Deregisters a specified Elastic IP address. The address can be
2281
+ # registered by another stack after it is deregistered. For more
2282
+ # information, see [Resource Management][1].
2277
2283
  #
2278
2284
  # **Required Permissions**: To use this action, an IAM user must have a
2279
2285
  # Manage permissions level for the stack, or an attached policy that
@@ -2305,10 +2311,10 @@ module Aws::OpsWorks
2305
2311
  req.send_request(options)
2306
2312
  end
2307
2313
 
2308
- # Deregister a registered Amazon EC2 or on-premises instance. This
2309
- # action removes the instance from the stack and returns it to your
2310
- # control. This action cannot be used with instances that were created
2311
- # with AWS OpsWorks Stacks.
2314
+ # Deregister an instance from OpsWorks Stacks. The instance can be a
2315
+ # registered instance (Amazon EC2 or on-premises) or an instance created
2316
+ # with OpsWorks. This action removes the instance from the stack and
2317
+ # returns it to your control.
2312
2318
  #
2313
2319
  # **Required Permissions**: To use this action, an IAM user must have a
2314
2320
  # Manage permissions level for the stack or an attached policy that
@@ -2384,9 +2390,9 @@ module Aws::OpsWorks
2384
2390
  # [2]: https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html
2385
2391
  #
2386
2392
  # @option params [required, String] :volume_id
2387
- # The AWS OpsWorks Stacks volume ID, which is the GUID that AWS OpsWorks
2388
- # Stacks assigned to the instance when you registered the volume with
2389
- # the stack, not the Amazon EC2 volume ID.
2393
+ # The OpsWorks Stacks volume ID, which is the GUID that OpsWorks Stacks
2394
+ # assigned to the instance when you registered the volume with the
2395
+ # stack, not the Amazon EC2 volume ID.
2390
2396
  #
2391
2397
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2392
2398
  #
@@ -2405,7 +2411,7 @@ module Aws::OpsWorks
2405
2411
  req.send_request(options)
2406
2412
  end
2407
2413
 
2408
- # Describes the available AWS OpsWorks Stacks agent versions. You must
2414
+ # Describes the available OpsWorks Stacks agent versions. You must
2409
2415
  # specify a stack ID or a configuration manager. `DescribeAgentVersions`
2410
2416
  # returns a list of available agent versions for the specified stack or
2411
2417
  # configuration manager.
@@ -2672,7 +2678,7 @@ module Aws::OpsWorks
2672
2678
 
2673
2679
  # Describes Amazon ECS clusters that are registered with a stack. If you
2674
2680
  # specify only a stack ID, you can use the `MaxResults` and `NextToken`
2675
- # parameters to paginate the response. However, AWS OpsWorks Stacks
2681
+ # parameters to paginate the response. However, OpsWorks Stacks
2676
2682
  # currently supports only one cluster per layer, so the result set has a
2677
2683
  # maximum of one element.
2678
2684
  #
@@ -3185,8 +3191,7 @@ module Aws::OpsWorks
3185
3191
  req.send_request(options)
3186
3192
  end
3187
3193
 
3188
- # Describes the operating systems that are supported by AWS OpsWorks
3189
- # Stacks.
3194
+ # Describes the operating systems that are supported by OpsWorks Stacks.
3190
3195
  #
3191
3196
  # @return [Types::DescribeOperatingSystemsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3192
3197
  #
@@ -3386,7 +3391,7 @@ module Aws::OpsWorks
3386
3391
  req.send_request(options)
3387
3392
  end
3388
3393
 
3389
- # Describes AWS OpsWorks Stacks service errors.
3394
+ # Describes OpsWorks Stacks service errors.
3390
3395
  #
3391
3396
  # **Required Permissions**: To use this action, an IAM user must have a
3392
3397
  # Show, Deploy, or Manage permissions level for the stack, or an
@@ -3564,8 +3569,12 @@ module Aws::OpsWorks
3564
3569
  #
3565
3570
  # @option params [Array<String>] :stack_ids
3566
3571
  # An array of stack IDs that specify the stacks to be described. If you
3567
- # omit this parameter, `DescribeStacks` returns a description of every
3568
- # stack.
3572
+ # omit this parameter, and have permissions to get information about all
3573
+ # stacks, `DescribeStacks` returns a description of every stack. If the
3574
+ # IAM policy that is attached to an IAM user limits the `DescribeStacks`
3575
+ # action to specific stack ARNs, this parameter is required, and the
3576
+ # user must specify a stack ARN that is allowed by the policy.
3577
+ # Otherwise, `DescribeStacks` returns an `AccessDenied` error.
3569
3578
  #
3570
3579
  # @return [Types::DescribeStacksResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3571
3580
  #
@@ -3912,13 +3921,13 @@ module Aws::OpsWorks
3912
3921
  # Grants RDP access to a Windows instance for a specified time period.
3913
3922
  #
3914
3923
  # @option params [required, String] :instance_id
3915
- # The instance's AWS OpsWorks Stacks ID.
3924
+ # The instance's OpsWorks Stacks ID.
3916
3925
  #
3917
3926
  # @option params [Integer] :valid_for_in_minutes
3918
3927
  # The length of time (in minutes) that the grant is valid. When the
3919
3928
  # grant expires at the end of this period, the user will no longer be
3920
3929
  # able to use the credentials to log in. If the user is logged in at the
3921
- # time, he or she automatically will be logged out.
3930
+ # time, they are logged out.
3922
3931
  #
3923
3932
  # @return [Types::GrantAccessResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3924
3933
  #
@@ -4113,16 +4122,16 @@ module Aws::OpsWorks
4113
4122
  req.send_request(options)
4114
4123
  end
4115
4124
 
4116
- # Registers instances that were created outside of AWS OpsWorks Stacks
4117
- # with a specified stack.
4125
+ # Registers instances that were created outside of OpsWorks Stacks with
4126
+ # a specified stack.
4118
4127
  #
4119
4128
  # <note markdown="1"> We do not recommend using this action to register instances. The
4120
- # complete registration operation includes two tasks: installing the AWS
4129
+ # complete registration operation includes two tasks: installing the
4121
4130
  # OpsWorks Stacks agent on the instance, and registering the instance
4122
4131
  # with the stack. `RegisterInstance` handles only the second step. You
4123
- # should instead use the AWS CLI `register` command, which performs the
4132
+ # should instead use the CLI `register` command, which performs the
4124
4133
  # entire registration operation. For more information, see [ Registering
4125
- # an Instance with an AWS OpsWorks Stacks Stack][1].
4134
+ # an Instance with an OpsWorks Stacks Stack][1].
4126
4135
  #
4127
4136
  # </note>
4128
4137
  #
@@ -4148,7 +4157,12 @@ module Aws::OpsWorks
4148
4157
  # The ID of the stack that the instance is to be registered with.
4149
4158
  #
4150
4159
  # @option params [String] :hostname
4151
- # The instance's hostname.
4160
+ # The instance's host name. The following are character limits for
4161
+ # instance host names.
4162
+ #
4163
+ # * Linux-based instances: 63 characters
4164
+ #
4165
+ # * Windows-based instances: 15 characters
4152
4166
  #
4153
4167
  # @option params [String] :public_ip
4154
4168
  # The instance's public IP address.
@@ -4316,14 +4330,14 @@ module Aws::OpsWorks
4316
4330
  # @option params [Types::AutoScalingThresholds] :up_scaling
4317
4331
  # An `AutoScalingThresholds` object with the upscaling threshold
4318
4332
  # configuration. If the load exceeds these thresholds for a specified
4319
- # amount of time, AWS OpsWorks Stacks starts a specified number of
4333
+ # amount of time, OpsWorks Stacks starts a specified number of
4320
4334
  # instances.
4321
4335
  #
4322
4336
  # @option params [Types::AutoScalingThresholds] :down_scaling
4323
4337
  # An `AutoScalingThresholds` object with the downscaling threshold
4324
4338
  # configuration. If the load falls below these thresholds for a
4325
- # specified amount of time, AWS OpsWorks Stacks stops a specified number
4326
- # of instances.
4339
+ # specified amount of time, OpsWorks Stacks stops a specified number of
4340
+ # instances.
4327
4341
  #
4328
4342
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4329
4343
  #
@@ -4574,11 +4588,11 @@ module Aws::OpsWorks
4574
4588
  # @option params [Boolean] :force
4575
4589
  # Specifies whether to force an instance to stop. If the instance's
4576
4590
  # root device type is `ebs`, or EBS-backed, adding the `Force` parameter
4577
- # to the `StopInstances` API call disassociates the AWS OpsWorks Stacks
4591
+ # to the `StopInstances` API call disassociates the OpsWorks Stacks
4578
4592
  # instance from EC2, and forces deletion of *only* the OpsWorks Stacks
4579
4593
  # instance. You must also delete the formerly-associated instance in EC2
4580
- # after troubleshooting and replacing the AWS OpsWorks Stacks instance
4581
- # with a new one.
4594
+ # after troubleshooting and replacing the OpsWorks Stacks instance with
4595
+ # a new one.
4582
4596
  #
4583
4597
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4584
4598
  #
@@ -4629,9 +4643,9 @@ module Aws::OpsWorks
4629
4643
  req.send_request(options)
4630
4644
  end
4631
4645
 
4632
- # Apply cost-allocation tags to a specified stack or layer in AWS
4633
- # OpsWorks Stacks. For more information about how tagging works, see
4634
- # [Tags][1] in the AWS OpsWorks User Guide.
4646
+ # Apply cost-allocation tags to a specified stack or layer in OpsWorks
4647
+ # Stacks. For more information about how tagging works, see [Tags][1] in
4648
+ # the OpsWorks User Guide.
4635
4649
  #
4636
4650
  #
4637
4651
  #
@@ -4682,7 +4696,7 @@ module Aws::OpsWorks
4682
4696
  # Unassigns a registered instance from all layers that are using the
4683
4697
  # instance. The instance remains in the stack as an unassigned instance,
4684
4698
  # and can be assigned to another layer as needed. You cannot use this
4685
- # action with instances that were created with AWS OpsWorks Stacks.
4699
+ # action with instances that were created with OpsWorks Stacks.
4686
4700
  #
4687
4701
  # **Required Permissions**: To use this action, an IAM user must have a
4688
4702
  # Manage permissions level for the stack or an attached policy that
@@ -4906,7 +4920,7 @@ module Aws::OpsWorks
4906
4920
  # The IP address for which you want to update the name.
4907
4921
  #
4908
4922
  # @option params [String] :name
4909
- # The new name.
4923
+ # The new name, which can be a maximum of 32 characters.
4910
4924
  #
4911
4925
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4912
4926
  #
@@ -4961,19 +4975,24 @@ module Aws::OpsWorks
4961
4975
  # use only time-based instances.
4962
4976
  #
4963
4977
  # @option params [String] :hostname
4964
- # The instance host name.
4978
+ # The instance host name. The following are character limits for
4979
+ # instance host names.
4980
+ #
4981
+ # * Linux-based instances: 63 characters
4982
+ #
4983
+ # * Windows-based instances: 15 characters
4965
4984
  #
4966
4985
  # @option params [String] :os
4967
4986
  # The instance's operating system, which must be set to one of the
4968
4987
  # following. You cannot update an instance that is using a custom AMI.
4969
4988
  #
4970
4989
  # * A supported Linux operating system: An Amazon Linux version, such as
4971
- # `Amazon Linux 2018.03`, `Amazon Linux 2017.09`, `Amazon Linux
4972
- # 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux 2016.03`, `Amazon
4973
- # Linux 2015.09`, or `Amazon Linux 2015.03`.
4990
+ # `Amazon Linux 2`, `Amazon Linux 2018.03`, `Amazon Linux 2017.09`,
4991
+ # `Amazon Linux 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux
4992
+ # 2016.03`, `Amazon Linux 2015.09`, or `Amazon Linux 2015.03`.
4974
4993
  #
4975
- # * A supported Ubuntu operating system, such as `Ubuntu 16.04 LTS`,
4976
- # `Ubuntu 14.04 LTS`, or `Ubuntu 12.04 LTS`.
4994
+ # * A supported Ubuntu operating system, such as `Ubuntu 18.04 LTS`,
4995
+ # `Ubuntu 16.04 LTS`, `Ubuntu 14.04 LTS`, or `Ubuntu 12.04 LTS`.
4977
4996
  #
4978
4997
  # * `CentOS Linux 7`
4979
4998
  #
@@ -4985,15 +5004,15 @@ module Aws::OpsWorks
4985
5004
  # Standard`, or `Microsoft Windows Server 2012 R2 with SQL Server
4986
5005
  # Web`.
4987
5006
  #
4988
- # For more information about supported operating systems, see [AWS
4989
- # OpsWorks Stacks Operating Systems][1].
5007
+ # Not all operating systems are supported with all versions of Chef. For
5008
+ # more information about supported operating systems, see [OpsWorks
5009
+ # Stacks Operating Systems][1].
4990
5010
  #
4991
5011
  # The default option is the current Amazon Linux version. If you set
4992
5012
  # this parameter to `Custom`, you must use the AmiId parameter to
4993
5013
  # specify the custom AMI that you want to use. For more information
4994
- # about supported operating systems, see [Operating Systems][1]. For
4995
- # more information about how to use custom AMIs with OpsWorks, see
4996
- # [Using Custom AMIs][2].
5014
+ # about how to use custom AMIs with OpsWorks, see [Using Custom
5015
+ # AMIs][2].
4997
5016
  #
4998
5017
  # <note markdown="1"> You can specify a different Linux operating system for the updated
4999
5018
  # stack, but you cannot change from Linux to Windows or Windows to
@@ -5042,7 +5061,7 @@ module Aws::OpsWorks
5042
5061
  # This property cannot be updated.
5043
5062
  #
5044
5063
  # @option params [String] :agent_version
5045
- # The default AWS OpsWorks Stacks agent version. You have the following
5064
+ # The default OpsWorks Stacks agent version. You have the following
5046
5065
  # options:
5047
5066
  #
5048
5067
  # * `INHERIT` - Use the stack's default agent version setting.
@@ -5050,8 +5069,7 @@ module Aws::OpsWorks
5050
5069
  # * *version\_number* - Use the specified agent version. This value
5051
5070
  # overrides the stack's default setting. To update the agent version,
5052
5071
  # you must edit the instance configuration and specify a new version.
5053
- # AWS OpsWorks Stacks then automatically installs that version on the
5054
- # instance.
5072
+ # OpsWorks Stacks installs that version on the instance.
5055
5073
  #
5056
5074
  # The default setting is `INHERIT`. To specify an agent version, you
5057
5075
  # must use the complete version number, not the abbreviated number shown
@@ -5103,17 +5121,18 @@ module Aws::OpsWorks
5103
5121
  # The layer ID.
5104
5122
  #
5105
5123
  # @option params [String] :name
5106
- # The layer name, which is used by the console.
5124
+ # The layer name, which is used by the console. Layer names can be a
5125
+ # maximum of 32 characters.
5107
5126
  #
5108
5127
  # @option params [String] :shortname
5109
5128
  # For custom layers only, use this parameter to specify the layer's
5110
- # short name, which is used internally by AWS OpsWorks Stacks and by
5111
- # Chef. The short name is also used as the name for the directory where
5112
- # your app files are installed. It can have a maximum of 200 characters
5113
- # and must be in the following format: /\\A\[a-z0-9\\-\\\_\\.\]+\\Z/.
5129
+ # short name, which is used internally by OpsWorks Stacks and by Chef.
5130
+ # The short name is also used as the name for the directory where your
5131
+ # app files are installed. It can have a maximum of 32 characters and
5132
+ # must be in the following format: /\\A\[a-z0-9\\-\\\_\\.\]+\\Z/.
5114
5133
  #
5115
- # The built-in layers' short names are defined by AWS OpsWorks Stacks.
5116
- # For more information, see the [Layer Reference][1]
5134
+ # Built-in layer short names are defined by OpsWorks Stacks. For more
5135
+ # information, see the [Layer reference][1] in the OpsWorks User Guide.
5117
5136
  #
5118
5137
  #
5119
5138
  #
@@ -5357,7 +5376,7 @@ module Aws::OpsWorks
5357
5376
  # The stack ID.
5358
5377
  #
5359
5378
  # @option params [String] :name
5360
- # The stack's new name.
5379
+ # The stack's new name. Stack names can be a maximum of 64 characters.
5361
5380
  #
5362
5381
  # @option params [Hash<String,String>] :attributes
5363
5382
  # One or more user-defined key-value pairs to be added to the stack
@@ -5380,12 +5399,12 @@ module Aws::OpsWorks
5380
5399
  # following:
5381
5400
  #
5382
5401
  # * A supported Linux operating system: An Amazon Linux version, such as
5383
- # `Amazon Linux 2018.03`, `Amazon Linux 2017.09`, `Amazon Linux
5384
- # 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux 2016.03`, `Amazon
5385
- # Linux 2015.09`, or `Amazon Linux 2015.03`.
5402
+ # `Amazon Linux 2`, `Amazon Linux 2018.03`, `Amazon Linux 2017.09`,
5403
+ # `Amazon Linux 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux
5404
+ # 2016.03`, `Amazon Linux 2015.09`, or `Amazon Linux 2015.03`.
5386
5405
  #
5387
- # * A supported Ubuntu operating system, such as `Ubuntu 16.04 LTS`,
5388
- # `Ubuntu 14.04 LTS`, or `Ubuntu 12.04 LTS`.
5406
+ # * A supported Ubuntu operating system, such as `Ubuntu 18.04 LTS`,
5407
+ # `Ubuntu 16.04 LTS`, `Ubuntu 14.04 LTS`, or `Ubuntu 12.04 LTS`.
5389
5408
  #
5390
5409
  # * `CentOS Linux 7`
5391
5410
  #
@@ -5401,9 +5420,10 @@ module Aws::OpsWorks
5401
5420
  # when you create instances. For more information about how to use
5402
5421
  # custom AMIs with OpsWorks, see [Using Custom AMIs][1].
5403
5422
  #
5404
- # The default option is the stack's current operating system. For more
5405
- # information about supported operating systems, see [AWS OpsWorks
5406
- # Stacks Operating Systems][2].
5423
+ # The default option is the stack's current operating system. Not all
5424
+ # operating systems are supported with all versions of Chef. For more
5425
+ # information about supported operating systems, see [OpsWorks Stacks
5426
+ # Operating Systems][2].
5407
5427
  #
5408
5428
  #
5409
5429
  #
@@ -5505,9 +5525,9 @@ module Aws::OpsWorks
5505
5525
  #
5506
5526
  # @option params [String] :default_ssh_key_name
5507
5527
  # A default Amazon EC2 key-pair name. The default value is `none`. If
5508
- # you specify a key-pair name, AWS OpsWorks Stacks installs the public
5509
- # key on the instance and you can use the private key with an SSH client
5510
- # to log in to the instance. For more information, see [ Using SSH to
5528
+ # you specify a key-pair name, OpsWorks Stacks installs the public key
5529
+ # on the instance and you can use the private key with an SSH client to
5530
+ # log in to the instance. For more information, see [ Using SSH to
5511
5531
  # Communicate with an Instance][1] and [ Managing SSH Access][2]. You
5512
5532
  # can override this setting by specifying a different key pair, or no
5513
5533
  # key pair, when you [ create an instance][3].
@@ -5528,26 +5548,26 @@ module Aws::OpsWorks
5528
5548
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ComponentsAMIs.html#storage-for-the-root-device
5529
5549
  #
5530
5550
  # @option params [Boolean] :use_opsworks_security_groups
5531
- # Whether to associate the AWS OpsWorks Stacks built-in security groups
5532
- # with the stack's layers.
5551
+ # Whether to associate the OpsWorks Stacks built-in security groups with
5552
+ # the stack's layers.
5533
5553
  #
5534
- # AWS OpsWorks Stacks provides a standard set of built-in security
5535
- # groups, one for each layer, which are associated with layers by
5536
- # default. `UseOpsworksSecurityGroups` allows you to provide your own
5537
- # custom security groups instead of using the built-in groups.
5554
+ # OpsWorks Stacks provides a standard set of built-in security groups,
5555
+ # one for each layer, which are associated with layers by default.
5556
+ # `UseOpsworksSecurityGroups` allows you to provide your own custom
5557
+ # security groups instead of using the built-in groups.
5538
5558
  # `UseOpsworksSecurityGroups` has the following settings:
5539
5559
  #
5540
- # * True - AWS OpsWorks Stacks automatically associates the appropriate
5560
+ # * True - OpsWorks Stacks automatically associates the appropriate
5541
5561
  # built-in security group with each layer (default setting). You can
5542
5562
  # associate additional security groups with a layer after you create
5543
5563
  # it, but you cannot delete the built-in security group.
5544
5564
  #
5545
- # * False - AWS OpsWorks Stacks does not associate built-in security
5546
- # groups with layers. You must create appropriate EC2 security groups
5547
- # and associate a security group with each layer that you create.
5548
- # However, you can still manually associate a built-in security group
5549
- # with a layer on. Custom security groups are required only for those
5550
- # layers that need custom settings.
5565
+ # * False - OpsWorks Stacks does not associate built-in security groups
5566
+ # with layers. You must create appropriate EC2 security groups and
5567
+ # associate a security group with each layer that you create. However,
5568
+ # you can still manually associate a built-in security group with a
5569
+ # layer on. Custom security groups are required only for those layers
5570
+ # that need custom settings.
5551
5571
  #
5552
5572
  # For more information, see [Create a New Stack][1].
5553
5573
  #
@@ -5556,17 +5576,17 @@ module Aws::OpsWorks
5556
5576
  # [1]: https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-creating.html
5557
5577
  #
5558
5578
  # @option params [String] :agent_version
5559
- # The default AWS OpsWorks Stacks agent version. You have the following
5579
+ # The default OpsWorks Stacks agent version. You have the following
5560
5580
  # options:
5561
5581
  #
5562
- # * Auto-update - Set this parameter to `LATEST`. AWS OpsWorks Stacks
5582
+ # * Auto-update - Set this parameter to `LATEST`. OpsWorks Stacks
5563
5583
  # automatically installs new agent versions on the stack's instances
5564
5584
  # as soon as they are available.
5565
5585
  #
5566
5586
  # * Fixed version - Set this parameter to your preferred agent version.
5567
5587
  # To update the agent version, you must edit the stack configuration
5568
- # and specify a new version. AWS OpsWorks Stacks then automatically
5569
- # installs that version on the stack's instances.
5588
+ # and specify a new version. OpsWorks Stacks installs that version on
5589
+ # the stack's instances.
5570
5590
  #
5571
5591
  # The default setting is `LATEST`. To specify an agent version, you must
5572
5592
  # use the complete version number, not the abbreviated number shown on
@@ -5644,10 +5664,9 @@ module Aws::OpsWorks
5644
5664
  # @option params [String] :ssh_username
5645
5665
  # The user's SSH user name. The allowable characters are \[a-z\],
5646
5666
  # \[A-Z\], \[0-9\], '-', and '\_'. If the specified name includes
5647
- # other punctuation marks, AWS OpsWorks Stacks removes them. For
5648
- # example, `my.name` will be changed to `myname`. If you do not specify
5649
- # an SSH user name, AWS OpsWorks Stacks generates one from the IAM user
5650
- # name.
5667
+ # other punctuation marks, OpsWorks Stacks removes them. For example,
5668
+ # `my.name` will be changed to `myname`. If you do not specify an SSH
5669
+ # user name, OpsWorks Stacks generates one from the IAM user name.
5651
5670
  #
5652
5671
  # @option params [String] :ssh_public_key
5653
5672
  # The user's new SSH public key.
@@ -5698,7 +5717,7 @@ module Aws::OpsWorks
5698
5717
  # The volume ID.
5699
5718
  #
5700
5719
  # @option params [String] :name
5701
- # The new name.
5720
+ # The new name. Volume names can be a maximum of 128 characters.
5702
5721
  #
5703
5722
  # @option params [String] :mount_point
5704
5723
  # The new mount point.
@@ -5735,7 +5754,7 @@ module Aws::OpsWorks
5735
5754
  params: params,
5736
5755
  config: config)
5737
5756
  context[:gem_name] = 'aws-sdk-opsworks'
5738
- context[:gem_version] = '1.55.0'
5757
+ context[:gem_version] = '1.56.0'
5739
5758
  Seahorse::Client::Request.new(handlers, context)
5740
5759
  end
5741
5760