amazonka-opsworks 1.4.3 → 1.4.4

raw patch · 17 files changed

+271/−42 lines, 17 filesdep ~amazonka-coredep ~amazonka-opsworksdep ~amazonka-testPVP: major bump suggested

API removals or changes: PVP suggests a major version bump

Dependency ranges changed: amazonka-core, amazonka-opsworks, amazonka-test

API changes (from Hackage documentation)

Files

• README.md +33/−5
• amazonka-opsworks.cabal +38/−10
• gen/Network/AWS/OpsWorks.hs +32/−4
• gen/Network/AWS/OpsWorks/AssignInstance.hs +2/−0
• gen/Network/AWS/OpsWorks/CloneStack.hs +26/−4
• gen/Network/AWS/OpsWorks/CreateInstance.hs +12/−3
• gen/Network/AWS/OpsWorks/CreateLayer.hs +1/−1
• gen/Network/AWS/OpsWorks/CreateStack.hs +25/−3
• gen/Network/AWS/OpsWorks/DeregisterEcsCluster.hs +1/−1
• gen/Network/AWS/OpsWorks/DescribePermissions.hs +3/−0
• gen/Network/AWS/OpsWorks/SetPermission.hs +4/−0
• gen/Network/AWS/OpsWorks/Types.hs +1/−1
• gen/Network/AWS/OpsWorks/Types/Product.hs +57/−3
• gen/Network/AWS/OpsWorks/Types/Sum.hs +3/−3
• gen/Network/AWS/OpsWorks/UpdateInstance.hs +11/−2
• gen/Network/AWS/OpsWorks/UpdateStack.hs +22/−2
• src/.gitkeep +0/−0

@@ -8,14 +8,14 @@  ## Version -`1.4.3`+`1.4.4`   ## Description  AWS OpsWorks -Welcome to the /AWS OpsWorks API Reference/. This guide provides descriptions, syntax, and usage examples about AWS OpsWorks actions and data types, including common parameters and error codes.+Welcome to the /AWS OpsWorks API Reference/. This guide provides descriptions, syntax, and usage examples for AWS OpsWorks actions and data types, including common parameters and error codes.  AWS OpsWorks is an application management service that provides an integrated experience for overseeing the complete application lifecycle. For information about this product, go to the <http://aws.amazon.com/opsworks/ AWS OpsWorks> details page. @@ -24,24 +24,52 @@ The most common way to use the AWS OpsWorks API is by using the AWS Command Line Interface (CLI) or by using one of the AWS SDKs to implement applications in your preferred language. For more information, see:  -   <http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html AWS CLI>+ -   <http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/opsworks/AWSOpsWorksClient.html AWS SDK for Java>+ -   <http://docs.aws.amazon.com/sdkfornet/latest/apidocs/html/N_Amazon_OpsWorks.htm AWS SDK for .NET>+ -   <http://docs.aws.amazon.com/aws-sdk-php-2/latest/class-Aws.OpsWorks.OpsWorksClient.html AWS SDK for PHP 2>--   <http://docs.aws.amazon.com/AWSRubySDK/latest/AWS/OpsWorks/Client.html AWS SDK for Ruby>++-   <http://docs.aws.amazon.com/sdkforruby/api/ AWS SDK for Ruby>+ -   <http://aws.amazon.com/documentation/sdkforjavascript/ AWS SDK for Node.js>+ -   <http://docs.pythonboto.org/en/latest/ref/opsworks.html AWS SDK for Python(Boto)>  __Endpoints__ -AWS OpsWorks supports only one endpoint, opsworks.us-east-1.amazonaws.com (HTTPS), so you must connect to that endpoint. You can then use the API to direct AWS OpsWorks to create stacks in any AWS Region.+AWS OpsWorks supports the following endpoints, all HTTPS. You must connect to one of the following endpoints. Stacks can only be accessed or managed within the endpoint in which they are created. +-   opsworks.us-east-1.amazonaws.com++-   opsworks.us-west-1.amazonaws.com++-   opsworks.us-west-2.amazonaws.com++-   opsworks.eu-west-1.amazonaws.com++-   opsworks.eu-central-1.amazonaws.com++-   opsworks.ap-northeast-1.amazonaws.com++-   opsworks.ap-northeast-2.amazonaws.com++-   opsworks.ap-south-1.amazonaws.com++-   opsworks.ap-southeast-1.amazonaws.com++-   opsworks.ap-southeast-2.amazonaws.com++-   opsworks.sa-east-1.amazonaws.com+ __Chef Versions__  When you call < CreateStack>, < CloneStack>, or < UpdateStack> we recommend you use the      @     ConfigurationManager     @-     parameter to specify the Chef version. The recommended value for Linux stacks is currently 12 (the default is 11.4). Windows stacks use Chef 12.2. For more information, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook-chef11.html Chef Versions>.+     parameter to specify the Chef version. The recommended and default value for Linux stacks is currently 12. Windows stacks use Chef 12.2. For more information, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook-chef11.html Chef Versions>.  You can specify Chef 12, 11.10, or 11.4 for your Linux stack. We recommend migrating your existing Linux stacks to Chef 12 as soon as possible. 

