Class: Ansible::Ruby::Modules::Ec2

Inherits:
Base show all
Defined in:
lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb

Instance Method Summary collapse

Methods inherited from Base

#ansible_name, #to_h

Methods inherited from Ansible::Ruby::Models::Base

attr_option, attr_options, attribute, #initialize, #to_h, validates

Constructor Details

This class inherits a constructor from Ansible::Ruby::Models::Base

Instance Method Details

#assign_public_ip ⇒ :yes, ...

Returns when provisioning within vpc, assign a public IP address. Boto library must be 2.13.0+.

Returns:

  • (:yes, :no, nil) —

    when provisioning within vpc, assign a public IP address. Boto library must be 2.13.0+



89
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 89

attribute :assign_public_ip

#count ⇒ Integer?

Returns number of instances to launch.

Returns:

  • (Integer, nil) —

    number of instances to launch



67
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 67

attribute :count

#count_tag ⇒ Array<String>, ...

Returns Used with ‘exact_count’ to determine how many nodes based on a specific tag criteria should be running. This can be expressed in multiple ways and is shown in the EXAMPLES section. For instance, one can request 25 servers that are tagged with “class=webserver”. The specified tag must already exist or be passed in as the ‘instance_tags’ option.

Returns:

  • (Array<String>, String, nil) —

    Used with ‘exact_count’ to determine how many nodes based on a specific tag criteria should be running. This can be expressed in multiple ways and is shown in the EXAMPLES section. For instance, one can request 25 servers that are tagged with “class=webserver”. The specified tag must already exist or be passed in as the ‘instance_tags’ option.



127
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 127

attribute :count_tag

#ebs_optimized ⇒ String?

Returns whether instance is using optimized EBS volumes, see U(docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSOptimized.html).

Returns:



119
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 119

attribute :ebs_optimized

#exact_count ⇒ Integer?

Returns An integer value which indicates how many instances that match the ‘count_tag’ parameter should be running. Instances are either created or terminated based on this value.

Returns:

  • (Integer, nil) —

    An integer value which indicates how many instances that match the ‘count_tag’ parameter should be running. Instances are either created or terminated based on this value.



123
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 123

attribute :exact_count

#group ⇒ Array<String>, ...

Returns security group (or list of groups) to use with the instance.

Returns:

  • (Array<String>, String, nil) —

    security group (or list of groups) to use with the instance



14
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 14

attribute :group

#group_id ⇒ String?

Returns security group id (or list of ids) to use with the instance.

Returns:

  • (String, nil) —

    security group id (or list of ids) to use with the instance



18
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 18

attribute :group_id

#image ⇒ String

Returns I(ami) ID to use for the instance.

Returns:

  • (String) —

    I(ami) ID to use for the instance



45
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 45

attribute :image

#instance_ids ⇒ Array<String>, ...

Returns list of instance ids, currently used for states: absent, running, stopped.

Returns:

  • (Array<String>, String, nil) —

    list of instance ids, currently used for states: absent, running, stopped



99
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 99

attribute :instance_ids

#instance_profile_name ⇒ Object?

Returns Name of the IAM instance profile to use. Boto library must be 2.5.0+.

Returns:

  • (Object, nil) —

    Name of the IAM instance profile to use. Boto library must be 2.5.0+



96
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 96

attribute :instance_profile_name

#instance_tags ⇒ Hash?

Returns a hash/dictionary of tags to add to the new instance or for starting/stopping instance by tag; ‘“key”:“value”’ and ‘“key”:“value”,“key”:“value”’.

Returns:

  • (Hash, nil) —

    a hash/dictionary of tags to add to the new instance or for starting/stopping instance by tag; ‘“key”:“value”’ and ‘“key”:“value”,“key”:“value”’



78
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 78

attribute :instance_tags

#instance_type ⇒ String

Returns instance type to use for the instance, see U(docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html).

Returns:



29
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 29

attribute :instance_type

#kernel ⇒ Object?

Returns kernel I(eki) to use for the instance.

Returns:

  • (Object, nil) —

    kernel I(eki) to use for the instance



49
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 49

attribute :kernel

#key_name ⇒ String?

Returns key pair to use on the instance.

Returns:

  • (String, nil) —

    key pair to use on the instance



10
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 10

attribute :key_name

#monitoring ⇒ :yes, ...

Returns enable detailed monitoring (CloudWatch) for instance.

Returns:

  • (:yes, :no, nil) —

    enable detailed monitoring (CloudWatch) for instance



71
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 71

attribute :monitoring

#network_interfaces ⇒ Array<String>, ...

Returns A list of existing network interfaces to attach to the instance at launch. When specifying existing network interfaces, none of the assign_public_ip, private_ip, vpc_subnet_id, group, or group_id parameters may be used. (Those parameters are for creating a new network interface at launch.).

Returns:

  • (Array<String>, String, nil) —

    A list of existing network interfaces to attach to the instance at launch. When specifying existing network interfaces, none of the assign_public_ip, private_ip, vpc_subnet_id, group, or group_id parameters may be used. (Those parameters are for creating a new network interface at launch.)



131
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 131

attribute :network_interfaces

#placement_group ⇒ Object?

Returns placement group for the instance when using EC2 Clustered Compute.

Returns:

  • (Object, nil) —

    placement group for the instance when using EC2 Clustered Compute



82
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 82

attribute :placement_group

#private_ip ⇒ Object?

Returns the private ip address to assign the instance (from the vpc subnet).

