terraform/website/source/docs/providers/aws/r/appautoscaling_policy.html....

4.0 KiB

layout page_title sidebar_current description
aws AWS: aws_appautoscaling_policy docs-aws-resource-appautoscaling-policy Provides an Application AutoScaling Policy resource.

aws_appautoscaling_policy

Provides an Application AutoScaling Policy resource.

Example Usage

resource "aws_appautoscaling_target" "ecs_target" {
  max_capacity       = 4
  min_capacity       = 1
  resource_id        = "service/clusterName/serviceName"
  role_arn           = "${var.ecs_iam_role}"
  scalable_dimension = "ecs:service:DesiredCount"
  service_namespace  = "ecs"
}

resource "aws_appautoscaling_policy" "ecs_policy" {
  adjustment_type         = "ChangeInCapacity"
  cooldown                = 60
  metric_aggregation_type = "Maximum"
  name                    = "scale-down"
  resource_id             = "service/clusterName/serviceName"
  scalable_dimension      = "ecs:service:DesiredCount"
  service_namespace       = "ecs"

  step_adjustment {
    metric_interval_lower_bound = 0
    scaling_adjustment          = -1
  }

  depends_on = ["aws_appautoscaling_target.ecs_target"]
}

Argument Reference

The following arguments are supported:

  • adjustment_type - (Required) Specifies whether the adjustment is an absolute number or a percentage of the current capacity. Valid values are ChangeInCapacity, ExactCapacity, and PercentChangeInCapacity.
  • cooldown - (Required) The amount of time, in seconds, after a scaling activity completes and before the next scaling activity can start.
  • metric_aggregation_type - (Required) The aggregation type for the policy's metrics. Valid values are "Minimum", "Maximum", and "Average". Without a value, AWS will treat the aggregation type as "Average".
  • name - (Required) The name of the policy.
  • policy_type - (Optional) Defaults to "StepScaling" because it is the only option available.
  • resource_id - (Required) The resource type and unique identifier string for the resource associated with the scaling policy. For Amazon ECS services, this value is the resource type, followed by the cluster name and service name, such as service/default/sample-webapp. For Amazon EC2 Spot fleet requests, the resource type is spot-fleet-request, and the identifier is the Spot fleet request ID; for example, spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.
  • scalable_dimension - (Required) The scalable dimension of the scalable target. The scalable dimension contains the service namespace, resource type, and scaling property, such as ecs:service:DesiredCount for the desired task count of an Amazon ECS service, or ec2:spot-fleet-request:TargetCapacity for the target capacity of an Amazon EC2 Spot fleet request.
  • service_namespace - (Required) The AWS service namespace of the scalable target. Valid values are ecs for Amazon ECS services and ec2 Amazon EC2 Spot fleet requests.
  • step_adjustment - (Optional) A set of adjustments that manage scaling. These have the following structure:
step_adjustment {
  metric_interval_lower_bound = 1.0
  metric_interval_upper_bound = 2.0
  scaling_adjustment = -1
}
step_adjustment {
  metric_interval_lower_bound = 2.0
  metric_interval_upper_bound = 3.0
  scaling_adjustment = 1
}
  • metric_interval_lower_bound - (Optional) The lower bound for the difference between the alarm threshold and the CloudWatch metric. Without a value, AWS will treat this bound as infinity.
  • metric_interval_upper_bound - (Optional) The upper bound for the difference between the alarm threshold and the CloudWatch metric. Without a value, AWS will treat this bound as infinity. The upper bound must be greater than the lower bound.
  • scaling_adjustment - (Required) The number of members by which to scale, when the adjustment bounds are breached. A positive value scales up. A negative value scales down.

Attribute Reference

  • adjustment_type - The scaling policy's adjustment type.
  • arn - The ARN assigned by AWS to the scaling policy.
  • name - The scaling policy's name.
  • policy_type - The scaling policy's type.