@@ -1,5 +1,5 @@ name:                  amazonka-opsworks-version:               1.4.3+version:               1.4.4 synopsis:              Amazon OpsWorks SDK. homepage:              https://github.com/brendanhay/amazonka bug-reports:           https://github.com/brendanhay/amazonka/issues@@ -11,11 +11,11 @@ category:              Network, AWS, Cloud, Distributed Computing build-type:            Simple cabal-version:         >= 1.10-extra-source-files:    README.md fixture/*.yaml fixture/*.proto+extra-source-files:    README.md fixture/*.yaml fixture/*.proto src/.gitkeep description:     AWS OpsWorks -    Welcome to the /AWS OpsWorks API Reference/. This guide provides descriptions, syntax, and usage examples about AWS OpsWorks actions and data types, including common parameters and error codes.+    Welcome to the /AWS OpsWorks API Reference/. This guide provides descriptions, syntax, and usage examples for AWS OpsWorks actions and data types, including common parameters and error codes.      AWS OpsWorks is an application management service that provides an integrated experience for overseeing the complete application lifecycle. For information about this product, go to the <http://aws.amazon.com/opsworks/ AWS OpsWorks> details page. @@ -24,24 +24,52 @@     The most common way to use the AWS OpsWorks API is by using the AWS Command Line Interface (CLI) or by using one of the AWS SDKs to implement applications in your preferred language. For more information, see:      -   <http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html AWS CLI>+     -   <http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/opsworks/AWSOpsWorksClient.html AWS SDK for Java>+     -   <http://docs.aws.amazon.com/sdkfornet/latest/apidocs/html/N_Amazon_OpsWorks.htm AWS SDK for .NET>+     -   <http://docs.aws.amazon.com/aws-sdk-php-2/latest/class-Aws.OpsWorks.OpsWorksClient.html AWS SDK for PHP 2>-    -   <http://docs.aws.amazon.com/AWSRubySDK/latest/AWS/OpsWorks/Client.html AWS SDK for Ruby>++    -   <http://docs.aws.amazon.com/sdkforruby/api/ AWS SDK for Ruby>+     -   <http://aws.amazon.com/documentation/sdkforjavascript/ AWS SDK for Node.js>+     -   <http://docs.pythonboto.org/en/latest/ref/opsworks.html AWS SDK for Python(Boto)>      __Endpoints__ -    AWS OpsWorks supports only one endpoint, opsworks.us-east-1.amazonaws.com (HTTPS), so you must connect to that endpoint. You can then use the API to direct AWS OpsWorks to create stacks in any AWS Region.+    AWS OpsWorks supports the following endpoints, all HTTPS. You must connect to one of the following endpoints. Stacks can only be accessed or managed within the endpoint in which they are created. +    -   opsworks.us-east-1.amazonaws.com++    -   opsworks.us-west-1.amazonaws.com++    -   opsworks.us-west-2.amazonaws.com++    -   opsworks.eu-west-1.amazonaws.com++    -   opsworks.eu-central-1.amazonaws.com++    -   opsworks.ap-northeast-1.amazonaws.com++    -   opsworks.ap-northeast-2.amazonaws.com++    -   opsworks.ap-south-1.amazonaws.com++    -   opsworks.ap-southeast-1.amazonaws.com++    -   opsworks.ap-southeast-2.amazonaws.com++    -   opsworks.sa-east-1.amazonaws.com+     __Chef Versions__      When you call < CreateStack>, < CloneStack>, or < UpdateStack> we recommend you use the      @     ConfigurationManager     @-     parameter to specify the Chef version. The recommended value for Linux stacks is currently 12 (the default is 11.4). Windows stacks use Chef 12.2. For more information, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook-chef11.html Chef Versions>.+     parameter to specify the Chef version. The recommended and default value for Linux stacks is currently 12. Windows stacks use Chef 12.2. For more information, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook-chef11.html Chef Versions>.      You can specify Chef 12, 11.10, or 11.4 for your Linux stack. We recommend migrating your existing Linux stacks to Chef 12 as soon as possible.     .@@ -149,7 +177,7 @@         , Network.AWS.OpsWorks.Types.Sum      build-depends:-          amazonka-core == 1.4.3.*+          amazonka-core == 1.4.4.*         , base          >= 4.7     && < 5  test-suite amazonka-opsworks-test@@ -169,9 +197,9 @@         , Test.AWS.OpsWorks.Internal      build-depends:-          amazonka-core == 1.4.3.*-        , amazonka-test == 1.4.3.*-        , amazonka-opsworks == 1.4.3.*+          amazonka-core == 1.4.4.*+        , amazonka-test == 1.4.4.*+        , amazonka-opsworks == 1.4.4.*         , base         , bytestring         , tasty

@@ -13,7 +13,7 @@ -- -- AWS OpsWorks ----- Welcome to the /AWS OpsWorks API Reference/. This guide provides descriptions, syntax, and usage examples about AWS OpsWorks actions and data types, including common parameters and error codes.+-- Welcome to the /AWS OpsWorks API Reference/. This guide provides descriptions, syntax, and usage examples for AWS OpsWorks actions and data types, including common parameters and error codes. -- -- AWS OpsWorks is an application management service that provides an integrated experience for overseeing the complete application lifecycle. For information about this product, go to the <http://aws.amazon.com/opsworks/ AWS OpsWorks> details page. --@@ -22,20 +22,48 @@ -- The most common way to use the AWS OpsWorks API is by using the AWS Command Line Interface (CLI) or by using one of the AWS SDKs to implement applications in your preferred language. For more information, see: -- -- -   <http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html AWS CLI>+-- -- -   <http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/opsworks/AWSOpsWorksClient.html AWS SDK for Java>+-- -- -   <http://docs.aws.amazon.com/sdkfornet/latest/apidocs/html/N_Amazon_OpsWorks.htm AWS SDK for .NET>+-- -- -   <http://docs.aws.amazon.com/aws-sdk-php-2/latest/class-Aws.OpsWorks.OpsWorksClient.html AWS SDK for PHP 2>--- -   <http://docs.aws.amazon.com/AWSRubySDK/latest/AWS/OpsWorks/Client.html AWS SDK for Ruby>+--+-- -   <http://docs.aws.amazon.com/sdkforruby/api/ AWS SDK for Ruby>+-- -- -   <http://aws.amazon.com/documentation/sdkforjavascript/ AWS SDK for Node.js>+-- -- -   <http://docs.pythonboto.org/en/latest/ref/opsworks.html AWS SDK for Python(Boto)> -- -- __Endpoints__ ----- AWS OpsWorks supports only one endpoint, opsworks.us-east-1.amazonaws.com (HTTPS), so you must connect to that endpoint. You can then use the API to direct AWS OpsWorks to create stacks in any AWS Region.+-- AWS OpsWorks supports the following endpoints, all HTTPS. You must connect to one of the following endpoints. Stacks can only be accessed or managed within the endpoint in which they are created. --+-- -   opsworks.us-east-1.amazonaws.com+--+-- -   opsworks.us-west-1.amazonaws.com+--+-- -   opsworks.us-west-2.amazonaws.com+--+-- -   opsworks.eu-west-1.amazonaws.com+--+-- -   opsworks.eu-central-1.amazonaws.com+--+-- -   opsworks.ap-northeast-1.amazonaws.com+--+-- -   opsworks.ap-northeast-2.amazonaws.com+--+-- -   opsworks.ap-south-1.amazonaws.com+--+-- -   opsworks.ap-southeast-1.amazonaws.com+--+-- -   opsworks.ap-southeast-2.amazonaws.com+--+-- -   opsworks.sa-east-1.amazonaws.com+-- -- __Chef Versions__ ----- When you call < CreateStack>, < CloneStack>, or < UpdateStack> we recommend you use the 'ConfigurationManager' parameter to specify the Chef version. The recommended value for Linux stacks is currently 12 (the default is 11.4). Windows stacks use Chef 12.2. For more information, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook-chef11.html Chef Versions>.+-- When you call < CreateStack>, < CloneStack>, or < UpdateStack> we recommend you use the 'ConfigurationManager' parameter to specify the Chef version. The recommended and default value for Linux stacks is currently 12. Windows stacks use Chef 12.2. For more information, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook-chef11.html Chef Versions>. -- -- You can specify Chef 12, 11.10, or 11.4 for your Linux stack. We recommend migrating your existing Linux stacks to Chef 12 as soon as possible. module Network.AWS.OpsWorks

