{ "version": "1.0", "examples": { "AttachInstances": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "InstanceIds": [ "i-93633f9b" ] }, "comments": { "input": { }, "output": { } }, "description": "This example attaches the specified instance to the specified Auto Scaling group.", "id": "autoscaling-attach-instances-1", "title": "To attach an instance to an Auto Scaling group" } ], "AttachLoadBalancerTargetGroups": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "TargetGroupARNs": [ "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" ] }, "comments": { "input": { }, "output": { } }, "description": "This example attaches the specified target group to the specified Auto Scaling group.", "id": "autoscaling-attach-load-balancer-target-groups-1", "title": "To attach a target group to an Auto Scaling group" } ], "AttachLoadBalancers": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "LoadBalancerNames": [ "my-load-balancer" ] }, "comments": { "input": { }, "output": { } }, "description": "This example attaches the specified load balancer to the specified Auto Scaling group.", "id": "autoscaling-attach-load-balancers-1", "title": "To attach a load balancer to an Auto Scaling group" } ], "CompleteLifecycleAction": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "LifecycleActionResult": "CONTINUE", "LifecycleActionToken": "bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635", "LifecycleHookName": "my-lifecycle-hook" }, "comments": { "input": { }, "output": { } }, "description": "This example notifies Auto Scaling that the specified lifecycle action is complete so that it can finish launching or terminating the instance.", "id": "autoscaling-complete-lifecycle-action-1", "title": "To complete the lifecycle action" } ], "CreateAutoScalingGroup": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "LaunchConfigurationName": "my-launch-config", "MaxSize": 3, "MinSize": 1, "VPCZoneIdentifier": "subnet-4176792c" }, "comments": { "input": { }, "output": { } }, "description": "This example creates an Auto Scaling group.", "id": "autoscaling-create-auto-scaling-group-1", "title": "To create an Auto Scaling group" }, { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "AvailabilityZones": [ "us-west-2c" ], "HealthCheckGracePeriod": 120, "HealthCheckType": "ELB", "LaunchConfigurationName": "my-launch-config", "LoadBalancerNames": [ "my-load-balancer" ], "MaxSize": 3, "MinSize": 1 }, "comments": { "input": { }, "output": { } }, "description": "This example creates an Auto Scaling group and attaches the specified Classic Load Balancer.", "id": "autoscaling-create-auto-scaling-group-2", "title": "To create an Auto Scaling group with an attached load balancer" }, { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "HealthCheckGracePeriod": 120, "HealthCheckType": "ELB", "LaunchConfigurationName": "my-launch-config", "MaxSize": 3, "MinSize": 1, "TargetGroupARNs": [ "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" ], "VPCZoneIdentifier": "subnet-4176792c, subnet-65ea5f08" }, "comments": { "input": { }, "output": { } }, "description": "This example creates an Auto Scaling group and attaches the specified target group.", "id": "autoscaling-create-auto-scaling-group-3", "title": "To create an Auto Scaling group with an attached target group" } ], "CreateLaunchConfiguration": [ { "input": { "IamInstanceProfile": "my-iam-role", "ImageId": "ami-12345678", "InstanceType": "m3.medium", "LaunchConfigurationName": "my-launch-config", "SecurityGroups": [ "sg-eb2af88e" ] }, "comments": { "input": { }, "output": { } }, "description": "This example creates a launch configuration.", "id": "autoscaling-create-launch-configuration-1", "title": "To create a launch configuration" } ], "CreateOrUpdateTags": [ { "input": { "Tags": [ { "Key": "Role", "PropagateAtLaunch": true, "ResourceId": "my-auto-scaling-group", "ResourceType": "auto-scaling-group", "Value": "WebServer" }, { "Key": "Dept", "PropagateAtLaunch": true, "ResourceId": "my-auto-scaling-group", "ResourceType": "auto-scaling-group", "Value": "Research" } ] }, "comments": { "input": { }, "output": { } }, "description": "This example adds two tags to the specified Auto Scaling group.", "id": "autoscaling-create-or-update-tags-1", "title": "To create or update tags for an Auto Scaling group" } ], "DeleteAutoScalingGroup": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group" }, "comments": { "input": { }, "output": { } }, "description": "This example deletes the specified Auto Scaling group.", "id": "autoscaling-delete-auto-scaling-group-1", "title": "To delete an Auto Scaling group" }, { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "ForceDelete": true }, "comments": { "input": { }, "output": { } }, "description": "This example deletes the specified Auto Scaling group and all its instances.", "id": "autoscaling-delete-auto-scaling-group-2", "title": "To delete an Auto Scaling group and all its instances" } ], "DeleteLaunchConfiguration": [ { "input": { "LaunchConfigurationName": "my-launch-config" }, "comments": { "input": { }, "output": { } }, "description": "This example deletes the specified launch configuration.", "id": "autoscaling-delete-launch-configuration-1", "title": "To delete a launch configuration" } ], "DeleteLifecycleHook": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "LifecycleHookName": "my-lifecycle-hook" }, "comments": { "input": { }, "output": { } }, "description": "This example deletes the specified lifecycle hook.", "id": "autoscaling-delete-lifecycle-hook-1", "title": "To delete a lifecycle hook" } ], "DeleteNotificationConfiguration": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic" }, "comments": { "input": { }, "output": { } }, "description": "This example deletes the specified notification from the specified Auto Scaling group.", "id": "autoscaling-delete-notification-configuration-1", "title": "To delete an Auto Scaling notification" } ], "DeletePolicy": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "PolicyName": "ScaleIn" }, "comments": { "input": { }, "output": { } }, "description": "This example deletes the specified Auto Scaling policy.", "id": "autoscaling-delete-policy-1", "title": "To delete an Auto Scaling policy" } ], "DeleteScheduledAction": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "ScheduledActionName": "my-scheduled-action" }, "comments": { "input": { }, "output": { } }, "description": "This example deletes the specified scheduled action from the specified Auto Scaling group.", "id": "autoscaling-delete-scheduled-action-1", "title": "To delete a scheduled action from an Auto Scaling group" } ], "DeleteTags": [ { "input": { "Tags": [ { "Key": "Dept", "ResourceId": "my-auto-scaling-group", "ResourceType": "auto-scaling-group", "Value": "Research" } ] }, "comments": { "input": { }, "output": { } }, "description": "This example deletes the specified tag from the specified Auto Scaling group.", "id": "autoscaling-delete-tags-1", "title": "To delete a tag from an Auto Scaling group" } ], "DescribeAccountLimits": [ { "output": { "MaxNumberOfAutoScalingGroups": 20, "MaxNumberOfLaunchConfigurations": 100, "NumberOfAutoScalingGroups": 3, "NumberOfLaunchConfigurations": 5 }, "comments": { "input": { }, "output": { } }, "description": "This example describes the Auto Scaling limits for your AWS account.", "id": "autoscaling-describe-account-limits-1", "title": "To describe your Auto Scaling account limits" } ], "DescribeAdjustmentTypes": [ { "output": { "AdjustmentTypes": [ { "AdjustmentType": "ChangeInCapacity" }, { "AdjustmentType": "ExactCapcity" }, { "AdjustmentType": "PercentChangeInCapacity" } ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the available adjustment types.", "id": "autoscaling-describe-adjustment-types-1", "title": "To describe the Auto Scaling adjustment types" } ], "DescribeAutoScalingGroups": [ { "input": { "AutoScalingGroupNames": [ "my-auto-scaling-group" ] }, "output": { "AutoScalingGroups": [ { "AutoScalingGroupARN": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:930d940e-891e-4781-a11a-7b0acd480f03:autoScalingGroupName/my-auto-scaling-group", "AutoScalingGroupName": "my-auto-scaling-group", "AvailabilityZones": [ "us-west-2c" ], "CreatedTime": "2013-08-19T20:53:25.584Z", "DefaultCooldown": 300, "DesiredCapacity": 1, "EnabledMetrics": [ ], "HealthCheckGracePeriod": 300, "HealthCheckType": "EC2", "Instances": [ { "AvailabilityZone": "us-west-2c", "HealthStatus": "Healthy", "InstanceId": "i-4ba0837f", "LaunchConfigurationName": "my-launch-config", "LifecycleState": "InService", "ProtectedFromScaleIn": false } ], "LaunchConfigurationName": "my-launch-config", "LoadBalancerNames": [ ], "MaxSize": 1, "MinSize": 0, "NewInstancesProtectedFromScaleIn": false, "SuspendedProcesses": [ ], "Tags": [ ], "TerminationPolicies": [ "Default" ], "VPCZoneIdentifier": "subnet-12345678" } ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the specified Auto Scaling group.", "id": "autoscaling-describe-auto-scaling-groups-1", "title": "To describe an Auto Scaling group" } ], "DescribeAutoScalingInstances": [ { "input": { "InstanceIds": [ "i-4ba0837f" ] }, "output": { "AutoScalingInstances": [ { "AutoScalingGroupName": "my-auto-scaling-group", "AvailabilityZone": "us-west-2c", "HealthStatus": "HEALTHY", "InstanceId": "i-4ba0837f", "LaunchConfigurationName": "my-launch-config", "LifecycleState": "InService", "ProtectedFromScaleIn": false } ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the specified Auto Scaling instance.", "id": "autoscaling-describe-auto-scaling-instances-1", "title": "To describe one or more Auto Scaling instances" } ], "DescribeAutoScalingNotificationTypes": [ { "output": { "AutoScalingNotificationTypes": [ "autoscaling:EC2_INSTANCE_LAUNCH", "autoscaling:EC2_INSTANCE_LAUNCH_ERROR", "autoscaling:EC2_INSTANCE_TERMINATE", "autoscaling:EC2_INSTANCE_TERMINATE_ERROR", "autoscaling:TEST_NOTIFICATION" ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the available notification types.", "id": "autoscaling-describe-auto-scaling-notification-types-1", "title": "To describe the Auto Scaling notification types" } ], "DescribeLaunchConfigurations": [ { "input": { "LaunchConfigurationNames": [ "my-launch-config" ] }, "output": { "LaunchConfigurations": [ { "AssociatePublicIpAddress": true, "BlockDeviceMappings": [ ], "CreatedTime": "2014-05-07T17:39:28.599Z", "EbsOptimized": false, "ImageId": "ami-043a5034", "InstanceMonitoring": { "Enabled": true }, "InstanceType": "t1.micro", "LaunchConfigurationARN": "arn:aws:autoscaling:us-west-2:123456789012:launchConfiguration:98d3b196-4cf9-4e88-8ca1-8547c24ced8b:launchConfigurationName/my-launch-config", "LaunchConfigurationName": "my-launch-config", "SecurityGroups": [ "sg-67ef0308" ] } ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the specified launch configuration.", "id": "autoscaling-describe-launch-configurations-1", "title": "To describe Auto Scaling launch configurations" } ], "DescribeLifecycleHookTypes": [ { "output": { "LifecycleHookTypes": [ "autoscaling:EC2_INSTANCE_LAUNCHING", "autoscaling:EC2_INSTANCE_TERMINATING" ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the available lifecycle hook types.", "id": "autoscaling-describe-lifecycle-hook-types-1", "title": "To describe the available types of lifecycle hooks" } ], "DescribeLifecycleHooks": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group" }, "output": { "LifecycleHooks": [ { "AutoScalingGroupName": "my-auto-scaling-group", "DefaultResult": "ABANDON", "GlobalTimeout": 172800, "HeartbeatTimeout": 3600, "LifecycleHookName": "my-lifecycle-hook", "LifecycleTransition": "autoscaling:EC2_INSTANCE_LAUNCHING", "NotificationTargetARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic", "RoleARN": "arn:aws:iam::123456789012:role/my-auto-scaling-role" } ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the lifecycle hooks for the specified Auto Scaling group.", "id": "autoscaling-describe-lifecycle-hooks-1", "title": "To describe your lifecycle hooks" } ], "DescribeLoadBalancerTargetGroups": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group" }, "output": { "LoadBalancerTargetGroups": [ { "LoadBalancerTargetGroupARN": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", "State": "Added" } ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the target groups attached to the specified Auto Scaling group.", "id": "autoscaling-describe-load-balancer-target-groups-1", "title": "To describe the target groups for an Auto Scaling group" } ], "DescribeLoadBalancers": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group" }, "output": { "LoadBalancers": [ { "LoadBalancerName": "my-load-balancer", "State": "Added" } ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the load balancers attached to the specified Auto Scaling group.", "id": "autoscaling-describe-load-balancers-1", "title": "To describe the load balancers for an Auto Scaling group" } ], "DescribeMetricCollectionTypes": [ { "output": { "Granularities": [ { "Granularity": "1Minute" } ], "Metrics": [ { "Metric": "GroupMinSize" }, { "Metric": "GroupMaxSize" }, { "Metric": "GroupDesiredCapacity" }, { "Metric": "GroupInServiceInstances" }, { "Metric": "GroupPendingInstances" }, { "Metric": "GroupTerminatingInstances" }, { "Metric": "GroupStandbyInstances" }, { "Metric": "GroupTotalInstances" } ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the available metric collection types.", "id": "autoscaling-describe-metric-collection-types-1", "title": "To describe the Auto Scaling metric collection types" } ], "DescribeNotificationConfigurations": [ { "input": { "AutoScalingGroupNames": [ "my-auto-scaling-group" ] }, "output": { "NotificationConfigurations": [ { "AutoScalingGroupName": "my-auto-scaling-group", "NotificationType": "autoscaling:TEST_NOTIFICATION", "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic-2" }, { "AutoScalingGroupName": "my-auto-scaling-group", "NotificationType": "autoscaling:TEST_NOTIFICATION", "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic" } ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the notification configurations for the specified Auto Scaling group.", "id": "autoscaling-describe-notification-configurations-1", "title": "To describe Auto Scaling notification configurations" } ], "DescribePolicies": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group" }, "output": { "ScalingPolicies": [ { "AdjustmentType": "ChangeInCapacity", "Alarms": [ ], "AutoScalingGroupName": "my-auto-scaling-group", "PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:2233f3d7-6290-403b-b632-93c553560106:autoScalingGroupName/my-auto-scaling-group:policyName/ScaleIn", "PolicyName": "ScaleIn", "ScalingAdjustment": -1 }, { "AdjustmentType": "PercentChangeInCapacity", "Alarms": [ ], "AutoScalingGroupName": "my-auto-scaling-group", "Cooldown": 60, "MinAdjustmentStep": 2, "PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:2b435159-cf77-4e89-8c0e-d63b497baad7:autoScalingGroupName/my-auto-scaling-group:policyName/ScalePercentChange", "PolicyName": "ScalePercentChange", "ScalingAdjustment": 25 } ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the policies for the specified Auto Scaling group.", "id": "autoscaling-describe-policies-1", "title": "To describe Auto Scaling policies" } ], "DescribeScalingActivities": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group" }, "output": { "Activities": [ { "ActivityId": "f9f2d65b-f1f2-43e7-b46d-d86756459699", "AutoScalingGroupName": "my-auto-scaling-group", "Cause": "At 2013-08-19T20:53:25Z a user request created an AutoScalingGroup changing the desired capacity from 0 to 1. At 2013-08-19T20:53:29Z an instance was started in response to a difference between desired and actual capacity, increasing the capacity from 0 to 1.", "Description": "Launching a new EC2 instance: i-4ba0837f", "Details": "details", "EndTime": "2013-08-19T20:54:02Z", "Progress": 100, "StartTime": "2013-08-19T20:53:29.930Z", "StatusCode": "Successful" } ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the scaling activities for the specified Auto Scaling group.", "id": "autoscaling-describe-scaling-activities-1", "title": "To describe the scaling activities for an Auto Scaling group" } ], "DescribeScalingProcessTypes": [ { "output": { "Processes": [ { "ProcessName": "AZRebalance" }, { "ProcessName": "AddToLoadBalancer" }, { "ProcessName": "AlarmNotification" }, { "ProcessName": "HealthCheck" }, { "ProcessName": "Launch" }, { "ProcessName": "ReplaceUnhealthy" }, { "ProcessName": "ScheduledActions" }, { "ProcessName": "Terminate" } ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the Auto Scaling process types.", "id": "autoscaling-describe-scaling-process-types-1", "title": "To describe the Auto Scaling process types" } ], "DescribeScheduledActions": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group" }, "output": { "ScheduledUpdateGroupActions": [ { "AutoScalingGroupName": "my-auto-scaling-group", "DesiredCapacity": 4, "MaxSize": 6, "MinSize": 2, "Recurrence": "30 0 1 12 0", "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledUpdateGroupAction:8e86b655-b2e6-4410-8f29-b4f094d6871c:autoScalingGroupName/my-auto-scaling-group:scheduledActionName/my-scheduled-action", "ScheduledActionName": "my-scheduled-action", "StartTime": "2016-12-01T00:30:00Z", "Time": "2016-12-01T00:30:00Z" } ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the scheduled actions for the specified Auto Scaling group.", "id": "autoscaling-describe-scheduled-actions-1", "title": "To describe scheduled actions" } ], "DescribeTags": [ { "input": { "Filters": [ { "Name": "auto-scaling-group", "Values": [ "my-auto-scaling-group" ] } ] }, "output": { "Tags": [ { "Key": "Dept", "PropagateAtLaunch": true, "ResourceId": "my-auto-scaling-group", "ResourceType": "auto-scaling-group", "Value": "Research" }, { "Key": "Role", "PropagateAtLaunch": true, "ResourceId": "my-auto-scaling-group", "ResourceType": "auto-scaling-group", "Value": "WebServer" } ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the tags for the specified Auto Scaling group.", "id": "autoscaling-describe-tags-1", "title": "To describe tags" } ], "DescribeTerminationPolicyTypes": [ { "output": { "TerminationPolicyTypes": [ "ClosestToNextInstanceHour", "Default", "NewestInstance", "OldestInstance", "OldestLaunchConfiguration" ] }, "comments": { "input": { }, "output": { } }, "description": "This example describes the available termination policy types.", "id": "autoscaling-describe-termination-policy-types-1", "title": "To describe termination policy types" } ], "DetachInstances": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "InstanceIds": [ "i-93633f9b" ], "ShouldDecrementDesiredCapacity": true }, "output": { "Activities": [ { "ActivityId": "5091cb52-547a-47ce-a236-c9ccbc2cb2c9", "AutoScalingGroupName": "my-auto-scaling-group", "Cause": "At 2015-04-12T15:02:16Z instance i-93633f9b was detached in response to a user request, shrinking the capacity from 2 to 1.", "Description": "Detaching EC2 instance: i-93633f9b", "Details": "details", "Progress": 50, "StartTime": "2015-04-12T15:02:16.179Z", "StatusCode": "InProgress" } ] }, "comments": { "input": { }, "output": { } }, "description": "This example detaches the specified instance from the specified Auto Scaling group.", "id": "autoscaling-detach-instances-1", "title": "To detach an instance from an Auto Scaling group" } ], "DetachLoadBalancerTargetGroups": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "TargetGroupARNs": [ "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" ] }, "comments": { "input": { }, "output": { } }, "description": "This example detaches the specified target group from the specified Auto Scaling group", "id": "autoscaling-detach-load-balancer-target-groups-1", "title": "To detach a target group from an Auto Scaling group" } ], "DetachLoadBalancers": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "LoadBalancerNames": [ "my-load-balancer" ] }, "comments": { "input": { }, "output": { } }, "description": "This example detaches the specified load balancer from the specified Auto Scaling group.", "id": "autoscaling-detach-load-balancers-1", "title": "To detach a load balancer from an Auto Scaling group" } ], "DisableMetricsCollection": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "Metrics": [ "GroupDesiredCapacity" ] }, "comments": { "input": { }, "output": { } }, "description": "This example disables collecting data for the GroupDesiredCapacity metric for the specified Auto Scaling group.", "id": "autoscaling-disable-metrics-collection-1", "title": "To disable metrics collection for an Auto Scaling group" } ], "EnableMetricsCollection": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "Granularity": "1Minute" }, "comments": { "input": { }, "output": { } }, "description": "This example enables data collection for the specified Auto Scaling group.", "id": "autoscaling-enable-metrics-collection-1", "title": "To enable metrics collection for an Auto Scaling group" } ], "EnterStandby": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "InstanceIds": [ "i-93633f9b" ], "ShouldDecrementDesiredCapacity": true }, "output": { "Activities": [ { "ActivityId": "ffa056b4-6ed3-41ba-ae7c-249dfae6eba1", "AutoScalingGroupName": "my-auto-scaling-group", "Cause": "At 2015-04-12T15:10:23Z instance i-93633f9b was moved to standby in response to a user request, shrinking the capacity from 2 to 1.", "Description": "Moving EC2 instance to Standby: i-93633f9b", "Details": "details", "Progress": 50, "StartTime": "2015-04-12T15:10:23.640Z", "StatusCode": "InProgress" } ] }, "comments": { "input": { }, "output": { } }, "description": "This example puts the specified instance into standby mode.", "id": "autoscaling-enter-standby-1", "title": "To move instances into standby mode" } ], "ExecutePolicy": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "HonorCooldown": true, "PolicyName": "ScaleIn" }, "comments": { "input": { }, "output": { } }, "description": "This example executes the specified Auto Scaling policy for the specified Auto Scaling group.", "id": "autoscaling-execute-policy-1", "title": "To execute an Auto Scaling policy" } ], "ExitStandby": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "InstanceIds": [ "i-93633f9b" ] }, "output": { "Activities": [ { "ActivityId": "142928e1-a2dc-453a-9b24-b85ad6735928", "AutoScalingGroupName": "my-auto-scaling-group", "Cause": "At 2015-04-12T15:14:29Z instance i-93633f9b was moved out of standby in response to a user request, increasing the capacity from 1 to 2.", "Description": "Moving EC2 instance out of Standby: i-93633f9b", "Details": "details", "Progress": 30, "StartTime": "2015-04-12T15:14:29.886Z", "StatusCode": "PreInService" } ] }, "comments": { "input": { }, "output": { } }, "description": "This example moves the specified instance out of standby mode.", "id": "autoscaling-exit-standby-1", "title": "To move instances out of standby mode" } ], "PutLifecycleHook": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "LifecycleHookName": "my-lifecycle-hook", "LifecycleTransition": "autoscaling:EC2_INSTANCE_LAUNCHING", "NotificationTargetARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic --role-arn", "RoleARN": "arn:aws:iam::123456789012:role/my-auto-scaling-role" }, "comments": { "input": { }, "output": { } }, "description": "This example creates a lifecycle hook.", "id": "autoscaling-put-lifecycle-hook-1", "title": "To create a lifecycle hook" } ], "PutNotificationConfiguration": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "NotificationTypes": [ "autoscaling:TEST_NOTIFICATION" ], "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic" }, "comments": { "input": { }, "output": { } }, "description": "This example adds the specified notification to the specified Auto Scaling group.", "id": "autoscaling-put-notification-configuration-1", "title": "To add an Auto Scaling notification" } ], "PutScalingPolicy": [ { "input": { "AdjustmentType": "ChangeInCapacity", "AutoScalingGroupName": "my-auto-scaling-group", "PolicyName": "ScaleIn", "ScalingAdjustment": -1 }, "output": { "PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:2233f3d7-6290-403b-b632-93c553560106:autoScalingGroupName/my-auto-scaling-group:policyName/ScaleIn" }, "comments": { "input": { }, "output": { } }, "description": "This example adds the specified policy to the specified Auto Scaling group.", "id": "autoscaling-put-scaling-policy-1", "title": "To add a scaling policy to an Auto Scaling group" } ], "PutScheduledUpdateGroupAction": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "DesiredCapacity": 4, "EndTime": "2014-05-12T08:00:00Z", "MaxSize": 6, "MinSize": 2, "ScheduledActionName": "my-scheduled-action", "StartTime": "2014-05-12T08:00:00Z" }, "comments": { "input": { }, "output": { } }, "description": "This example adds the specified scheduled action to the specified Auto Scaling group.", "id": "autoscaling-put-scheduled-update-group-action-1", "title": "To add a scheduled action to an Auto Scaling group" } ], "RecordLifecycleActionHeartbeat": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "LifecycleActionToken": "bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635", "LifecycleHookName": "my-lifecycle-hook" }, "comments": { "input": { }, "output": { } }, "description": "This example records a lifecycle action heartbeat to keep the instance in a pending state.", "id": "autoscaling-record-lifecycle-action-heartbeat-1", "title": "To record a lifecycle action heartbeat" } ], "ResumeProcesses": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "ScalingProcesses": [ "AlarmNotification" ] }, "comments": { "input": { }, "output": { } }, "description": "This example resumes the specified suspended scaling process for the specified Auto Scaling group.", "id": "autoscaling-resume-processes-1", "title": "To resume Auto Scaling processes" } ], "SetDesiredCapacity": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "DesiredCapacity": 2, "HonorCooldown": true }, "comments": { "input": { }, "output": { } }, "description": "This example sets the desired capacity for the specified Auto Scaling group.", "id": "autoscaling-set-desired-capacity-1", "title": "To set the desired capacity for an Auto Scaling group" } ], "SetInstanceHealth": [ { "input": { "HealthStatus": "Unhealthy", "InstanceId": "i-93633f9b" }, "comments": { "input": { }, "output": { } }, "description": "This example sets the health status of the specified instance to Unhealthy.", "id": "autoscaling-set-instance-health-1", "title": "To set the health status of an instance" } ], "SetInstanceProtection": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "InstanceIds": [ "i-93633f9b" ], "ProtectedFromScaleIn": true }, "comments": { "input": { }, "output": { } }, "description": "This example enables instance protection for the specified instance.", "id": "autoscaling-set-instance-protection-1", "title": "To enable instance protection for an instance" }, { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "InstanceIds": [ "i-93633f9b" ], "ProtectedFromScaleIn": false }, "comments": { "input": { }, "output": { } }, "description": "This example disables instance protection for the specified instance.", "id": "autoscaling-set-instance-protection-2", "title": "To disable instance protection for an instance" } ], "SuspendProcesses": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "ScalingProcesses": [ "AlarmNotification" ] }, "comments": { "input": { }, "output": { } }, "description": "This example suspends the specified scaling process for the specified Auto Scaling group.", "id": "autoscaling-suspend-processes-1", "title": "To suspend Auto Scaling processes" } ], "TerminateInstanceInAutoScalingGroup": [ { "input": { "InstanceId": "i-93633f9b", "ShouldDecrementDesiredCapacity": false }, "comments": { "input": { }, "output": { } }, "description": "This example terminates the specified instance from the specified Auto Scaling group without updating the size of the group. Auto Scaling launches a replacement instance after the specified instance terminates.", "id": "autoscaling-terminate-instance-in-auto-scaling-group-1", "title": "To terminate an instance in an Auto Scaling group" } ], "UpdateAutoScalingGroup": [ { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "LaunchConfigurationName": "new-launch-config" }, "comments": { "input": { }, "output": { } }, "description": "This example updates the launch configuration of the specified Auto Scaling group.", "id": "autoscaling-update-auto-scaling-group-1", "title": "To update the launch configuration" }, { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "MaxSize": 3, "MinSize": 1 }, "comments": { "input": { }, "output": { } }, "description": "This example updates the minimum size and maximum size of the specified Auto Scaling group.", "id": "autoscaling-update-auto-scaling-group-2", "title": "To update the minimum and maximum size" }, { "input": { "AutoScalingGroupName": "my-auto-scaling-group", "NewInstancesProtectedFromScaleIn": true }, "comments": { "input": { }, "output": { } }, "description": "This example enables instance protection for the specified Auto Scaling group.", "id": "autoscaling-update-auto-scaling-group-3", "title": "To enable instance protection" } ] } }