Resource Type: ec2_instance

Defined in:

lib/puppet/type/ec2_instance.rb

Providers:

v2

Overview

Type representing an EC2 instance.

Properties

• availability_zone

  The availability zone in which to place the instance.

• block_devices

  A list of block devices to associate with the instance

• ebs_optimized (defaults to: false)

  Whether or not to use obtimized storage for the instance.

  Supported values:

  • true
  • false
• ensure
  Supported values:

  • present
  • absent
  • running
  • stopped
• hypervisor

  The type of hypervisor running the instance.

• iam_instance_profile_arn

  The arn of the amazon IAM role you want the ec2 instance to operate under

• image_id

  The image id to use for the instance.

• instance_id

  The AWS generated id for the instance.

• instance_type

  The type to use for the instance.

• kernel_id

  The ID of the kernel in use by the instance.

• key_name

  The name of the key pair associated with this instance.

• monitoring (defaults to: false)

  Whether or not monitoring is enabled for this instance.

  Supported values:

  • true
  • false
• private_dns_name

  The internal DNS name for the instance.

• private_ip_address

  The private IP address for the instance.

• public_dns_name

  The publicly available DNS name for the instance.

• public_ip_address

  The public IP address for the instance.

• region

  The region in which to launch the instance.

• security_groups

  The security groups to associate the instance.

• subnet

  The VPC subnet to attach the instance to.

• tags

  The tags for the instance.

• virtualization_type

  The underlying virtualization of the instance.

Parameters

• associate_public_ip_address (defaults to: false)

  Whether to assign a public interface in a VPC.

  Supported values:

  • true
  • false
• iam_instance_profile_name

  The name of the amazon IAM role you want the ec2 instance to operate under

• instance_initiated_shutdown_behavior (defaults to: stop)

  Whether the instance stops or terminates when you initiate shutdown from the instance.

  Supported values:

  • stop
  • terminate
• name (namevar)

  The name of the instance.

• provider

  The specific backend to use for this ‘ec2_instance` resource. You will seldom need to specify this — Puppet will usually discover the appropriate provider for your platform.

• user_data

  User data script to execute on new instance.