@@ -21,7 +21,9 @@ -- Assign a registered instance to a layer. -- -- -   You can assign registered on-premises instances to any layer type.+-- -- -   You can assign registered Amazon EC2 instances only to custom layers.+-- -- -   You cannot use this action with instances that were created with AWS OpsWorks. -- -- __Required Permissions__: To use this action, an AWS Identity and Access Management (IAM) user must have a Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information on user permissions, see <http://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html Managing User Permissions>.

@@ -183,6 +183,7 @@ -- | The ID of the VPC that the cloned stack is to be launched into. It must be in the specified region. All instances are launched into this VPC, and you cannot change the ID later. -- -- -   If your account supports EC2 Classic, the default value is no VPC.+-- -- -   If your account does not support EC2 Classic, the default value is the default VPC for the specified region. -- -- If the VPC ID corresponds to a default VPC and you have specified either the 'DefaultAvailabilityZone' or the 'DefaultSubnetId' parameter only, AWS OpsWorks infers the value of the other parameter. If you specify neither parameter, AWS OpsWorks sets these parameters to the first valid Availability Zone for the specified region and the corresponding default VPC subnet ID, respectively.@@ -190,6 +191,7 @@ -- If you specify a nondefault VPC ID, note the following: -- -- -   It must belong to a VPC in your account that is in the specified region.+-- -- -   You must specify a value for 'DefaultSubnetId'. -- -- For more information on how to use AWS OpsWorks with a VPC, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-vpc.html Running a Stack in a VPC>. For more information on default VPC and EC2 Classic, see <http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-supported-platforms.html Supported Platforms>.@@ -203,6 +205,7 @@ -- | The default AWS OpsWorks agent version. You have the following options: -- -- -   Auto-update - Set this parameter to 'LATEST'. AWS OpsWorks automatically installs new agent versions on the stack\'s instances as soon as they are available.+-- -- -   Fixed version - Set this parameter to your preferred agent version. To update the agent version, you must edit the stack configuration and specify a new version. AWS OpsWorks then automatically installs that version on the stack\'s instances. -- -- The default setting is 'LATEST'. To specify an agent version, you must use the complete version number, not the abbreviated number shown on the console. For a list of available agent version numbers, call < DescribeAgentVersions>.@@ -245,8 +248,16 @@  -- | The stack\'s operating system, which must be set to one of the following. ----- -   A supported Linux operating system: An Amazon Linux version, such as 'Amazon Linux 2015.03', 'Red Hat Enterprise Linux 7', 'Ubuntu 12.04 LTS', or 'Ubuntu 14.04 LTS'.--- -   'Microsoft Windows Server 2012 R2 Base'.+-- -   A supported Linux operating system: An Amazon Linux version, such as 'Amazon Linux 2016.03', 'Amazon Linux 2015.09', or 'Amazon Linux 2015.03'.+--+-- -   A supported Ubuntu operating system, such as 'Ubuntu 16.04 LTS', 'Ubuntu 14.04 LTS', or 'Ubuntu 12.04 LTS'.+--+-- -   'CentOS 7'+--+-- -   'Red Hat Enterprise Linux 7'+--+-- -   'Microsoft Windows Server 2012 R2 Base', 'Microsoft Windows Server 2012 R2 with SQL Server Express', 'Microsoft Windows Server 2012 R2 with SQL Server Standard', or 'Microsoft Windows Server 2012 R2 with SQL Server Web'.+-- -- -   A custom AMI: 'Custom'. You specify the custom AMI you want to use when you create instances. For more information on how to use custom AMIs with OpsWorks, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-custom-ami.html Using Custom AMIs>. -- -- The default option is the parent stack\'s operating system. For more information on the supported operating systems, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-os.html AWS OpsWorks Operating Systems>.@@ -260,6 +271,7 @@ -- AWS OpsWorks provides a standard set of built-in security groups, one for each layer, which are associated with layers by default. With 'UseOpsworksSecurityGroups' you can instead provide your own custom security groups. 'UseOpsworksSecurityGroups' has the following settings: -- -- -   True - AWS OpsWorks automatically associates the appropriate built-in security group with each layer (default setting). You can associate additional security groups with a layer after you create it but you cannot delete the built-in security group.+-- -- -   False - AWS OpsWorks does not associate built-in security groups with layers. You must create appropriate Amazon Elastic Compute Cloud (Amazon EC2) security groups and associate a security group with each layer that you create. However, you can still manually associate a built-in security group with a layer on creation; custom security groups are required only for those layers that need custom settings. -- -- For more information, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-creating.html Create a New Stack>.@@ -274,26 +286,36 @@ cDefaultSubnetId :: Lens' CloneStack (Maybe Text) cDefaultSubnetId = lens _cDefaultSubnetId (\ s a -> s{_cDefaultSubnetId = a}); --- | The cloned stack AWS region, such as \"us-east-1\". For more information about AWS regions, see <http://docs.aws.amazon.com/general/latest/gr/rande.html Regions and Endpoints>.+-- | The cloned stack AWS region, such as \"ap-northeast-2\". For more information about AWS regions, see <http://docs.aws.amazon.com/general/latest/gr/rande.html Regions and Endpoints>. cRegion :: Lens' CloneStack (Maybe Text) cRegion = lens _cRegion (\ s a -> s{_cRegion = a}); --- | The configuration manager. When you clone a stack we recommend that you use the configuration manager to specify the Chef version: 12, 11.10, or 11.4 for Linux stacks, or 12.2 for Windows stacks. The default value for Linux stacks is currently 11.4.+-- | The configuration manager. When you clone a stack we recommend that you use the configuration manager to specify the Chef version: 12, 11.10, or 11.4 for Linux stacks, or 12.2 for Windows stacks. The default value for Linux stacks is currently 12. cConfigurationManager :: Lens' CloneStack (Maybe StackConfigurationManager) cConfigurationManager = lens _cConfigurationManager (\ s a -> s{_cConfigurationManager = a});  -- | The stack\'s host name theme, with spaces are replaced by underscores. The theme is used to generate host names for the stack\'s instances. By default, 'HostnameTheme' is set to 'Layer_Dependent', which creates host names by appending integers to the layer\'s short name. The other themes are: -- -- -   'Baked_Goods'+-- -- -   'Clouds'+-- -- -   'Europe_Cities'+-- -- -   'Fruits'+-- -- -   'Greek_Deities'+-- -- -   'Legendary_creatures_from_Japan'+-- -- -   'Planets_and_Moons'+-- -- -   'Roman_Deities'+-- -- -   'Scottish_Islands'+-- -- -   'US_Cities'+-- -- -   'Wild_Cats' -- -- To obtain a generated host name, call 'GetHostNameSuggestion', which returns a host name based on the current theme.

