AWS SDK for .NET Documentation
CreateAutoScalingGroupRequest Class
AmazonAmazon.AutoScaling.ModelCreateAutoScalingGroupRequest Did this page help you?   Yes   No    Tell us about it...
Container for the parameters to the CreateAutoScalingGroup operation.

Creates a new Auto Scaling group with the specified name and other attributes. When the creation request is completed, the Auto Scaling group is ready to be used in other calls.

NOTE: The Auto Scaling group name must be unique within the scope of your AWS account.

Declaration Syntax
C#
public class CreateAutoScalingGroupRequest : AmazonWebServiceRequest
Members
All MembersConstructorsMethodsProperties



IconMemberDescription
CreateAutoScalingGroupRequest()()()()
Initializes a new instance of the CreateAutoScalingGroupRequest class

AutoScalingGroupName
The name of the Auto Scaling group.

Constraints:

Length
1 - 255
Pattern
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*


AvailabilityZones
A list of Availability Zones for the Auto Scaling group. This is required unless you have specified subnets.

Constraints:

Length
1 -


DefaultCooldown
The amount of time, in seconds, between a successful scaling activity and the succeeding scaling activity. If a DefaultCooldown period is not specified, Auto Scaling uses the default value of 300 as the default cool down period for the Auto Scaling group. For more information, see Cooldown Period

DesiredCapacity
The number of Amazon EC2 instances that should be running in the group. The desired capacity must be greater than or equal to the minimum size and less than or equal to the maximum size specified for the Auto Scaling group.

Equals(Object)
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
GetHashCode()()()()
Serves as a hash function for a particular type.
(Inherited from Object.)
GetType()()()()
Gets the type of the current instance.
(Inherited from Object.)
HealthCheckGracePeriod
Length of time in seconds after a new Amazon EC2 instance comes into service that Auto Scaling starts checking its health. During this time any health check failure for the that instance is ignored. This is required if you are adding 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.

HealthCheckType
The service you want the health checks from, Amazon EC2 or Elastic Load Balancer. Valid values are EC2 or ELB. By default, the Auto Scaling health check uses the results of Amazon EC2 instance status checks to determine the health of an instance. For more information, see Health Check.

Constraints:

Length
1 - 32
Pattern
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*


InstanceId
The ID of the Amazon EC2 instance you want to use to create the Auto Scaling group. Use this attribute if you want to create an Auto Scaling group using an EC2 instance instead of a launch configuration. When you use an instance to create an Auto Scaling group, a new launch configuration is first created and then associated with the Auto Scaling group. The new launch configuration derives all its attributes from the instance that is used to create the Auto Scaling group, with the exception of BlockDeviceMapping. For more information, see Create an Auto Scaling Group Using EC2 Instance in the Auto Scaling Developer Guide.

Constraints:

Length
1 - 16
Pattern
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*


LaunchConfigurationName
The name of an existing launch configuration to use to launch new instances. Use this attribute if you want to create an Auto Scaling group using an existing launch configuration instead of an EC2 instance.

Constraints:

Length
1 - 1600
Pattern
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*


LoadBalancerNames
A list of existing Elastic Load Balancing load balancers to use. The load balancers must be associated with the AWS account. For information on using load balancers, see Use Load Balancer to Load Balance Your Auto Scaling Group in the Auto Scaling Developer Guide.

MaxSize
The maximum size of the Auto Scaling group.

MinSize
The minimum size of the Auto Scaling group.

PlacementGroup
Physical location of an existing cluster placement group into which you want to launch your instances. For information about cluster placement group, see Using Cluster Instances

Constraints:

Length
1 - 255
Pattern
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*


Tags
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 information about using tags, see Tag Your Auto Scaling Groups and Amazon EC2 Instances in the Auto Scaling Developer Guide.

TerminationPolicies
A standalone termination policy or a list of termination policies used to select the instance to terminate. The policies are executed in the order that they are listed. For more information on configuring a termination policy for your Auto Scaling group, see Instance Termination Policy for Your Auto Scaling Group in the Auto Scaling Developer Guide.

ToString()()()()
Returns a string that represents the current object.
(Inherited from Object.)
VPCZoneIdentifier
A comma-separated list of subnet identifiers of Amazon Virtual Private Clouds (Amazon VPCs). If you specify subnets and Availability Zones with this call, ensure that the subnets' Availability Zones match the Availability Zones specified. For information on launching your Auto Scaling group into Amazon VPC subnets, see Launch Auto Scaling Instances into Amazon VPC in the Auto Scaling Developer Guide .

Constraints:

Length
1 - 255
Pattern
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*


WithAutoScalingGroupName(String) Obsolete.
Sets the AutoScalingGroupName property

WithAvailabilityZones(array<String>[]()[][]) Obsolete.
Adds elements to the AvailabilityZones collection

WithAvailabilityZones(IEnumerable<(Of <<'(String>)>>)) Obsolete.
Adds elements to the AvailabilityZones collection

WithDefaultCooldown(Int32) Obsolete.
Sets the DefaultCooldown property

WithDesiredCapacity(Int32) Obsolete.
Sets the DesiredCapacity property

WithHealthCheckGracePeriod(Int32) Obsolete.
Sets the HealthCheckGracePeriod property

WithHealthCheckType(String) Obsolete.
Sets the HealthCheckType property

WithInstanceId(String) Obsolete.
Sets the InstanceId property

WithLaunchConfigurationName(String) Obsolete.
Sets the LaunchConfigurationName property

WithLoadBalancerNames(array<String>[]()[][]) Obsolete.
Adds elements to the LoadBalancerNames collection

WithLoadBalancerNames(IEnumerable<(Of <<'(String>)>>)) Obsolete.
Adds elements to the LoadBalancerNames collection

WithMaxSize(Int32) Obsolete.
Sets the MaxSize property

WithMinSize(Int32) Obsolete.
Sets the MinSize property

WithPlacementGroup(String) Obsolete.
Sets the PlacementGroup property

WithTags(array<Tag>[]()[][]) Obsolete.
Adds elements to the Tags collection

WithTags(IEnumerable<(Of <<'(Tag>)>>)) Obsolete.
Adds elements to the Tags collection

WithTerminationPolicies(array<String>[]()[][]) Obsolete.
Adds elements to the TerminationPolicies collection

WithTerminationPolicies(IEnumerable<(Of <<'(String>)>>)) Obsolete.
Adds elements to the TerminationPolicies collection

WithVPCZoneIdentifier(String) Obsolete.
Sets the VPCZoneIdentifier property

Inheritance Hierarchy
Object
AmazonWebServiceRequest
 CreateAutoScalingGroupRequest
See Also

Assembly: AWSSDK (Module: AWSSDK) Version: 1.5.60.0 (1.5.60.0)