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