@@ -169,6 +169,7 @@ -- | The default AWS OpsWorks agent version. You have the following options: -- -- -   'INHERIT' - Use the stack\'s default agent version setting.+-- -- -   /version_number/ - Use the specified agent version. This value overrides the stack\'s default setting. To update the agent version, edit the instance configuration and specify a new version. AWS OpsWorks then automatically installs that version on the instance. -- -- The default setting is 'INHERIT'. To specify an agent version, you must use the complete version number, not the abbreviated number shown on the console. For a list of available agent version numbers, call < DescribeAgentVersions>.@@ -185,8 +186,16 @@  -- | The instance\'s operating system, which must be set to one of the following. ----- -   A supported Linux operating system: An Amazon Linux version, such as 'Amazon Linux 2015.03', 'Red Hat Enterprise Linux 7', 'Ubuntu 12.04 LTS', or 'Ubuntu 14.04 LTS'.--- -   'Microsoft Windows Server 2012 R2 Base'.+-- -   A supported Linux operating system: An Amazon Linux version, such as 'Amazon Linux 2016.03', 'Amazon Linux 2015.09', or 'Amazon Linux 2015.03'.+--+-- -   A supported Ubuntu operating system, such as 'Ubuntu 16.04 LTS', 'Ubuntu 14.04 LTS', or 'Ubuntu 12.04 LTS'.+--+-- -   'CentOS 7'+--+-- -   'Red Hat Enterprise Linux 7'+--+-- -   A supported Windows operating system, such as 'Microsoft Windows Server 2012 R2 Base', 'Microsoft Windows Server 2012 R2 with SQL Server Express', 'Microsoft Windows Server 2012 R2 with SQL Server Standard', or 'Microsoft Windows Server 2012 R2 with SQL Server Web'.+-- -- -   A custom AMI: 'Custom'. -- -- For more information on the supported operating systems, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-os.html AWS OpsWorks Operating Systems>.@@ -199,7 +208,7 @@ ciAvailabilityZone :: Lens' CreateInstance (Maybe Text) ciAvailabilityZone = lens _ciAvailabilityZone (\ s a -> s{_ciAvailabilityZone = a}); --- | The instance\'s tenancy option. The default option is no tenancy, or if the instance is running in a VPC, inherit tenancy settings from the VPC. The following are valid values for this parameter: 'dedicated', 'default', or 'host'. Because there are costs associated with changes in tenancy options, we recommend that you research tenancy options before choosing them for your instances. For more information about dedicated hosts, see <https://aws.amazon.com/ec2/dedicated-hosts/ Dedicated Hosts Overview> and <https://aws.amazon.com/ec2/dedicated-hosts/ Amazon EC2 Dedicated Hosts>. For more information about dedicated instances, see <http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/dedicated-instance.html Dedicated Instances> and <https://aws.amazon.com/ec2/purchasing-options/dedicated-instances/ Amazon EC2 Dedicated Instances>.+-- | The instance\'s tenancy option. The default option is no tenancy, or if the instance is running in a VPC, inherit tenancy settings from the VPC. The following are valid values for this parameter: 'dedicated', 'default', or 'host'. Because there are costs associated with changes in tenancy options, we recommend that you research tenancy options before choosing them for your instances. For more information about dedicated hosts, see <http://aws.amazon.com/ec2/dedicated-hosts/ Dedicated Hosts Overview> and <http://aws.amazon.com/ec2/dedicated-hosts/ Amazon EC2 Dedicated Hosts>. For more information about dedicated instances, see <http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/dedicated-instance.html Dedicated Instances> and <http://aws.amazon.com/ec2/purchasing-options/dedicated-instances/ Amazon EC2 Dedicated Instances>. ciTenancy :: Lens' CreateInstance (Maybe Text) ciTenancy = lens _ciTenancy (\ s a -> s{_ciTenancy = a}); 

