github.com/vtorhonen/terraform@v0.9.0-beta2.0.20170307220345-5d894e4ffda7/website/source/docs/providers/aws/r/lightsail_instance.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_lightsail_instance"
     4  sidebar_current: "docs-aws-resource-lightsail-instance"
     5  description: |-
     6    Provides an Lightsail Instance
     7  ---
     8  
     9  # aws\_lightsail\_instance
    10  
    11  Provides a Lightsail Instance. Amazon Lightsail is a service to provide easy virtual private servers
    12  with custom software already setup. See [What is Amazon Lightsail?](https://lightsail.aws.amazon.com/ls/docs/getting-started/article/what-is-amazon-lightsail)
    13  for more information.
    14  
    15  Note: Lightsail is currently only supported in `us-east-1` region.
    16  
    17  ## Example Usage
    18  
    19  ```
    20  # Create a new GitLab Lightsail Instance
    21  resource "aws_lightsail_instance" "gitlab_test" {
    22    name              = "custom gitlab"
    23    availability_zone = "us-east-1b"
    24    blueprint_id      = "string"
    25    bundle_id         = "string"
    26    key_pair_name     = "some_key_name"
    27  }
    28  ```
    29  
    30  ## Argument Reference
    31  
    32  The following arguments are supported:
    33  
    34  * `name` - (Required) The name of the Lightsail Instance
    35  * `availability_zone` - (Required) The Availability Zone in which to create your
    36  instance. At this time, must be in `us-east-1` region
    37  * `blueprint_id` - (Required) The ID for a virtual private server image
    38  (see list below)
    39  * `bundle_id` - (Required) The bundle of specification information (see list below)
    40  * `key_pair_name` - (Required) The name of your key pair. Created in the
    41  Lightsail console (cannot use `aws_key_pair` at this time)
    42  * `user_data` - (Optional) launch script to configure server with additional user data
    43  
    44  
    45  ## Blueprints
    46  
    47  Lightsail currently supports the following Blueprint IDs:
    48  
    49  - `amazon_linux_2016_09_0`
    50  - `ubuntu_16_04`
    51  - `wordpress_4_6_1`
    52  - `lamp_5_6_27`
    53  - `nodejs_6_9_1`
    54  - `joomla_3_6_3`
    55  - `magento_2_1_2`
    56  - `mean_3_2_10`
    57  - `drupal_8_2_1`
    58  - `gitlab_8_12_6`
    59  - `redmine_3_3_1`
    60  - `nginx_1_10_2`
    61  
    62  ## Bundles
    63  
    64  Lightsail currently supports the following Bundle IDs:
    65  
    66  - `nano_1_0`
    67  - `micro_1_0`
    68  - `small_1_0`
    69  - `medium_1_0`
    70  - `large_1_0`
    71  
    72  ## Attributes Reference
    73  
    74  The following attributes are exported in addition to the arguments listed above:
    75  
    76  * `id` - The ARN of the Lightsail instance (matches `arn`).
    77  * `arn` - The ARN of the Lightsail instance (matches `id`).
    78  * `availability_zone`
    79  * `blueprint_id`
    80  * `bundle_id`
    81  * `key_pair_name`
    82  * `user_data`
    83  
    84  ## Import
    85  
    86  Lightsail Instances can be imported using their ARN, e.g.
    87  
    88  ```
    89  $ terraform import aws_lightsail_instance.bar <arn>
    90  ```