Class: Aws::EC2::Types::RequestSpotLaunchSpecification

Inherits:

Struct

Object
Struct
Aws::EC2::Types::RequestSpotLaunchSpecification

show all

Includes:: Structure

Defined in:: lib/aws-sdk-ec2/types.rb

Overview

Note:

When making an API call, you may pass RequestSpotLaunchSpecification data as a hash:

{
  security_group_ids: ["String"],
  security_groups: ["String"],
  addressing_type: "String",
  block_device_mappings: [
    {
      device_name: "String",
      virtual_name: "String",
      ebs: {
        encrypted: false,
        delete_on_termination: false,
        iops: 1,
        snapshot_id: "String",
        volume_size: 1,
        volume_type: "standard", # accepts standard, io1, gp2, sc1, st1
      },
      no_device: "String",
    },
  ],
  ebs_optimized: false,
  iam_instance_profile: {
    arn: "String",
    name: "String",
  },
  image_id: "String",
  instance_type: "t1.micro", # accepts t1.micro, t2.nano, t2.micro, t2.small, t2.medium, t2.large, t2.xlarge, t2.2xlarge, m1.small, m1.medium, m1.large, m1.xlarge, m3.medium, m3.large, m3.xlarge, m3.2xlarge, m4.large, m4.xlarge, m4.2xlarge, m4.4xlarge, m4.10xlarge, m4.16xlarge, m2.xlarge, m2.2xlarge, m2.4xlarge, cr1.8xlarge, r3.large, r3.xlarge, r3.2xlarge, r3.4xlarge, r3.8xlarge, r4.large, r4.xlarge, r4.2xlarge, r4.4xlarge, r4.8xlarge, r4.16xlarge, x1.16xlarge, x1.32xlarge, i2.xlarge, i2.2xlarge, i2.4xlarge, i2.8xlarge, i3.large, i3.xlarge, i3.2xlarge, i3.4xlarge, i3.8xlarge, i3.16xlarge, hi1.4xlarge, hs1.8xlarge, c1.medium, c1.xlarge, c3.large, c3.xlarge, c3.2xlarge, c3.4xlarge, c3.8xlarge, c4.large, c4.xlarge, c4.2xlarge, c4.4xlarge, c4.8xlarge, cc1.4xlarge, cc2.8xlarge, g2.2xlarge, g2.8xlarge, g3.4xlarge, g3.8xlarge, g3.16xlarge, cg1.4xlarge, p2.xlarge, p2.8xlarge, p2.16xlarge, d2.xlarge, d2.2xlarge, d2.4xlarge, d2.8xlarge, f1.2xlarge, f1.16xlarge
  kernel_id: "String",
  key_name: "String",
  monitoring: {
    enabled: false, # required
  },
  network_interfaces: [
    {
      associate_public_ip_address: false,
      delete_on_termination: false,
      description: "String",
      device_index: 1,
      groups: ["String"],
      ipv_6_address_count: 1,
      ipv_6_addresses: [
        {
          ipv_6_address: "String",
        },
      ],
      network_interface_id: "String",
      private_ip_address: "String",
      private_ip_addresses: [
        {
          primary: false,
          private_ip_address: "String", # required
        },
      ],
      secondary_private_ip_address_count: 1,
      subnet_id: "String",
    },
  ],
  placement: {
    availability_zone: "String",
    group_name: "String",
    tenancy: "default", # accepts default, dedicated, host
  },
  ramdisk_id: "String",
  subnet_id: "String",
  user_data: "String",
}

Describes the launch specification for an instance.

Instance Attribute Summary collapse

#addressing_type ⇒ String

Deprecated.
#block_device_mappings ⇒ Array<Types::BlockDeviceMapping>

One or more block device mapping entries.
#ebs_optimized ⇒ Boolean

Indicates whether the instance is optimized for EBS I/O.
#iam_instance_profile ⇒ Types::IamInstanceProfileSpecification

The IAM instance profile.
#image_id ⇒ String

The ID of the AMI.
#instance_type ⇒ String

The instance type.
#kernel_id ⇒ String

The ID of the kernel.
#key_name ⇒ String

The name of the key pair.
#monitoring ⇒ Types::RunInstancesMonitoringEnabled

