aws-sdk-opsworks 1.55.0 → 1.56.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-opsworks/client.rb +248 -229
- data/lib/aws-sdk-opsworks/client_api.rb +1 -0
- data/lib/aws-sdk-opsworks/endpoint_provider.rb +1 -1
- data/lib/aws-sdk-opsworks/layer.rb +9 -10
- data/lib/aws-sdk-opsworks/resource.rb +65 -60
- data/lib/aws-sdk-opsworks/stack.rb +16 -14
- data/lib/aws-sdk-opsworks/types.rb +346 -319
- data/lib/aws-sdk-opsworks.rb +1 -1
- metadata +2 -2
@@ -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
|
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
|
437
|
-
#
|
438
|
-
#
|
439
|
-
#
|
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
|
-
#
|
552
|
-
#
|
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 [
|
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
|
619
|
-
# information about
|
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,
|
638
|
-
# parameter. If you specify neither parameter,
|
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
|
651
|
-
#
|
652
|
-
#
|
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
|
665
|
-
#
|
666
|
-
# must set this parameter to the Amazon Resource Name (ARN)
|
667
|
-
# existing IAM role. If you create a stack by using the
|
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`,
|
699
|
-
# 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux
|
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
|
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.
|
719
|
-
#
|
720
|
-
#
|
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
|
819
|
-
#
|
820
|
+
# Whether to associate the OpsWorks Stacks built-in security groups with
|
821
|
+
# the stack's layers.
|
820
822
|
#
|
821
|
-
#
|
822
|
-
#
|
823
|
-
#
|
824
|
-
#
|
825
|
-
#
|
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 -
|
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 -
|
833
|
-
#
|
834
|
-
#
|
835
|
-
#
|
836
|
-
#
|
837
|
-
#
|
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,
|
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
|
889
|
+
# The default OpsWorks Stacks agent version. You have the following
|
889
890
|
# options:
|
890
891
|
#
|
891
|
-
# * Auto-update - Set this parameter to `LATEST`.
|
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.
|
898
|
-
#
|
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
|
-
#
|
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`,
|
1232
|
-
# 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux
|
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
|
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
|
-
#
|
1251
|
-
#
|
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
|
1258
|
-
#
|
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
|
1297
|
-
#
|
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
|
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.
|
1351
|
-
#
|
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
|
1464
|
-
#
|
1465
|
-
#
|
1466
|
-
#
|
1467
|
-
# '
|
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
|
-
#
|
1470
|
-
#
|
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
|
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
|
1659
|
-
# about Amazon
|
1660
|
-
#
|
1661
|
-
#
|
1662
|
-
# the `--stack-region` parameter
|
1663
|
-
# `--region`
|
1664
|
-
#
|
1665
|
-
#
|
1666
|
-
#
|
1667
|
-
#
|
1668
|
-
#
|
1669
|
-
# `us-west-1, us-west-2,
|
1670
|
-
#
|
1671
|
-
# actual API endpoint of the stack is
|
1672
|
-
#
|
1673
|
-
# endpoint. Because it is a best practice
|
1674
|
-
# endpoint that is closest to where you manage
|
1675
|
-
#
|
1676
|
-
# `--region` parameter always specifies a
|
1677
|
-
# cannot be used to specify a classic
|
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,
|
1698
|
-
# parameter. If you specify neither parameter,
|
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
|
1711
|
-
#
|
1712
|
-
#
|
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
|
1725
|
-
#
|
1726
|
-
#
|
1727
|
-
#
|
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`,
|
1750
|
-
# 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux
|
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
|
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.
|
1771
|
-
#
|
1772
|
-
#
|
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
|
1866
|
-
#
|
1872
|
+
# Whether to associate the OpsWorks Stacks built-in security groups with
|
1873
|
+
# the stack's layers.
|
1867
1874
|
#
|
1868
|
-
#
|
1869
|
-
#
|
1870
|
-
#
|
1871
|
-
#
|
1872
|
-
#
|
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 -
|
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 -
|
1880
|
-
#
|
1881
|
-
#
|
1882
|
-
#
|
1883
|
-
#
|
1884
|
-
#
|
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,
|
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
|
1935
|
+
# The default OpsWorks Stacks agent version. You have the following
|
1929
1936
|
# options:
|
1930
1937
|
#
|
1931
|
-
# * Auto-update - Set this parameter to `LATEST`.
|
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.
|
1938
|
-
#
|
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,
|
2025
|
-
#
|
2026
|
-
#
|
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
|
2275
|
-
# registered by another stack. For more
|
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
|
2309
|
-
#
|
2310
|
-
#
|
2311
|
-
#
|
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
|
2388
|
-
#
|
2389
|
-
#
|
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
|
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,
|
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
|
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
|
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,
|
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
|
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,
|
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
|
4117
|
-
#
|
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
|
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
|
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
|
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
|
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,
|
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,
|
4326
|
-
#
|
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
|
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
|
4581
|
-
#
|
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
|
4633
|
-
#
|
4634
|
-
#
|
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
|
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`,
|
4972
|
-
# 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux
|
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
|
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
|
-
#
|
4989
|
-
#
|
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
|
4995
|
-
#
|
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
|
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
|
-
#
|
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
|
5111
|
-
#
|
5112
|
-
#
|
5113
|
-
#
|
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
|
-
#
|
5116
|
-
#
|
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`,
|
5384
|
-
# 2017.03`, `Amazon Linux 2016.09`, `Amazon Linux
|
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
|
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.
|
5405
|
-
#
|
5406
|
-
#
|
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,
|
5509
|
-
#
|
5510
|
-
#
|
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
|
5532
|
-
#
|
5551
|
+
# Whether to associate the OpsWorks Stacks built-in security groups with
|
5552
|
+
# the stack's layers.
|
5533
5553
|
#
|
5534
|
-
#
|
5535
|
-
#
|
5536
|
-
#
|
5537
|
-
#
|
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 -
|
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 -
|
5546
|
-
#
|
5547
|
-
#
|
5548
|
-
#
|
5549
|
-
#
|
5550
|
-
#
|
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
|
5579
|
+
# The default OpsWorks Stacks agent version. You have the following
|
5560
5580
|
# options:
|
5561
5581
|
#
|
5562
|
-
# * Auto-update - Set this parameter to `LATEST`.
|
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.
|
5569
|
-
#
|
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,
|
5648
|
-
#
|
5649
|
-
#
|
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.
|
5757
|
+
context[:gem_version] = '1.56.0'
|
5739
5758
|
Seahorse::Client::Request.new(handlers, context)
|
5740
5759
|
end
|
5741
5760
|
|