pub struct SpotInstanceRequestArgs {Show 54 fields
pub ami: Output<Option<String>>,
pub associate_public_ip_address: Output<Option<bool>>,
pub availability_zone: Output<Option<String>>,
pub block_duration_minutes: Output<Option<i32>>,
pub capacity_reservation_specification: Output<Option<SpotInstanceRequestCapacityReservationSpecification>>,
pub cpu_core_count: Output<Option<i32>>,
pub cpu_options: Output<Option<SpotInstanceRequestCpuOptions>>,
pub cpu_threads_per_core: Output<Option<i32>>,
pub credit_specification: Output<Option<SpotInstanceRequestCreditSpecification>>,
pub disable_api_stop: Output<Option<bool>>,
pub disable_api_termination: Output<Option<bool>>,
pub ebs_block_devices: Output<Option<Vec<SpotInstanceRequestEbsBlockDevice>>>,
pub ebs_optimized: Output<Option<bool>>,
pub enable_primary_ipv6: Output<Option<bool>>,
pub enclave_options: Output<Option<SpotInstanceRequestEnclaveOptions>>,
pub ephemeral_block_devices: Output<Option<Vec<SpotInstanceRequestEphemeralBlockDevice>>>,
pub get_password_data: Output<Option<bool>>,
pub hibernation: Output<Option<bool>>,
pub host_id: Output<Option<String>>,
pub host_resource_group_arn: Output<Option<String>>,
pub iam_instance_profile: Output<Option<String>>,
pub instance_initiated_shutdown_behavior: Output<Option<String>>,
pub instance_interruption_behavior: Output<Option<String>>,
pub instance_type: Output<Option<String>>,
pub ipv6_address_count: Output<Option<i32>>,
pub ipv6_addresses: Output<Option<Vec<String>>>,
pub key_name: Output<Option<String>>,
pub launch_group: Output<Option<String>>,
pub launch_template: Output<Option<SpotInstanceRequestLaunchTemplate>>,
pub maintenance_options: Output<Option<SpotInstanceRequestMaintenanceOptions>>,
pub metadata_options: Output<Option<SpotInstanceRequestMetadataOptions>>,
pub monitoring: Output<Option<bool>>,
pub network_interfaces: Output<Option<Vec<SpotInstanceRequestNetworkInterface>>>,
pub placement_group: Output<Option<String>>,
pub placement_partition_number: Output<Option<i32>>,
pub private_dns_name_options: Output<Option<SpotInstanceRequestPrivateDnsNameOptions>>,
pub private_ip: Output<Option<String>>,
pub root_block_device: Output<Option<SpotInstanceRequestRootBlockDevice>>,
pub secondary_private_ips: Output<Option<Vec<String>>>,
pub security_groups: Output<Option<Vec<String>>>,
pub source_dest_check: Output<Option<bool>>,
pub spot_price: Output<Option<String>>,
pub spot_type: Output<Option<String>>,
pub subnet_id: Output<Option<String>>,
pub tags: Output<Option<HashMap<String, String>>>,
pub tenancy: Output<Option<String>>,
pub user_data: Output<Option<String>>,
pub user_data_base64: Output<Option<String>>,
pub user_data_replace_on_change: Output<Option<bool>>,
pub valid_from: Output<Option<String>>,
pub valid_until: Output<Option<String>>,
pub volume_tags: Output<Option<HashMap<String, String>>>,
pub vpc_security_group_ids: Output<Option<Vec<String>>>,
pub wait_for_fulfillment: Output<Option<bool>>,
}
Fields§
§ami: Output<Option<String>>
AMI to use for the instance. Required unless launch_template
is specified and the Launch Template specifes an AMI. If an AMI is specified in the Launch Template, setting ami
will override the AMI specified in the Launch Template.
associate_public_ip_address: Output<Option<bool>>
Whether to associate a public IP address with an instance in a VPC.
availability_zone: Output<Option<String>>
AZ to start the instance in.
block_duration_minutes: Output<Option<i32>>
The required duration for the Spot instances, in minutes. This value must be a multiple of 60 (60, 120, 180, 240, 300, or 360). The duration period starts as soon as your Spot instance receives its instance ID. At the end of the duration period, Amazon EC2 marks the Spot instance for termination and provides a Spot instance termination notice, which gives the instance a two-minute warning before it terminates. Note that you can’t specify an Availability Zone group or a launch group if you specify a duration.
capacity_reservation_specification: Output<Option<SpotInstanceRequestCapacityReservationSpecification>>
Describes an instance’s Capacity Reservation targeting option. See Capacity Reservation Specification below for more details.
NOTE: Changing
cpu_core_count
and/orcpu_threads_per_core
will cause the resource to be destroyed and re-created.
cpu_core_count: Output<Option<i32>>
Sets the number of CPU cores for an instance. This option is only supported on creation of instance type that support CPU Options CPU Cores and Threads Per CPU Core Per Instance Type - specifying this option for unsupported instance types will return an error from the EC2 API.
cpu_options: Output<Option<SpotInstanceRequestCpuOptions>>
The CPU options for the instance. See CPU Options below for more details.
cpu_threads_per_core: Output<Option<i32>>
If set to 1, hyperthreading is disabled on the launched instance. Defaults to 2 if not set. See Optimizing CPU Options for more information.
credit_specification: Output<Option<SpotInstanceRequestCreditSpecification>>
Configuration block for customizing the credit specification of the instance. See Credit Specification below for more details. This provider will only perform drift detection of its value when present in a configuration. Removing this configuration on existing instances will only stop managing it. It will not change the configuration back to the default for the instance type.
disable_api_stop: Output<Option<bool>>
If true, enables EC2 Instance Stop Protection.
disable_api_termination: Output<Option<bool>>
If true, enables EC2 Instance Termination Protection.
ebs_block_devices: Output<Option<Vec<SpotInstanceRequestEbsBlockDevice>>>
One or more configuration blocks with additional EBS block devices to attach to the instance. Block device configurations only apply on resource creation. See Block Devices below for details on attributes and drift detection. When accessing this as an attribute reference, it is a set of objects.
ebs_optimized: Output<Option<bool>>
If true, the launched EC2 instance will be EBS-optimized. Note that if this is not set on an instance type that is optimized by default then this will show as disabled but if the instance type is optimized by default then there is no need to set this and there is no effect to disabling it. See the EBS Optimized section of the AWS User Guide for more information.
enable_primary_ipv6: Output<Option<bool>>
Whether to assign a primary IPv6 Global Unicast Address (GUA) to the instance when launched in a dual-stack or IPv6-only subnet. A primary IPv6 address ensures a consistent IPv6 address for the instance and is automatically assigned by AWS to the ENI. Once enabled, the first IPv6 GUA becomes the primary IPv6 address and cannot be disabled. The primary IPv6 address remains until the instance is terminated or the ENI is detached. Disabling enable_primary_ipv6
after it has been enabled forces recreation of the instance.
enclave_options: Output<Option<SpotInstanceRequestEnclaveOptions>>
Enable Nitro Enclaves on launched instances. See Enclave Options below for more details.
ephemeral_block_devices: Output<Option<Vec<SpotInstanceRequestEphemeralBlockDevice>>>
One or more configuration blocks to customize Ephemeral (also known as “Instance Store”) volumes on the instance. See Block Devices below for details. When accessing this as an attribute reference, it is a set of objects.
get_password_data: Output<Option<bool>>
If true, wait for password data to become available and retrieve it. Useful for getting the administrator password for instances running Microsoft Windows. The password data is exported to the password_data
attribute. See GetPasswordData for more information.
hibernation: Output<Option<bool>>
If true, the launched EC2 instance will support hibernation.
host_id: Output<Option<String>>
ID of a dedicated host that the instance will be assigned to. Use when an instance is to be launched on a specific dedicated host.
host_resource_group_arn: Output<Option<String>>
ARN of the host resource group in which to launch the instances. If you specify an ARN, omit the tenancy
parameter or set it to host
.
iam_instance_profile: Output<Option<String>>
IAM Instance Profile to launch the instance with. Specified as the name of the Instance Profile. Ensure your credentials have the correct permission to assign the instance profile according to the EC2 documentation, notably iam:PassRole
.
instance_initiated_shutdown_behavior: Output<Option<String>>
Shutdown behavior for the instance. Amazon defaults this to stop
for EBS-backed instances and terminate
for instance-store instances. Cannot be set on instance-store instances. See Shutdown Behavior for more information.
instance_interruption_behavior: Output<Option<String>>
Indicates Spot instance behavior when it is interrupted. Valid values are terminate
, stop
, or hibernate
. Default value is terminate
.
instance_type: Output<Option<String>>
Instance type to use for the instance. Required unless launch_template
is specified and the Launch Template specifies an instance type. If an instance type is specified in the Launch Template, setting instance_type
will override the instance type specified in the Launch Template. Updates to this field will trigger a stop/start of the EC2 instance.
ipv6_address_count: Output<Option<i32>>
Number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 addresses from the range of your subnet.
ipv6_addresses: Output<Option<Vec<String>>>
Specify one or more IPv6 addresses from the range of the subnet to associate with the primary network interface
key_name: Output<Option<String>>
Key name of the Key Pair to use for the instance; which can be managed using the aws.ec2.KeyPair
resource.
launch_group: Output<Option<String>>
A launch group is a group of spot instances that launch together and terminate together. If left empty instances are launched and terminated individually.
launch_template: Output<Option<SpotInstanceRequestLaunchTemplate>>
Specifies a Launch Template to configure the instance. Parameters configured on this resource will override the corresponding parameters in the Launch Template. See Launch Template Specification below for more details.
maintenance_options: Output<Option<SpotInstanceRequestMaintenanceOptions>>
Maintenance and recovery options for the instance. See Maintenance Options below for more details.
metadata_options: Output<Option<SpotInstanceRequestMetadataOptions>>
Customize the metadata options of the instance. See Metadata Options below for more details.
monitoring: Output<Option<bool>>
If true, the launched EC2 instance will have detailed monitoring enabled. (Available since v0.6.0)
network_interfaces: Output<Option<Vec<SpotInstanceRequestNetworkInterface>>>
Customize network interfaces to be attached at instance boot time. See Network Interfaces below for more details.
placement_group: Output<Option<String>>
Placement Group to start the instance in.
placement_partition_number: Output<Option<i32>>
Number of the partition the instance is in. Valid only if the aws.ec2.PlacementGroup
resource’s strategy
argument is set to "partition"
.
private_dns_name_options: Output<Option<SpotInstanceRequestPrivateDnsNameOptions>>
Options for the instance hostname. The default values are inherited from the subnet. See Private DNS Name Options below for more details.
private_ip: Output<Option<String>>
Private IP address to associate with the instance in a VPC.
root_block_device: Output<Option<SpotInstanceRequestRootBlockDevice>>
Configuration block to customize details about the root block device of the instance. See Block Devices below for details. When accessing this as an attribute reference, it is a list containing one object.
secondary_private_ips: Output<Option<Vec<String>>>
List of secondary private IPv4 addresses to assign to the instance’s primary network interface (eth0) in a VPC. Can only be assigned to the primary network interface (eth0) attached at instance creation, not a pre-existing network interface i.e., referenced in a network_interface
block. Refer to the Elastic network interfaces documentation to see the maximum number of private IP addresses allowed per instance type.
security_groups: Output<Option<Vec<String>>>
List of security group names to associate with.
NOTE: If you are creating Instances in a VPC, use
vpc_security_group_ids
instead.
source_dest_check: Output<Option<bool>>
Controls if traffic is routed to the instance when the destination address does not match the instance. Used for NAT or VPNs. Defaults true.
spot_price: Output<Option<String>>
The maximum price to request on the spot market.
spot_type: Output<Option<String>>
If set to one-time
, after
the instance is terminated, the spot request will be closed.
subnet_id: Output<Option<String>>
VPC Subnet ID to launch in.
Map of tags to assign to the resource. Note that these tags apply to the instance and not block storage devices. If configured with a provider default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
tenancy: Output<Option<String>>
Tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated
runs on single-tenant hardware. The host
tenancy is not supported for the import-instance command. Valid values are default
, dedicated
, and host
.
user_data: Output<Option<String>>
User data to provide when launching the instance. Do not pass gzip-compressed data via this argument; see user_data_base64
instead. Updates to this field will trigger a stop/start of the EC2 instance by default. If the user_data_replace_on_change
is set then updates to this field will trigger a destroy and recreate of the EC2 instance.
user_data_base64: Output<Option<String>>
Can be used instead of user_data
to pass base64-encoded binary data directly. Use this instead of user_data
whenever the value is not a valid UTF-8 string. For example, gzip-encoded user data must be base64-encoded and passed via this argument to avoid corruption. Updates to this field will trigger a stop/start of the EC2 instance by default. If the user_data_replace_on_change
is set then updates to this field will trigger a destroy and recreate of the EC2 instance.
user_data_replace_on_change: Output<Option<bool>>
When used in combination with user_data
or user_data_base64
will trigger a destroy and recreate of the EC2 instance when set to true
. Defaults to false
if not set.
valid_from: Output<Option<String>>
The start date and time of the request, in UTC RFC3339 format(for example, YYYY-MM-DDTHH:MM:SSZ). The default is to start fulfilling the request immediately.
valid_until: Output<Option<String>>
The end date and time of the request, in UTC RFC3339 format(for example, YYYY-MM-DDTHH:MM:SSZ). At this point, no new Spot instance requests are placed or enabled to fulfill the request. The default end date is 7 days from the current date.
Map of tags to assign, at instance-creation time, to root and EBS volumes.
NOTE: Do not use
volume_tags
if you plan to manage block device tags outside theaws.ec2.Instance
configuration, such as usingtags
in anaws.ebs.Volume
resource attached viaaws.ec2.VolumeAttachment
. Doing so will result in resource cycling and inconsistent behavior.
vpc_security_group_ids: Output<Option<Vec<String>>>
List of security group IDs to associate with.
wait_for_fulfillment: Output<Option<bool>>
If set, this provider will wait for the Spot Request to be fulfilled, and will throw an error if the timeout of 10m is reached.
Implementations§
source§impl SpotInstanceRequestArgs
impl SpotInstanceRequestArgs
sourcepub fn builder() -> SpotInstanceRequestArgsBuilder
pub fn builder() -> SpotInstanceRequestArgsBuilder
Create an instance of SpotInstanceRequestArgs
using the builder syntax
Trait Implementations§
source§impl Clone for SpotInstanceRequestArgs
impl Clone for SpotInstanceRequestArgs
source§fn clone(&self) -> SpotInstanceRequestArgs
fn clone(&self) -> SpotInstanceRequestArgs
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreAuto Trait Implementations§
impl Freeze for SpotInstanceRequestArgs
impl RefUnwindSafe for SpotInstanceRequestArgs
impl Send for SpotInstanceRequestArgs
impl Sync for SpotInstanceRequestArgs
impl Unpin for SpotInstanceRequestArgs
impl UnwindSafe for SpotInstanceRequestArgs
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)