Indicates whether basic or detailed monitoring is enabled for the instance.
#network_interfaces ⇒ Array<Types::InstanceNetworkInterfaceSpecification>

One or more network interfaces.
#placement ⇒ Types::SpotPlacement

The placement information for the instance.
#ramdisk_id ⇒ String

The ID of the RAM disk.
#security_group_ids ⇒ Array<String>

One or more security group IDs.
#security_groups ⇒ Array<String>

One or more security groups.
#subnet_id ⇒ String

The ID of the subnet in which to launch the instance.
#user_data ⇒ String

The user data to make available to the instances.

Instance Attribute Details

#addressing_type ⇒ `String`

Deprecated.

Returns:

(String)

# File 'lib/aws-sdk-ec2/types.rb', line 19805

class RequestSpotLaunchSpecification < Struct.new(
  :security_group_ids,
  :security_groups,
  :addressing_type,
  :block_device_mappings,
  :ebs_optimized,
  :iam_instance_profile,
  :image_id,
  :instance_type,
  :kernel_id,
  :key_name,
  :monitoring,
  :network_interfaces,
  :placement,
  :ramdisk_id,
  :subnet_id,
  :user_data)
  include Aws::Structure
end

#block_device_mappings ⇒ `Array<Types::BlockDeviceMapping>`

One or more block device mapping entries.

Although you can specify encrypted EBS volumes in this block device mapping for your Spot Instances, these volumes are not encrypted.

Returns:

(Array<Types::BlockDeviceMapping>)

# File 'lib/aws-sdk-ec2/types.rb', line 19805

class RequestSpotLaunchSpecification < Struct.new(
  :security_group_ids,
  :security_groups,
  :addressing_type,
  :block_device_mappings,
  :ebs_optimized,
  :iam_instance_profile,
  :image_id,
  :instance_type,
  :kernel_id,
  :key_name,
  :monitoring,
  :network_interfaces,
  :placement,
  :ramdisk_id,
  :subnet_id,
  :user_data)
  include Aws::Structure
end