@@ -207,7 +207,7 @@ clStackId :: Lens' CreateLayer Text clStackId = lens _clStackId (\ s a -> s{_clStackId = a}); --- | The layer type. A stack cannot have more than one built-in layer of the same type. It can have any number of custom layers.+-- | The layer type. A stack cannot have more than one built-in layer of the same type. It can have any number of custom layers. Built-in layers are not available in Chef 12 stacks. clType :: Lens' CreateLayer LayerType clType = lens _clType (\ s a -> s{_clType = a}); 

@@ -162,6 +162,7 @@ -- | The ID of the VPC that the stack is to be launched into. The VPC must be in the stack\'s region. All instances are launched into this VPC. You cannot change the ID later. -- -- -   If your account supports EC2-Classic, the default value is 'no VPC'.+-- -- -   If your account does not support EC2-Classic, the default value is the default VPC for the specified region. -- -- If the VPC ID corresponds to a default VPC and you have specified either the 'DefaultAvailabilityZone' or the 'DefaultSubnetId' parameter only, AWS OpsWorks infers the value of the other parameter. If you specify neither parameter, AWS OpsWorks sets these parameters to the first valid Availability Zone for the specified region and the corresponding default VPC subnet ID, respectively.@@ -169,6 +170,7 @@ -- If you specify a nondefault VPC ID, note the following: -- -- -   It must belong to a VPC in your account that is in the specified region.+-- -- -   You must specify a value for 'DefaultSubnetId'. -- -- For more information on how to use AWS OpsWorks with a VPC, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-vpc.html Running a Stack in a VPC>. For more information on default VPC and EC2-Classic, see <http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-supported-platforms.html Supported Platforms>.@@ -182,6 +184,7 @@ -- | The default AWS OpsWorks agent version. You have the following options: -- -- -   Auto-update - Set this parameter to 'LATEST'. AWS OpsWorks automatically installs new agent versions on the stack\'s instances as soon as they are available.+-- -- -   Fixed version - Set this parameter to your preferred agent version. To update the agent version, you must edit the stack configuration and specify a new version. AWS OpsWorks then automatically installs that version on the stack\'s instances. -- -- The default setting is the most recent release of the agent. To specify an agent version, you must use the complete version number, not the abbreviated number shown on the console. For a list of available agent version numbers, call < DescribeAgentVersions>.@@ -216,8 +219,16 @@  -- | The stack\'s default operating system, which is installed on every instance unless you specify a different operating system when you create the instance. You can specify one of the following. ----- -   A supported Linux operating system: An Amazon Linux version, such as 'Amazon Linux 2015.03', 'Red Hat Enterprise Linux 7', 'Ubuntu 12.04 LTS', or 'Ubuntu 14.04 LTS'.--- -   'Microsoft Windows Server 2012 R2 Base'.+-- -   A supported Linux operating system: An Amazon Linux version, such as 'Amazon Linux 2016.03', 'Amazon Linux 2015.09', or 'Amazon Linux 2015.03'.+--+-- -   A supported Ubuntu operating system, such as 'Ubuntu 16.04 LTS', 'Ubuntu 14.04 LTS', or 'Ubuntu 12.04 LTS'.+--+-- -   'CentOS 7'+--+-- -   'Red Hat Enterprise Linux 7'+--+-- -   A supported Windows operating system, such as 'Microsoft Windows Server 2012 R2 Base', 'Microsoft Windows Server 2012 R2 with SQL Server Express', 'Microsoft Windows Server 2012 R2 with SQL Server Standard', or 'Microsoft Windows Server 2012 R2 with SQL Server Web'.+-- -- -   A custom AMI: 'Custom'. You specify the custom AMI you want to use when you create instances. For more information, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-custom-ami.html Using Custom AMIs>. -- -- The default option is the current Amazon Linux version. For more information on the supported operating systems, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-os.html AWS OpsWorks Operating Systems>.@@ -229,6 +240,7 @@ -- AWS OpsWorks provides a standard set of built-in security groups, one for each layer, which are associated with layers by default. With 'UseOpsworksSecurityGroups' you can instead provide your own custom security groups. 'UseOpsworksSecurityGroups' has the following settings: -- -- -   True - AWS OpsWorks automatically associates the appropriate built-in security group with each layer (default setting). You can associate additional security groups with a layer after you create it, but you cannot delete the built-in security group.+-- -- -   False - AWS OpsWorks does not associate built-in security groups with layers. You must create appropriate EC2 security groups and associate a security group with each layer that you create. However, you can still manually associate a built-in security group with a layer on creation; custom security groups are required only for those layers that need custom settings. -- -- For more information, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-creating.html Create a New Stack>.@@ -250,15 +262,25 @@ -- | The stack\'s host name theme, with spaces replaced by underscores. The theme is used to generate host names for the stack\'s instances. By default, 'HostnameTheme' is set to 'Layer_Dependent', which creates host names by appending integers to the layer\'s short name. The other themes are: -- -- -   'Baked_Goods'+-- -- -   'Clouds'+-- -- -   'Europe_Cities'+-- -- -   'Fruits'+-- -- -   'Greek_Deities'+-- -- -   'Legendary_creatures_from_Japan'+-- -- -   'Planets_and_Moons'+-- -- -   'Roman_Deities'+-- -- -   'Scottish_Islands'+-- -- -   'US_Cities'+-- -- -   'Wild_Cats' -- -- To obtain a generated host name, call 'GetHostNameSuggestion', which returns a host name based on the current theme.@@ -269,7 +291,7 @@ csName :: Lens' CreateStack Text csName = lens _csName (\ s a -> s{_csName = a}); --- | The stack\'s AWS region, such as \"us-east-1\". For more information about Amazon regions, see <http://docs.aws.amazon.com/general/latest/gr/rande.html Regions and Endpoints>.+-- | The stack\'s AWS region, such as \"ap-south-1\". For more information about Amazon regions, see <http://docs.aws.amazon.com/general/latest/gr/rande.html Regions and Endpoints>. csRegion :: Lens' CreateStack Text csRegion = lens _csRegion (\ s a -> s{_csRegion = a}); 

