autoscaling_execute_policy: Executes the specified policy

Description

Executes the specified policy.

Usage

autoscaling_execute_policy(AutoScalingGroupName, PolicyName,
  HonorCooldown, MetricValue, BreachThreshold)

Arguments

AutoScalingGroupName

The name of the Auto Scaling group.

PolicyName

[required] The name or ARN of the policy.

HonorCooldown

Indicates whether Amazon EC2 Auto Scaling waits for the cooldown period to complete before executing the policy.

This parameter is not supported if the policy type is StepScaling.

For more information, see Scaling Cooldowns in the Amazon EC2 Auto Scaling User Guide.

MetricValue

The metric value to compare to BreachThreshold. This enables you to execute a policy of type StepScaling and determine which step adjustment to use. For example, if the breach threshold is 50 and you want to use a step adjustment with a lower bound of 0 and an upper bound of 10, you can set the metric value to 59.

If you specify a metric value that doesn't correspond to a step adjustment for the policy, the call returns an error.

Conditional: This parameter is required if the policy type is StepScaling and not supported otherwise.

BreachThreshold

The breach threshold for the alarm.

Conditional: This parameter is required if the policy type is StepScaling and not supported otherwise.

Request syntax

svc$execute_policy(
  AutoScalingGroupName = "string",
  PolicyName = "string",
  HonorCooldown = TRUE|FALSE,
  MetricValue = 123.0,
  BreachThreshold = 123.0
)

Examples

Run this code

# NOT RUN {
# This example executes the specified Auto Scaling policy for the
# specified Auto Scaling group.
# }
# NOT RUN {
svc$execute_policy(
  AutoScalingGroupName = "my-auto-scaling-group",
  HonorCooldown = TRUE,
  PolicyName = "ScaleIn"
)
# }
# NOT RUN {
# }

Run the code above in your browser using DataCamp Workspace