#ebs_optimized ⇒ `Boolean`

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn’t available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: ‘false`

Returns:

(Boolean)

# File 'lib/aws-sdk-ec2/types.rb', line 19805

class RequestSpotLaunchSpecification < Struct.new(
  :security_group_ids,
  :security_groups,
  :addressing_type,
  :block_device_mappings,
  :ebs_optimized,
  :iam_instance_profile,
  :image_id,
  :instance_type,
  :kernel_id,
  :key_name,
  :monitoring,
  :network_interfaces,
  :placement,
  :ramdisk_id,
  :subnet_id,
  :user_data)
  include Aws::Structure
end

#iam_instance_profile ⇒ `Types::IamInstanceProfileSpecification`

The IAM instance profile.

Returns:

(Types::IamInstanceProfileSpecification)

# File 'lib/aws-sdk-ec2/types.rb', line 19805

class RequestSpotLaunchSpecification < Struct.new(
  :security_group_ids,
  :security_groups,
  :addressing_type,
  :block_device_mappings,
  :ebs_optimized,
  :iam_instance_profile,
  :image_id,
  :instance_type,
  :kernel_id,
  :key_name,
  :monitoring,
  :network_interfaces,
  :placement,
  :ramdisk_id,
  :subnet_id,
  :user_data)
  include Aws::Structure
end

#image_id ⇒ `String`

The ID of the AMI.

Returns:

(String)

# File 'lib/aws-sdk-ec2/types.rb', line 19805

class RequestSpotLaunchSpecification < Struct.new(
  :security_group_ids,
  :security_groups,
  :addressing_type,
  :block_device_mappings,
  :ebs_optimized,
  :iam_instance_profile,
  :image_id,
  :instance_type,
  :kernel_id,
  :key_name,
  :monitoring,
  :network_interfaces,
  :placement,
  :ramdisk_id,
  :subnet_id,
  :user_data)
  include Aws::Structure
end

#instance_type ⇒ `String`

The instance type.

Returns:

(String)

# File 'lib/aws-sdk-ec2/types.rb', line 19805

class RequestSpotLaunchSpecification < Struct.new(
  :security_group_ids,
  :security_groups,
  :addressing_type,
  :block_device_mappings,
  :ebs_optimized,
  :iam_instance_profile,
  :image_id,
  :instance_type,
  :kernel_id,
  :key_name,
  :monitoring,
  :network_interfaces,
  :placement,
  :ramdisk_id,
  :subnet_id,
  :user_data)
  include Aws::Structure
end

#kernel_id ⇒ `String`

The ID of the kernel.

Returns:

(String)

# File 'lib/aws-sdk-ec2/types.rb', line 19805

class RequestSpotLaunchSpecification < Struct.new(
  :security_group_ids,
  :security_groups,
  :addressing_type,
  :block_device_mappings,
  :ebs_optimized,
  :iam_instance_profile,
  :image_id,
  :instance_type,
  :kernel_id,
  :key_name,
  :monitoring,
  :network_interfaces,
  :placement,
  :ramdisk_id,
  :subnet_id,
  :user_data)
  include Aws::Structure
end

#key_name ⇒ `String`

The name of the key pair.

Returns:

(String)

# File 'lib/aws-sdk-ec2/types.rb', line 19805

class RequestSpotLaunchSpecification < Struct.new(
  :security_group_ids,
  :security_groups,
  :addressing_type,
  :block_device_mappings,
  :ebs_optimized,
  :iam_instance_profile,
  :image_id,
  :instance_type,
  :kernel_id,
  :key_name,
  :monitoring,
  :network_interfaces,
  :placement,
  :ramdisk_id,
  :subnet_id,
  :user_data)
  include Aws::Structure
end

#monitoring ⇒ `Types::RunInstancesMonitoringEnabled`

Indicates whether basic or detailed monitoring is enabled for the instance.

Default: Disabled

Returns:

(Types::RunInstancesMonitoringEnabled)

# File 'lib/aws-sdk-ec2/types.rb', line 19805

class RequestSpotLaunchSpecification < Struct.new(
  :security_group_ids,
  :security_groups,
  :addressing_type,
  :block_device_mappings,
  :ebs_optimized,
  :iam_instance_profile,
  :image_id,
  :instance_type,
  :kernel_id,
  :key_name,
  :monitoring,
  :network_interfaces,
  :placement,
  :ramdisk_id,
  :subnet_id,
  :user_data)
  include Aws::Structure
end

#network_interfaces ⇒ `Array<Types::InstanceNetworkInterfaceSpecification>`

One or more network interfaces. If you specify a network interface, you must specify subnet IDs and security group IDs using the network interface.

Returns:

(Array<Types::InstanceNetworkInterfaceSpecification>)

# File 'lib/aws-sdk-ec2/types.rb', line 19805

class RequestSpotLaunchSpecification < Struct.new(
  :security_group_ids,
  :security_groups,
  :addressing_type,
  :block_device_mappings,
  :ebs_optimized,
  :iam_instance_profile,
  :image_id,
  :instance_type,
  :kernel_id,
  :key_name,
  :monitoring,
  :network_interfaces,
  :placement,
  :ramdisk_id,
  :subnet_id,
  :user_data)
  include Aws::Structure
end

#placement ⇒ `Types::SpotPlacement`

The placement information for the instance.

Returns:

(Types::SpotPlacement)

# File 'lib/aws-sdk-ec2/types.rb', line 19805

class RequestSpotLaunchSpecification < Struct.new(
  :security_group_ids,
  :security_groups,
  :addressing_type,
  :block_device_mappings,
  :ebs_optimized,
  :iam_instance_profile,
  :image_id,
  :instance_type,
  :kernel_id,
  :key_name,
  :monitoring,
  :network_interfaces,
  :placement,
  :ramdisk_id,
  :subnet_id,
  :user_data)
  include Aws::Structure
end

#ramdisk_id ⇒ `String`

The ID of the RAM disk.

Returns:

(String)

# File 'lib/aws-sdk-ec2/types.rb', line 19805

class RequestSpotLaunchSpecification < Struct.new(
  :security_group_ids,
  :security_groups,
  :addressing_type,
  :block_device_mappings,
  :ebs_optimized,
  :iam_instance_profile,
  :image_id,
  :instance_type,
  :kernel_id,
  :key_name,
  :monitoring,
  :network_interfaces,
  :placement,
  :ramdisk_id,
  :subnet_id,
  :user_data)
  include Aws::Structure
end

#security_group_ids ⇒ `Array<String>`

One or more security group IDs.

Returns:

(Array<String>)

# File 'lib/aws-sdk-ec2/types.rb', line 19805

class RequestSpotLaunchSpecification < Struct.new(
  :security_group_ids,
  :security_groups,
  :addressing_type,
  :block_device_mappings,
  :ebs_optimized,
  :iam_instance_profile,
  :image_id,
  :instance_type,
  :kernel_id,
  :key_name,
  :monitoring,
  :network_interfaces,
  :placement,
  :ramdisk_id,
  :subnet_id,
  :user_data)
  include Aws::Structure
end

#security_groups ⇒ `Array<String>`

One or more security groups. When requesting instances in a VPC, you must specify the IDs of the security groups. When requesting instances in EC2-Classic, you can specify the names or the IDs of the security groups.

Returns:

(Array<String>)

# File 'lib/aws-sdk-ec2/types.rb', line 19805

class RequestSpotLaunchSpecification < Struct.new(
  :security_group_ids,
  :security_groups,
  :addressing_type,
  :block_device_mappings,
  :ebs_optimized,
  :iam_instance_profile,
  :image_id,
  :instance_type,
  :kernel_id,
  :key_name,
  :monitoring,
  :network_interfaces,
  :placement,
  :ramdisk_id,
  :subnet_id,
  :user_data)
  include Aws::Structure
end

#subnet_id ⇒ `String`

The ID of the subnet in which to launch the instance.

Returns:

(String)

# File 'lib/aws-sdk-ec2/types.rb', line 19805

class RequestSpotLaunchSpecification < Struct.new(
  :security_group_ids,
  :security_groups,
  :addressing_type,
  :block_device_mappings,
  :ebs_optimized,
  :iam_instance_profile,
  :image_id,
  :instance_type,
  :kernel_id,
  :key_name,
  :monitoring,
  :network_interfaces,
  :placement,
  :ramdisk_id,
  :subnet_id,
  :user_data)
  include Aws::Structure
end

#user_data ⇒ `String`

The user data to make available to the instances. If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

Returns:

(String)

# File 'lib/aws-sdk-ec2/types.rb', line 19805

class RequestSpotLaunchSpecification < Struct.new(
  :security_group_ids,
  :security_groups,
  :addressing_type,
  :block_device_mappings,
  :ebs_optimized,
  :iam_instance_profile,
  :image_id,
  :instance_type,
  :kernel_id,
  :key_name,
  :monitoring,
  :network_interfaces,
  :placement,
  :ramdisk_id,
  :subnet_id,
  :user_data)
  include Aws::Structure
end

Class: Aws::EC2::Types::RequestSpotLaunchSpecification

Overview

Instance Attribute Summary collapse

Instance Attribute Details

#addressing_type ⇒ String

#block_device_mappings ⇒ Array<Types::BlockDeviceMapping>

#ebs_optimized ⇒ Boolean

#iam_instance_profile ⇒ Types::IamInstanceProfileSpecification

#image_id ⇒ String

#instance_type ⇒ String

#kernel_id ⇒ String

#key_name ⇒ String

#monitoring ⇒ Types::RunInstancesMonitoringEnabled

#network_interfaces ⇒ Array<Types::InstanceNetworkInterfaceSpecification>

#placement ⇒ Types::SpotPlacement

#ramdisk_id ⇒ String

#security_group_ids ⇒ Array<String>

#security_groups ⇒ Array<String>

#subnet_id ⇒ String

#user_data ⇒ String

#addressing_type ⇒ `String`

#block_device_mappings ⇒ `Array<Types::BlockDeviceMapping>`

#ebs_optimized ⇒ `Boolean`

#iam_instance_profile ⇒ `Types::IamInstanceProfileSpecification`

#image_id ⇒ `String`

#instance_type ⇒ `String`

#kernel_id ⇒ `String`

#key_name ⇒ `String`

#monitoring ⇒ `Types::RunInstancesMonitoringEnabled`

#network_interfaces ⇒ `Array<Types::InstanceNetworkInterfaceSpecification>`

#placement ⇒ `Types::SpotPlacement`

#ramdisk_id ⇒ `String`

#security_group_ids ⇒ `Array<String>`

#security_groups ⇒ `Array<String>`

#subnet_id ⇒ `String`

#user_data ⇒ `String`