@@ -20,7 +20,7 @@ -- -- Deregisters a specified Amazon ECS cluster from a stack. For more information, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workinglayers-ecscluster.html#workinglayers-ecscluster-delete Resource Management>. ----- __Required Permissions__: To use this action, an IAM user must have a Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information on user permissions, see <http://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html >.+-- __Required Permissions__: To use this action, an IAM user must have a Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information on user permissions, see <http://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html>. module Network.AWS.OpsWorks.DeregisterEcsCluster     (     -- * Creating a Request

@@ -139,8 +139,11 @@ -- | An array of 'Permission' objects that describe the stack permissions. -- -- -   If the request object contains only a stack ID, the array contains a 'Permission' object with permissions for each of the stack IAM ARNs.+-- -- -   If the request object contains only an IAM ARN, the array contains a 'Permission' object with permissions for each of the user\'s stack IDs.+-- -- -   If the request contains a stack ID and an IAM ARN, the array contains a single 'Permission' object with permissions for the specified stack and IAM ARN.+-- dprsPermissions :: Lens' DescribePermissionsResponse [Permission] dprsPermissions = lens _dprsPermissions (\ s a -> s{_dprsPermissions = a}) . _Default . _Coerce; 

@@ -87,9 +87,13 @@ -- | The user\'s permission level, which must be set to one of the following strings. You cannot set your own permissions level. -- -- -   'deny'+-- -- -   'show'+-- -- -   'deploy'+-- -- -   'manage'+-- -- -   'iam_only' -- -- For more information on the permissions associated with these levels, see <http://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html Managing User Permissions>.

@@ -544,7 +544,7 @@       | has (hasStatus 509) e = Just "limit_exceeded"       | otherwise = Nothing --- | Indicates that a request was invalid.+-- | Indicates that a request was not valid. _ValidationException :: AsError a => Getting (First ServiceError) a ServiceError _ValidationException = _ServiceError . hasCode "ValidationException" 