Returns:

  • (Object, nil) —

    the private ip address to assign the instance (from the vpc subnet)



93
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 93

attribute :private_ip

#ramdisk ⇒ Object?

Returns ramdisk I(eri) to use for the instance.

Returns:

  • (Object, nil) —

    ramdisk I(eri) to use for the instance



52
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 52

attribute :ramdisk

#region ⇒ String?

Returns The AWS region to use. Must be specified if ec2_url is not used. If not specified then the value of the EC2_REGION environment variable, if any, is used. See U(docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region).

Returns:



22
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 22

attribute :region

#source_dest_check ⇒ Boolean?

Returns Enable or Disable the Source/Destination checks (for NAT instances and Virtual Routers).

Returns:

  • (Boolean, nil) —

    Enable or Disable the Source/Destination checks (for NAT instances and Virtual Routers)



103
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 103

attribute :source_dest_check

#spot_launch_group ⇒ String?

Returns Launch group for spot request, see U(docs.aws.amazon.com/AWSEC2/latest/UserGuide/how-spot-instances-work.html#spot-launch-group).

Returns:



135
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 135

attribute :spot_launch_group

#spot_price ⇒ Float?

Returns Maximum spot price to bid, If not set a regular on-demand instance is requested. A spot request is made with this maximum bid. When it is filled, the instance is started.

Returns:

  • (Float, nil) —

    Maximum spot price to bid, If not set a regular on-demand instance is requested. A spot request is made with this maximum bid. When it is filled, the instance is started.



37
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 37

attribute :spot_price

#spot_type ⇒ :"one-time", ...

Returns Type of spot request; one of “one-time” or “persistent”. Defaults to “one-time” if not supplied.

Returns:

  • (:"one-time", :persistent, nil) —

    Type of spot request; one of “one-time” or “persistent”. Defaults to “one-time” if not supplied.



41
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 41

attribute :spot_type

#spot_wait_timeout ⇒ Integer?

Returns how long to wait for the spot instance request to be fulfilled.

Returns:

  • (Integer, nil) —

    how long to wait for the spot instance request to be fulfilled



63
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 63

attribute :spot_wait_timeout

#state ⇒ :present, ...

Returns create or terminate instances.

Returns:

  • (:present, :absent, :running, :stopped, nil) —

    create or terminate instances



111
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 111

attribute :state

#tenancy ⇒ :default, ...

Returns An instance with a tenancy of “dedicated” runs on single-tenant hardware and can only be launched into a VPC. Note that to use dedicated tenancy you MUST specify a vpc_subnet_id as well. Dedicated tenancy is not available for EC2 “micro” instances.

Returns:

  • (:default, :dedicated, nil) —

    An instance with a tenancy of “dedicated” runs on single-tenant hardware and can only be launched into a VPC. Note that to use dedicated tenancy you MUST specify a vpc_subnet_id as well. Dedicated tenancy is not available for EC2 “micro” instances.



33
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 33

attribute :tenancy

#termination_protection ⇒ Boolean?

Returns Enable or Disable the Termination Protection.

Returns:

  • (Boolean, nil) —

    Enable or Disable the Termination Protection



107
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 107

attribute :termination_protection

#user_data ⇒ Object?

Returns opaque blob of data which is made available to the ec2 instance.

Returns:

  • (Object, nil) —

    opaque blob of data which is made available to the ec2 instance



75
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 75

attribute :user_data

#volumes ⇒ Array<Hash>, ...

Returns a list of hash/dictionaries of volumes to add to the new instance; ‘[“key”:“value”]’; keys allowed are - device_name (str; required), delete_on_termination (bool; False), device_type (deprecated), ephemeral (str), encrypted (bool; False), snapshot (str), volume_type (str), iops (int) - device_type is deprecated use volume_type, iops must be set when volume_type=‘io1’, ephemeral and snapshot are mutually exclusive.

Returns:

  • (Array<Hash>, Hash, nil) —

    a list of hash/dictionaries of volumes to add to the new instance; ‘[“key”:“value”]’; keys allowed are - device_name (str; required), delete_on_termination (bool; False), device_type (deprecated), ephemeral (str), encrypted (bool; False), snapshot (str), volume_type (str), iops (int) - device_type is deprecated use volume_type, iops must be set when volume_type=‘io1’, ephemeral and snapshot are mutually exclusive.



115
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 115

attribute :volumes

#vpc_subnet_id ⇒ String?

Returns the subnet ID in which to launch the instance (VPC).

Returns:

  • (String, nil) —

    the subnet ID in which to launch the instance (VPC)



85
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 85

attribute :vpc_subnet_id

#wait ⇒ :yes, ...

Returns wait for the instance to be ‘running’ before returning. Does not wait for SSH, see ‘wait_for’ example for details.

Returns:

  • (:yes, :no, nil) —

    wait for the instance to be ‘running’ before returning. Does not wait for SSH, see ‘wait_for’ example for details.



55
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 55

attribute :wait

#wait_timeout ⇒ Integer?

Returns how long before wait gives up, in seconds.

Returns:

  • (Integer, nil) —

    how long before wait gives up, in seconds



59
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 59

attribute :wait_timeout

#zone ⇒ Object?

Returns AWS availability zone in which to launch the instance.

Returns:

  • (Object, nil) —

    AWS availability zone in which to launch the instance



26
 
# File 'lib/ansible/ruby/modules/generated/core/cloud/amazon/ec2.rb', line 26

attribute :zone