Copyright | (c) 2013-2015 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
Creates an Auto Scaling group with the specified name and attributes.
If you exceed your maximum limit of Auto Scaling groups, which by default is 20 per region, the call fails. For information about viewing and updating this limit, see DescribeAccountLimits.
For more information, see Auto Scaling Groups in the Auto Scaling Developer Guide.
See: AWS API Reference for CreateAutoScalingGroup.
- createAutoScalingGroup :: Text -> Int -> Int -> CreateAutoScalingGroup
- data CreateAutoScalingGroup
- casgInstanceId :: Lens' CreateAutoScalingGroup (Maybe Text)
- casgTerminationPolicies :: Lens' CreateAutoScalingGroup [Text]
- casgHealthCheckGracePeriod :: Lens' CreateAutoScalingGroup (Maybe Int)
- casgVPCZoneIdentifier :: Lens' CreateAutoScalingGroup (Maybe Text)
- casgDefaultCooldown :: Lens' CreateAutoScalingGroup (Maybe Int)
- casgDesiredCapacity :: Lens' CreateAutoScalingGroup (Maybe Int)
- casgAvailabilityZones :: Lens' CreateAutoScalingGroup (Maybe (NonEmpty Text))
- casgHealthCheckType :: Lens' CreateAutoScalingGroup (Maybe Text)
- casgLaunchConfigurationName :: Lens' CreateAutoScalingGroup (Maybe Text)
- casgPlacementGroup :: Lens' CreateAutoScalingGroup (Maybe Text)
- casgLoadBalancerNames :: Lens' CreateAutoScalingGroup [Text]
- casgTags :: Lens' CreateAutoScalingGroup [Tag]
- casgAutoScalingGroupName :: Lens' CreateAutoScalingGroup Text
- casgMinSize :: Lens' CreateAutoScalingGroup Int
- casgMaxSize :: Lens' CreateAutoScalingGroup Int
- createAutoScalingGroupResponse :: CreateAutoScalingGroupResponse
- data CreateAutoScalingGroupResponse
Creating a Request
Creates a value of CreateAutoScalingGroup
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
data CreateAutoScalingGroup Source
See: createAutoScalingGroup
smart constructor.
Request Lenses
casgInstanceId :: Lens' CreateAutoScalingGroup (Maybe Text) Source
The ID of the EC2 instance used to create a launch configuration for the
group. Alternatively, use the LaunchConfigurationName
parameter to
specify a launch configuration instead of an EC2 instance.
When you specify an ID of an instance, Auto Scaling creates a new launch configuration and associates it with the group. This launch configuration derives its attributes from the specified instance, with the exception of the block device mapping.
For more information, see Create an Auto Scaling Group from an EC2 Instance in the Auto Scaling Developer Guide.
casgTerminationPolicies :: Lens' CreateAutoScalingGroup [Text] Source
One or more termination policies used to select the instance to terminate. These policies are executed in the order that they are listed.
For more information, see Choosing a Termination Policy for Your Auto Scaling Group in the Auto Scaling Developer Guide.
casgHealthCheckGracePeriod :: Lens' CreateAutoScalingGroup (Maybe Int) Source
The amount of time, in seconds, after an EC2 instance comes into service that Auto Scaling starts checking its health. During this time, any health check failures for the instance are ignored.
This parameter is required if you are adding an ELB
health check.
Frequently, new instances need to warm up, briefly, before they can pass
a health check. To provide ample warm-up time, set the health check
grace period of the group to match the expected startup period of your
application.
For more information, see Add an Elastic Load Balancing Health Check to Your Auto Scaling Group in the Auto Scaling Developer Guide.
casgVPCZoneIdentifier :: Lens' CreateAutoScalingGroup (Maybe Text) Source
A comma-separated list of subnet identifiers for your virtual private cloud (VPC).
If you specify subnets and Availability Zones with this call, ensure that the subnets' Availability Zones match the Availability Zones specified.
For more information, see Auto Scaling and Amazon Virtual Private Cloud in the Auto Scaling Developer Guide.
casgDefaultCooldown :: Lens' CreateAutoScalingGroup (Maybe Int) Source
The amount of time, in seconds, after a scaling activity completes before another scaling activity can start.
If this parameter is not specified, the default value is 300. For more information, see Understanding Auto Scaling Cooldowns in the Auto Scaling Developer Guide.
casgDesiredCapacity :: Lens' CreateAutoScalingGroup (Maybe Int) Source
The number of EC2 instances that should be running in the group. This number must be greater than or equal to the minimum size of the group and less than or equal to the maximum size of the group.
casgAvailabilityZones :: Lens' CreateAutoScalingGroup (Maybe (NonEmpty Text)) Source
One or more Availability Zones for the group. This parameter is optional
if you specify subnets using the VPCZoneIdentifier
parameter.
casgHealthCheckType :: Lens' CreateAutoScalingGroup (Maybe Text) Source
The service to use for the health checks. The valid values are EC2
and
ELB
.
By default, health checks use Amazon EC2 instance status checks to determine the health of an instance. For more information, see Health Checks.
casgLaunchConfigurationName :: Lens' CreateAutoScalingGroup (Maybe Text) Source
The name of the launch configuration. Alternatively, use the
InstanceId
parameter to specify an EC2 instance instead of a launch
configuration.
casgPlacementGroup :: Lens' CreateAutoScalingGroup (Maybe Text) Source
The name of the placement group into which you'll launch your instances, if any. For more information, see Placement Groups in the Amazon Elastic Compute Cloud User Guide.
casgLoadBalancerNames :: Lens' CreateAutoScalingGroup [Text] Source
One or more load balancers.
For more information, see Load Balance Your Auto Scaling Group in the Auto Scaling Developer Guide.
casgTags :: Lens' CreateAutoScalingGroup [Tag] Source
The tag to be created or updated. Each tag should be defined by its resource type, resource ID, key, value, and a propagate flag. Valid values: key=value, value=value, propagate=true or false. Value and propagate are optional parameters.
For more information, see Tagging Auto Scaling Groups and Instances in the Auto Scaling Developer Guide.
casgAutoScalingGroupName :: Lens' CreateAutoScalingGroup Text Source
The name of the group. This name must be unique within the scope of your AWS account.
casgMinSize :: Lens' CreateAutoScalingGroup Int Source
The minimum size of the group.
casgMaxSize :: Lens' CreateAutoScalingGroup Int Source
The maximum size of the group.
Destructuring the Response
createAutoScalingGroupResponse :: CreateAutoScalingGroupResponse Source
Creates a value of CreateAutoScalingGroupResponse
with the minimum fields required to make a request.
data CreateAutoScalingGroupResponse Source
See: createAutoScalingGroupResponse
smart constructor.