@@ -140,7 +140,7 @@  -- | An array of 'EnvironmentVariable' objects that specify environment variables to be associated with the app. After you deploy the app, these variables are defined on the associated app server instances. For more information, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingapps-creating.html#workingapps-creating-environment Environment Variables>. ----- There is no specific limit on the number of environment variables. However, the size of the associated data structure - which includes the variables\' names, values, and protected flag values - cannot exceed 10 KB (10240 Bytes). This limit should accommodate most if not all use cases, but if you do exceed it, you will cause an exception (API) with an \"Environment: is too large (maximum is 10KB)\" message.+-- There is no specific limit on the number of environment variables. However, the size of the associated data structure - which includes the variable names, values, and protected flag values - cannot exceed 10 KB (10240 Bytes). This limit should accommodate most if not all use cases, but if you do exceed it, you will cause an exception (API) with an \"Environment: is too large (maximum is 10KB)\" message. appEnvironment :: Lens' App [EnvironmentVariable] appEnvironment = lens _appEnvironment (\ s a -> s{_appEnvironment = a}) . _Default . _Coerce; @@ -503,9 +503,13 @@ -- | The command status: -- -- -   failed+-- -- -   successful+-- -- -   skipped+-- -- -   pending+-- cStatus :: Lens' Command (Maybe Text) cStatus = lens _cStatus (\ s a -> s{_cStatus = a}); @@ -528,15 +532,25 @@ -- | The command type: -- -- -   'deploy'+-- -- -   'rollback'+-- -- -   'start'+-- -- -   'stop'+-- -- -   'restart'+-- -- -   'undeploy'+-- -- -   'update_dependencies'+-- -- -   'install_dependencies'+-- -- -   'update_custom_cookbooks'+-- -- -   'execute_recipes'+-- cType :: Lens' Command (Maybe Text) cType = lens _cType (\ s a -> s{_cType = a}); @@ -696,8 +710,11 @@ -- | The deployment status: -- -- -   running+-- -- -   successful+-- -- -   failed+-- dStatus :: Lens' Deployment (Maybe Text) dStatus = lens _dStatus (\ s a -> s{_dStatus = a}); @@ -797,6 +814,7 @@ -- The 'update_dependencies' command takes two arguments: -- -- -   'upgrade_os_to' - Specifies the desired Amazon Linux version for instances whose OS you want to upgrade, such as 'Amazon Linux 2014.09'. You must also set the 'allow_reboot' argument to true.+-- -- -   'allow_reboot' - Specifies whether to allow AWS OpsWorks to reboot the instances if necessary, after installing the updates. This argument can be set to either 'true' or 'false'. The default value is 'false'. -- -- For example, to upgrade an instance to Amazon Linux 2014.09, set 'Args' to the following.@@ -810,8 +828,11 @@ -- For stacks, the following commands are available: -- -- -   'execute_recipes': Execute one or more recipes. To specify the recipes, set an 'Args' parameter named 'recipes' to the list of recipes to be executed. For example, to execute 'phpapp::appsetup', set 'Args' to '{\"recipes\":[\"phpapp::appsetup\"]}'.+-- -- -   'install_dependencies': Install the stack\'s dependencies.+-- -- -   'update_custom_cookbooks': Update the stack\'s custom cookbooks.+-- -- -   'update_dependencies': Update the stack\'s dependencies. -- -- The update_dependencies and install_dependencies commands are supported only for Linux instances. You can run the commands successfully on Windows instances, but they do nothing.@@ -819,11 +840,17 @@ -- For apps, the following commands are available: -- -- -   'deploy': Deploy an app. Ruby on Rails apps have an optional 'Args' parameter named 'migrate'. Set 'Args' to {\"migrate\":[\"true\"]} to migrate the database. The default setting is {\"migrate\":[\"false\"]}.+-- -- -   'rollback' Roll the app back to the previous version. When you update an app, AWS OpsWorks stores the previous version, up to a maximum of five versions. You can use this command to roll an app back as many as four versions.+-- -- -   'start': Start the app\'s web or application server.+-- -- -   'stop': Stop the app\'s web or application server.+-- -- -   'restart': Restart the app\'s web or application server.+-- -- -   'undeploy': Undeploy the app.+-- dcName :: Lens' DeploymentCommand DeploymentCommandName dcName = lens _dcName (\ s a -> s{_dcName = a}); @@ -1408,19 +1435,35 @@ -- | The instance status: -- -- -   'booting'+-- -- -   'connection_lost'+-- -- -   'online'+-- -- -   'pending'+-- -- -   'rebooting'+-- -- -   'requested'+-- -- -   'running_setup'+-- -- -   'setup_failed'+-- -- -   'shutting_down'+-- -- -   'start_failed'+--+-- -   'stop_failed'+-- -- -   'stopped'+-- -- -   'stopping'+-- -- -   'terminated'+-- -- -   'terminating'+-- iStatus :: Lens' Instance (Maybe Text) iStatus = lens _iStatus (\ s a -> s{_iStatus = a}); @@ -2226,9 +2269,13 @@ -- | The user\'s permission level, which must be the following: -- -- -   'deny'+-- -- -   'show'+-- -- -   'deploy'+-- -- -   'manage'+-- -- -   'iam_only' -- -- For more information on the permissions associated with these levels, see <http://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html Managing User Permissions>@@ -2928,7 +2975,9 @@ -- | This parameter depends on the repository type. -- -- -   For Amazon S3 bundles, set 'Username' to the appropriate IAM access key ID.+-- -- -   For HTTP bundles, Git repositories, and Subversion repositories, set 'Username' to the user name.+-- sUsername :: Lens' Source (Maybe Text) sUsername = lens _sUsername (\ s a -> s{_sUsername = a}); @@ -2941,9 +2990,10 @@ -- | When included in a request, the parameter depends on the repository type. -- -- -   For Amazon S3 bundles, set 'Password' to the appropriate IAM secret access key.+-- -- -   For HTTP bundles and Subversion repositories, set 'Password' to the password. ----- For more information on how to safely handle IAM credentials, see <http://docs.aws.amazon.com/general/latest/gr/aws-access-keys-best-practices.html >.+-- For more information on how to safely handle IAM credentials, see <http://docs.aws.amazon.com/general/latest/gr/aws-access-keys-best-practices.html>. -- -- In responses, AWS OpsWorks returns '*****FILTERED*****' instead of the actual value. sPassword :: Lens' Source (Maybe Text)@@ -3162,7 +3212,7 @@ sDefaultSubnetId :: Lens' Stack (Maybe Text) sDefaultSubnetId = lens _sDefaultSubnetId (\ s a -> s{_sDefaultSubnetId = a}); --- | The stack AWS region, such as \"us-east-1\". For more information about AWS regions, see <http://docs.aws.amazon.com/general/latest/gr/rande.html Regions and Endpoints>.+-- | The stack AWS region, such as \"ap-northeast-2\". For more information about AWS regions, see <http://docs.aws.amazon.com/general/latest/gr/rande.html Regions and Endpoints>. sRegion :: Lens' Stack (Maybe Text) sRegion = lens _sRegion (\ s a -> s{_sRegion = a}); @@ -3705,8 +3755,11 @@ -- | The volume type: -- -- -   'standard' - Magnetic+-- -- -   'io1' - Provisioned IOPS (SSD)+-- -- -   'gp2' - General Purpose (SSD)+-- vcVolumeType :: Lens' VolumeConfiguration (Maybe Text) vcVolumeType = lens _vcVolumeType (\ s a -> s{_vcVolumeType = a}); @@ -3751,6 +3804,7 @@ -- | Describes a time-based instance\'s auto scaling schedule. The schedule consists of a set of key-value pairs. -- -- -   The key is the time period (a UTC hour) and must be an integer from 0 - 23.+-- -- -   The value indicates whether the instance should be online or offline for the specified period, and must be set to \"on\" or \"off\" -- -- The default setting for all time periods is off, so you use the following parameters primarily to specify the online periods. You don\'t have to explicitly specify offline periods unless you want to change an online period to an offline period.

@@ -33,7 +33,7 @@         "documentroot" -> pure DocumentRoot         "railsenv" -> pure RailsEnv         e -> fromTextError $ "Failure parsing AppAttributesKeys from value: '" <> e-           <> "'. Accepted values: AwsFlowRubySettings, AutoBundleOnDeploy, DocumentRoot, RailsEnv"+           <> "'. Accepted values: awsflowrubysettings, autobundleondeploy, documentroot, railsenv"  instance ToText AppAttributesKeys where     toText = \case@@ -271,7 +271,7 @@         "rubyversion" -> pure RubyVersion         "rubygemsversion" -> pure RubygemsVersion         e -> fromTextError $ "Failure parsing LayerAttributesKeys from value: '" <> e-           <> "'. Accepted values: BundlerVersion, EcsClusterArn, EnableHaproxyStats, GangliaPassword, GangliaUrl, GangliaUser, HaproxyHealthCheckMethod, HaproxyHealthCheckUrl, HaproxyStatsPassword, HaproxyStatsUrl, HaproxyStatsUser, Jvm, JvmOptions, JvmVersion, JavaAppServer, JavaAppServerVersion, ManageBundler, MemcachedMemory, MysqlRootPassword, MysqlRootPasswordUbiquitous, NodejsVersion, PassengerVersion, RailsStack, RubyVersion, RubygemsVersion"+           <> "'. Accepted values: bundlerversion, ecsclusterarn, enablehaproxystats, gangliapassword, gangliaurl, gangliauser, haproxyhealthcheckmethod, haproxyhealthcheckurl, haproxystatspassword, haproxystatsurl, haproxystatsuser, jvm, jvmoptions, jvmversion, javaappserver, javaappserverversion, managebundler, memcachedmemory, mysqlrootpassword, mysqlrootpasswordubiquitous, nodejsversion, passengerversion, railsstack, rubyversion, rubygemsversion"  instance ToText LayerAttributesKeys where     toText = \case@@ -444,7 +444,7 @@     parser = takeLowerText >>= \case         "color" -> pure Color         e -> fromTextError $ "Failure parsing StackAttributesKeys from value: '" <> e-           <> "'. Accepted values: Color"+           <> "'. Accepted values: color"  instance ToText StackAttributesKeys where     toText = \case

