SpotInstanceRequestState constructor

Creates a new SpotInstanceRequestState. ami AMI to use for the instance. Required unless launchTemplate 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. arn Optional. associatePublicIpAddress Whether to associate a public IP address with an instance in a VPC. availabilityZone AZ to start the instance in. capacityReservationSpecification Describes an instance's Capacity Reservation targeting option. See Capacity Reservation Specification below for more details. cpuOptions The CPU options for the instance. See CPU Options below for more details. creditSpecification 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. disableApiStop If true, enables EC2 Instance Stop Protection. disableApiTermination If true, enables EC2 Instance Termination Protection. ebsBlockDevices 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. ebsOptimized 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. enablePrimaryIpv6 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 enablePrimaryIpv6 after it has been enabled forces recreation of the instance. enclaveOptions Enable Nitro Enclaves on launched instances. See Enclave Options below for more details. ephemeralBlockDevices 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. forceDestroy Destroys instance even if disableApiTermination or disableApiStop is set to true. Defaults to false. Once this parameter is set to true, a successful pulumi up run before a destroy is required to update this value in the resource state. Without a successful pulumi up after this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the instance or destroying the instance, this flag will not work. Additionally when importing an instance, a successful pulumi up is required to set this value in state before it will take effect on a destroy operation. getPasswordData 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 passwordData attribute. See GetPasswordData for more information. hibernation If true, the launched EC2 instance will support hibernation. hostId 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. hostResourceGroupArn 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. iamInstanceProfile 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. instanceInitiatedShutdownBehavior 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. instanceInterruptionBehavior Indicates Spot instance behavior when it is interrupted. Valid values are terminate, stop, or hibernate. Default value is terminate. instanceState Optional. instanceType Instance type to use for the instance. Required unless launchTemplate is specified and the Launch Template specifies an instance type. If an instance type is specified in the Launch Template, setting instanceType will override the instance type specified in the Launch Template. Updates to this field will trigger a stop/start of the EC2 instance. ipv6AddressCount Number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 addresses from the range of your subnet. ipv6Addresses Specify one or more IPv6 addresses from the range of the subnet to associate with the primary network interface keyName Key name of the Key Pair to use for the instance; which can be managed using the aws.ec2.KeyPair resource. launchGroup A launch group is a group of spot instances that launch together and terminate together. launchTemplate 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. maintenanceOptions Maintenance and recovery options for the instance. See Maintenance Options below for more details. metadataOptions Customize the metadata options of the instance. See Metadata Options below for more details. monitoring If true, the launched EC2 instance will have detailed monitoring enabled. (Available since v0.6.0) networkInterfaces Customize network interfaces to be attached at instance boot time. See Network Interfaces below for more details. outpostArn Optional. passwordData Optional. placementGroup Placement Group to start the instance in. Conflicts with placementGroupId. placementGroupId Placement Group ID to start the instance in. Conflicts with placementGroup. placementPartitionNumber Number of the partition the instance is in. Valid only if the aws.ec2.PlacementGroup resource's strategy argument is set to "partition". primaryNetworkInterfaceId Optional. primaryNetworkInterfaces The primary network interface. See Primary Network Interface below. privateDns The private DNS name assigned to the instance. Can only be privateDnsNameOptions Options for the instance hostname. The default values are inherited from the subnet. See Private DNS Name Options below for more details. privateIp Private IP address to associate with the instance in a VPC. publicDns The public DNS name assigned to the instance. For EC2-VPC, this publicIp The public IP address assigned to the instance, if applicable. region Region where this resource will be managed. Defaults to the Region set in the provider configuration. rootBlockDevice 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. secondaryNetworkInterfaces One or more secondary network interfaces to attach to the instance at launch time. See Secondary Network Interface below for more details. secondaryPrivateIps 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 networkInterface block. Refer to the Elastic network interfaces documentation to see the maximum number of private IP addresses allowed per instance type. securityGroups List of security group names to associate with. sourceDestCheck Controls if traffic is routed to the instance when the destination address does not match the instance. Used for NAT or VPNs. Defaults true. spotBidStatus The current [bid spotInstanceId The Instance ID (if any) that is currently fulfilling spotPrice The maximum price to request on the spot market. spotRequestState The current [request spotType If set to one-time, after subnetId VPC Subnet ID to launch in. tags 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 defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level. tagsAll A map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block. tenancy 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. userData User data to provide when launching the instance. Do not pass gzip-compressed data via this argument; see userDataBase64 instead. Updates to this field will trigger a stop/start of the EC2 instance by default. If the userDataReplaceOnChange is set then updates to this field will trigger a destroy and recreate of the EC2 instance. userDataBase64 Can be used instead of userData to pass base64-encoded binary data directly. Use this instead of userData 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 userDataReplaceOnChange is set then updates to this field will trigger a destroy and recreate of the EC2 instance. userDataReplaceOnChange When used in combination with userData or userDataBase64 will trigger a destroy and recreate of the EC2 instance when set to true. Defaults to false if not set. validFrom 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. validUntil 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. volumeTags Map of tags to assign, at instance-creation time, to root and EBS volumes. vpcSecurityGroupIds List of security group IDs to associate with. waitForFulfillment If set, this provider will