github.com/danp/terraform@v0.9.5-0.20170426144147-39d740081351/website/source/docs/providers/aws/r/autoscaling_schedule.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_autoscaling_schedule"
     4  sidebar_current: "docs-aws-resource-autoscaling-schedule"
     5  description: |-
     6    Provides an AutoScaling Schedule resource.
     7  ---
     8  
     9  # aws\_autoscaling\_schedule
    10  
    11  Provides an AutoScaling Schedule resource.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  resource "aws_autoscaling_group" "foobar" {
    17    availability_zones        = ["us-west-2a"]
    18    name                      = "terraform-test-foobar5"
    19    max_size                  = 1
    20    min_size                  = 1
    21    health_check_grace_period = 300
    22    health_check_type         = "ELB"
    23    force_delete              = true
    24    termination_policies      = ["OldestInstance"]
    25  }
    26  
    27  resource "aws_autoscaling_schedule" "foobar" {
    28    scheduled_action_name  = "foobar"
    29    min_size               = 0
    30    max_size               = 1
    31    desired_capacity       = 0
    32    start_time             = "2016-12-11T18:00:00Z"
    33    end_time               = "2016-12-12T06:00:00Z"
    34    autoscaling_group_name = "${aws_autoscaling_group.foobar.name}"
    35  }
    36  ```
    37  
    38  ## Argument Reference
    39  
    40  The following arguments are supported:
    41  
    42  * `autoscaling_group_name` - (Required) The name or Amazon Resource Name (ARN) of the Auto Scaling group.
    43  * `scheduled_action_name` - (Required) The name of this scaling action.
    44  * `start_time` - (Optional) The time for this action to start, in "YYYY-MM-DDThh:mm:ssZ" format in UTC/GMT only (for example, 2014-06-01T00:00:00Z ).
    45                              If you try to schedule your action in the past, Auto Scaling returns an error message.
    46  * `end_time` - (Optional) The time for this action to end, in "YYYY-MM-DDThh:mm:ssZ" format in UTC/GMT only (for example, 2014-06-01T00:00:00Z ).
    47                            If you try to schedule your action in the past, Auto Scaling returns an error message.
    48  * `recurrence` - (Optional) The time when recurring future actions will start. Start time is specified by the user following the Unix cron syntax format.
    49  * `min_size` - (Optional) The minimum size for the Auto Scaling group. Default
    50  0.
    51  * `max_size` - (Optional) The maximum size for the Auto Scaling group. Default
    52  0.
    53  * `desired_capacity` - (Optional) The number of EC2 instances that should be running in the group. Default 0.
    54  
    55  ~> **NOTE:** When `start_time` and `end_time` are specified with `recurrence` , they form the boundaries of when the recurring action will start and stop.
    56  
    57  ## Attribute Reference
    58  * `arn` - The ARN assigned by AWS to the autoscaling schedule.