@@ -131,6 +131,7 @@ -- | The default AWS OpsWorks agent version. You have the following options: -- -- -   'INHERIT' - Use the stack\'s default agent version setting.+-- -- -   /version_number/ - Use the specified agent version. This value overrides the stack\'s default setting. To update the agent version, you must edit the instance configuration and specify a new version. AWS OpsWorks then automatically installs that version on the instance. -- -- The default setting is 'INHERIT'. To specify an agent version, you must use the complete version number, not the abbreviated number shown on the console. For a list of available agent version numbers, call < DescribeAgentVersions>.@@ -147,8 +148,16 @@  -- | The instance\'s operating system, which must be set to one of the following. ----- -   A supported Linux operating system: An Amazon Linux version, such as 'Amazon Linux 2015.03', 'Red Hat Enterprise Linux 7', 'Ubuntu 12.04 LTS', or 'Ubuntu 14.04 LTS'.--- -   'Microsoft Windows Server 2012 R2 Base'.+-- -   A supported Linux operating system: An Amazon Linux version, such as 'Amazon Linux 2016.03', 'Amazon Linux 2015.09', or 'Amazon Linux 2015.03'.+--+-- -   A supported Ubuntu operating system, such as 'Ubuntu 16.04 LTS', 'Ubuntu 14.04 LTS', or 'Ubuntu 12.04 LTS'.+--+-- -   'CentOS 7'+--+-- -   'Red Hat Enterprise Linux 7'+--+-- -   A supported Windows operating system, such as 'Microsoft Windows Server 2012 R2 Base', 'Microsoft Windows Server 2012 R2 with SQL Server Express', 'Microsoft Windows Server 2012 R2 with SQL Server Standard', or 'Microsoft Windows Server 2012 R2 with SQL Server Web'.+-- -- -   A custom AMI: 'Custom'. -- -- For more information on the supported operating systems, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-os.html AWS OpsWorks Operating Systems>.

@@ -163,6 +163,7 @@ -- | The default AWS OpsWorks agent version. You have the following options: -- -- -   Auto-update - Set this parameter to 'LATEST'. AWS OpsWorks automatically installs new agent versions on the stack\'s instances as soon as they are available.+-- -- -   Fixed version - Set this parameter to your preferred agent version. To update the agent version, you must edit the stack configuration and specify a new version. AWS OpsWorks then automatically installs that version on the stack\'s instances. -- -- The default setting is 'LATEST'. To specify an agent version, you must use the complete version number, not the abbreviated number shown on the console. For a list of available agent version numbers, call < DescribeAgentVersions>.@@ -201,8 +202,16 @@  -- | The stack\'s operating system, which must be set to one of the following: ----- -   A supported Linux operating system: An Amazon Linux version, such as 'Amazon Linux 2015.03', 'Red Hat Enterprise Linux 7', 'Ubuntu 12.04 LTS', or 'Ubuntu 14.04 LTS'.--- -   'Microsoft Windows Server 2012 R2 Base'.+-- -   A supported Linux operating system: An Amazon Linux version, such as 'Amazon Linux 2016.03', 'Amazon Linux 2015.09', or 'Amazon Linux 2015.03'.+--+-- -   A supported Ubuntu operating system, such as 'Ubuntu 16.04 LTS', 'Ubuntu 14.04 LTS', or 'Ubuntu 12.04 LTS'.+--+-- -   'CentOS 7'+--+-- -   'Red Hat Enterprise Linux 7'+--+-- -   A supported Windows operating system, such as 'Microsoft Windows Server 2012 R2 Base', 'Microsoft Windows Server 2012 R2 with SQL Server Express', 'Microsoft Windows Server 2012 R2 with SQL Server Standard', or 'Microsoft Windows Server 2012 R2 with SQL Server Web'.+-- -- -   A custom AMI: 'Custom'. You specify the custom AMI you want to use when you create instances. For more information on how to use custom AMIs with OpsWorks, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-custom-ami.html Using Custom AMIs>. -- -- The default option is the stack\'s current operating system. For more information on the supported operating systems, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-os.html AWS OpsWorks Operating Systems>.@@ -214,6 +223,7 @@ -- AWS OpsWorks provides a standard set of built-in security groups, one for each layer, which are associated with layers by default. 'UseOpsworksSecurityGroups' allows you to provide your own custom security groups instead of using the built-in groups. 'UseOpsworksSecurityGroups' has the following settings: -- -- -   True - AWS OpsWorks automatically associates the appropriate built-in security group with each layer (default setting). You can associate additional security groups with a layer after you create it, but you cannot delete the built-in security group.+-- -- -   False - AWS OpsWorks does not associate built-in security groups with layers. You must create appropriate EC2 security groups and associate a security group with each layer that you create. However, you can still manually associate a built-in security group with a layer on. Custom security groups are required only for those layers that need custom settings. -- -- For more information, see <http://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-creating.html Create a New Stack>.@@ -235,15 +245,25 @@ -- | The stack\'s new host name theme, with spaces replaced by underscores. The theme is used to generate host names for the stack\'s instances. By default, 'HostnameTheme' is set to 'Layer_Dependent', which creates host names by appending integers to the layer\'s short name. The other themes are: -- -- -   'Baked_Goods'+-- -- -   'Clouds'+-- -- -   'Europe_Cities'+-- -- -   'Fruits'+-- -- -   'Greek_Deities'+-- -- -   'Legendary_creatures_from_Japan'+-- -- -   'Planets_and_Moons'+-- -- -   'Roman_Deities'+-- -- -   'Scottish_Islands'+-- -- -   'US_Cities'+-- -- -   'Wild_Cats' -- -- To obtain a generated host name, call 'GetHostNameSuggestion', which returns a host name based on the current theme.