ec2_scaling_policy - Create or delete AWS scaling policies for Autoscaling groups

Author:Zacharie Eakin

Synopsis

New in version 1.6.

Can create or delete scaling policies for autoscaling groups Referenced autoscaling groups must already exist

Options

parameter required default choices comments
adjustment_type no
  • ChangeInCapacity
  • ExactCapacity
  • PercentChangeInCapacity
asg_name yes
    Name of the associated autoscaling group
    aws_access_key no
      AWS access key. If not set then the value of the AWS_ACCESS_KEY environment variable is used.
      aws_secret_key no
        AWS secret key. If not set then the value of the AWS_SECRET_KEY environment variable is used.
        cooldown no
          The minimum period of time between which autoscaling actions can take place
          ec2_url no
            Url to use to connect to EC2 or your Eucalyptus cloud (by default the module will use EC2 endpoints). Must be specified if region is not used. If not set then the value of the EC2_URL environment variable, if any, is used
            min_adjustment_step no
              Minimum amount of adjustment when policy is triggered
              name yes
                Unique name for the scaling policy
                profile no
                  uses a boto profile. Only works with boto >= 2.24.0 (added in Ansible 1.6)
                  scaling_adjustment no
                    The amount by which the autoscaling group is adjusted by the policy
                    security_token no
                      security token to authenticate against AWS (added in Ansible 1.6)
                      state yes
                      • present
                      • absent
                      register or deregister the policy
                      validate_certs no yes
                      • yes
                      • no
                      When set to "no", SSL certificates will not be validated for boto versions >= 2.6.0. (added in Ansible 1.5)

                      Note

                      Requires boto

                      Examples


                      - ec2_scaling_policy:
                          state: present
                          region: US-XXX
                          name: "scaledown-policy"
                          adjustment_type: "ChangeInCapacity"
                          asg_name: "slave-pool"
                          scaling_adjustment: -1
                          min_adjustment_step: 1
                          cooldown: 300
                      

                      Note

                      The following environment variables can be used AWS_ACCESS_KEY or EC2_ACCESS_KEY or AWS_ACCESS_KEY_ID, AWS_SECRET_KEY or EC2_SECRET_KEY or AWS_SECRET_ACCESS_KEY, AWS_REGION or EC2_REGION, AWS_SECURITY_TOKEN

                      Note

                      Ansible uses the boto configuration file (typically ~/.boto) if no credentials are provided. See http://boto.readthedocs.org/en/latest/boto_config_tut.html

                      Note

                      AWS_REGION or EC2_REGION can be typically be used to specify the AWS region, when required, but this can also be configured in the boto config file