Package com.pulumi.aws.ec2

Class InstanceArgs.Builder

  • Enclosing class:
    InstanceArgs
    public static final class InstanceArgs.Builder
extends java.lang.Object

    • Constructor Detail

      • Builder

        public Builder()

    • Method Detail

      • ami

        public InstanceArgs.Builder ami​(@Nullable
                                com.pulumi.core.Output<java.lang.String> ami)
        Parameters:
        ami - 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.
        Returns:
        builder

      • ami

        public InstanceArgs.Builder ami​(java.lang.String ami)
        Parameters:
        ami - 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.
        Returns:
        builder

      • associatePublicIpAddress

        public InstanceArgs.Builder associatePublicIpAddress​(@Nullable
                                                     com.pulumi.core.Output<java.lang.Boolean> associatePublicIpAddress)
        Parameters:
        associatePublicIpAddress - Whether to associate a public IP address with an instance in a VPC.
        Returns:
        builder

      • associatePublicIpAddress

        public InstanceArgs.Builder associatePublicIpAddress​(java.lang.Boolean associatePublicIpAddress)
        Parameters:
        associatePublicIpAddress - Whether to associate a public IP address with an instance in a VPC.
        Returns:
        builder

      • availabilityZone

        public InstanceArgs.Builder availabilityZone​(@Nullable
                                             com.pulumi.core.Output<java.lang.String> availabilityZone)
        Parameters:
        availabilityZone - AZ to start the instance in.
        Returns:
        builder

      • availabilityZone

        public InstanceArgs.Builder availabilityZone​(java.lang.String availabilityZone)
        Parameters:
        availabilityZone - AZ to start the instance in.
        Returns:
        builder

      • capacityReservationSpecification

        public InstanceArgs.Builder capacityReservationSpecification​(@Nullable
                                                             com.pulumi.core.Output<InstanceCapacityReservationSpecificationArgs> capacityReservationSpecification)
        Parameters:
        capacityReservationSpecification - Describes an instance's Capacity Reservation targeting option. See Capacity Reservation Specification below for more details. > **NOTE:** Changing `cpu_core_count` and/or `cpu_threads_per_core` will cause the resource to be destroyed and re-created.
        Returns:
        builder

      • capacityReservationSpecification

        public InstanceArgs.Builder capacityReservationSpecification​(InstanceCapacityReservationSpecificationArgs capacityReservationSpecification)
        Parameters:
        capacityReservationSpecification - Describes an instance's Capacity Reservation targeting option. See Capacity Reservation Specification below for more details. > **NOTE:** Changing `cpu_core_count` and/or `cpu_threads_per_core` will cause the resource to be destroyed and re-created.
        Returns:
        builder

      • cpuCoreCount

        @Deprecated
public InstanceArgs.Builder cpuCoreCount​(@Nullable
                                         com.pulumi.core.Output<java.lang.Integer> cpuCoreCount)
        Deprecated.
        use 'cpu_options' argument instead
        Parameters:
        cpuCoreCount - 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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-optimize-cpu.html#cpu-options-supported-instances-values) - specifying this option for unsupported instance types will return an error from the EC2 API.
        Returns:
        builder

      • cpuCoreCount

        @Deprecated
public InstanceArgs.Builder cpuCoreCount​(java.lang.Integer cpuCoreCount)
        Deprecated.
        use 'cpu_options' argument instead
        Parameters:
        cpuCoreCount - 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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-optimize-cpu.html#cpu-options-supported-instances-values) - specifying this option for unsupported instance types will return an error from the EC2 API.
        Returns:
        builder

      • cpuOptions

        public InstanceArgs.Builder cpuOptions​(@Nullable
                                       com.pulumi.core.Output<InstanceCpuOptionsArgs> cpuOptions)
        Parameters:
        cpuOptions - The CPU options for the instance. See CPU Options below for more details.
        Returns:
        builder

      • cpuThreadsPerCore

        @Deprecated
public InstanceArgs.Builder cpuThreadsPerCore​(@Nullable
                                              com.pulumi.core.Output<java.lang.Integer> cpuThreadsPerCore)
        Deprecated.
        use 'cpu_options' argument instead
        Parameters:
        cpuThreadsPerCore - If set to 1, hyperthreading is disabled on the launched instance. Defaults to 2 if not set. See [Optimizing CPU Options](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-optimize-cpu.html) for more information.
        Returns:
        builder

      • cpuThreadsPerCore

        @Deprecated
public InstanceArgs.Builder cpuThreadsPerCore​(java.lang.Integer cpuThreadsPerCore)
        Deprecated.
        use 'cpu_options' argument instead
        Parameters:
        cpuThreadsPerCore - If set to 1, hyperthreading is disabled on the launched instance. Defaults to 2 if not set. See [Optimizing CPU Options](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-optimize-cpu.html) for more information.
        Returns:
        builder

      • creditSpecification

        public InstanceArgs.Builder creditSpecification​(@Nullable
                                                com.pulumi.core.Output<InstanceCreditSpecificationArgs> creditSpecification)
        Parameters:
        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.
        Returns:
        builder

      • creditSpecification

        public InstanceArgs.Builder creditSpecification​(InstanceCreditSpecificationArgs creditSpecification)
        Parameters:
        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.
        Returns:
        builder

      • disableApiStop

        public InstanceArgs.Builder disableApiStop​(@Nullable
                                           com.pulumi.core.Output<java.lang.Boolean> disableApiStop)
        Parameters:
        disableApiStop - If true, enables [EC2 Instance Stop Protection](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Stop_Start.html#Using_StopProtection).
        Returns:
        builder

      • disableApiStop

        public InstanceArgs.Builder disableApiStop​(java.lang.Boolean disableApiStop)
        Parameters:
        disableApiStop - If true, enables [EC2 Instance Stop Protection](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Stop_Start.html#Using_StopProtection).
        Returns:
        builder

      • disableApiTermination

        public InstanceArgs.Builder disableApiTermination​(@Nullable
                                                  com.pulumi.core.Output<java.lang.Boolean> disableApiTermination)
        Parameters:
        disableApiTermination - If true, enables [EC2 Instance Termination Protection](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html#Using_ChangingDisableAPITermination).
        Returns:
        builder

      • disableApiTermination

        public InstanceArgs.Builder disableApiTermination​(java.lang.Boolean disableApiTermination)
        Parameters:
        disableApiTermination - If true, enables [EC2 Instance Termination Protection](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html#Using_ChangingDisableAPITermination).
        Returns:
        builder

      • ebsBlockDevices

        public InstanceArgs.Builder ebsBlockDevices​(@Nullable
                                            com.pulumi.core.Output<java.util.List<InstanceEbsBlockDeviceArgs>> ebsBlockDevices)
        Parameters:
        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.
        Returns:
        builder

      • ebsBlockDevices

        public InstanceArgs.Builder ebsBlockDevices​(java.util.List<InstanceEbsBlockDeviceArgs> ebsBlockDevices)
        Parameters:
        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.
        Returns:
        builder

      • ebsBlockDevices

        public InstanceArgs.Builder ebsBlockDevices​(InstanceEbsBlockDeviceArgs... ebsBlockDevices)
        Parameters:
        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.
        Returns:
        builder

      • ebsOptimized

        public InstanceArgs.Builder ebsOptimized​(@Nullable
                                         com.pulumi.core.Output<java.lang.Boolean> ebsOptimized)
        Parameters:
        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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSOptimized.html) of the AWS User Guide for more information.
        Returns:
        builder

      • ebsOptimized

        public InstanceArgs.Builder ebsOptimized​(java.lang.Boolean ebsOptimized)
        Parameters:
        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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSOptimized.html) of the AWS User Guide for more information.
        Returns:
        builder

      • enclaveOptions

        public InstanceArgs.Builder enclaveOptions​(@Nullable
                                           com.pulumi.core.Output<InstanceEnclaveOptionsArgs> enclaveOptions)
        Parameters:
        enclaveOptions - Enable Nitro Enclaves on launched instances. See Enclave Options below for more details.
        Returns:
        builder

      • enclaveOptions

        public InstanceArgs.Builder enclaveOptions​(InstanceEnclaveOptionsArgs enclaveOptions)
        Parameters:
        enclaveOptions - Enable Nitro Enclaves on launched instances. See Enclave Options below for more details.
        Returns:
        builder

      • ephemeralBlockDevices

        public InstanceArgs.Builder ephemeralBlockDevices​(@Nullable
                                                  com.pulumi.core.Output<java.util.List<InstanceEphemeralBlockDeviceArgs>> ephemeralBlockDevices)
        Parameters:
        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.
        Returns:
        builder

      • ephemeralBlockDevices

        public InstanceArgs.Builder ephemeralBlockDevices​(java.util.List<InstanceEphemeralBlockDeviceArgs> ephemeralBlockDevices)
        Parameters:
        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.
        Returns:
        builder

      • ephemeralBlockDevices

        public InstanceArgs.Builder ephemeralBlockDevices​(InstanceEphemeralBlockDeviceArgs... ephemeralBlockDevices)
        Parameters:
        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.
        Returns:
        builder

      • getPasswordData

        public InstanceArgs.Builder getPasswordData​(@Nullable
                                            com.pulumi.core.Output<java.lang.Boolean> getPasswordData)
        Parameters:
        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 `password_data` attribute. See [GetPasswordData](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetPasswordData.html) for more information.
        Returns:
        builder

      • getPasswordData

        public InstanceArgs.Builder getPasswordData​(java.lang.Boolean getPasswordData)
        Parameters:
        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 `password_data` attribute. See [GetPasswordData](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetPasswordData.html) for more information.
        Returns:
        builder

      • hibernation

        public InstanceArgs.Builder hibernation​(@Nullable
                                        com.pulumi.core.Output<java.lang.Boolean> hibernation)
        Parameters:
        hibernation - If true, the launched EC2 instance will support hibernation.
        Returns:
        builder

      • hibernation

        public InstanceArgs.Builder hibernation​(java.lang.Boolean hibernation)
        Parameters:
        hibernation - If true, the launched EC2 instance will support hibernation.
        Returns:
        builder

      • hostId

        public InstanceArgs.Builder hostId​(@Nullable
                                   com.pulumi.core.Output<java.lang.String> hostId)
        Parameters:
        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.
        Returns:
        builder

      • hostId

        public InstanceArgs.Builder hostId​(java.lang.String hostId)
        Parameters:
        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.
        Returns:
        builder

      • hostResourceGroupArn

        public InstanceArgs.Builder hostResourceGroupArn​(@Nullable
                                                 com.pulumi.core.Output<java.lang.String> hostResourceGroupArn)
        Parameters:
        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`.
        Returns:
        builder

      • hostResourceGroupArn

        public InstanceArgs.Builder hostResourceGroupArn​(java.lang.String hostResourceGroupArn)
        Parameters:
        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`.
        Returns:
        builder

      • iamInstanceProfile

        public InstanceArgs.Builder iamInstanceProfile​(@Nullable
                                               com.pulumi.core.Output<java.lang.String> iamInstanceProfile)
        Parameters:
        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](http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2.html#roles-usingrole-ec2instance-permissions), notably `iam:PassRole`.
        Returns:
        builder

      • iamInstanceProfile

        public InstanceArgs.Builder iamInstanceProfile​(java.lang.String iamInstanceProfile)
        Parameters:
        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](http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2.html#roles-usingrole-ec2instance-permissions), notably `iam:PassRole`.
        Returns:
        builder

      • instanceInitiatedShutdownBehavior

        public InstanceArgs.Builder instanceInitiatedShutdownBehavior​(@Nullable
                                                              com.pulumi.core.Output<java.lang.String> instanceInitiatedShutdownBehavior)
        Parameters:
        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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html#Using_ChangingInstanceInitiatedShutdownBehavior) for more information.
        Returns:
        builder

      • instanceInitiatedShutdownBehavior

        public InstanceArgs.Builder instanceInitiatedShutdownBehavior​(java.lang.String instanceInitiatedShutdownBehavior)
        Parameters:
        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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html#Using_ChangingInstanceInitiatedShutdownBehavior) for more information.
        Returns:
        builder

      • instanceMarketOptions

        public InstanceArgs.Builder instanceMarketOptions​(@Nullable
                                                  com.pulumi.core.Output<InstanceInstanceMarketOptionsArgs> instanceMarketOptions)
        Parameters:
        instanceMarketOptions - Describes the market (purchasing) option for the instances. See Market Options below for details on attributes.
        Returns:
        builder

      • instanceMarketOptions

        public InstanceArgs.Builder instanceMarketOptions​(InstanceInstanceMarketOptionsArgs instanceMarketOptions)
        Parameters:
        instanceMarketOptions - Describes the market (purchasing) option for the instances. See Market Options below for details on attributes.
        Returns:
        builder

      • instanceType

        public InstanceArgs.Builder instanceType​(@Nullable
                                         com.pulumi.core.Output<com.pulumi.core.Either<java.lang.String,​InstanceType>> instanceType)
        Parameters:
        instanceType - 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.
        Returns:
        builder

      • instanceType

        public InstanceArgs.Builder instanceType​(com.pulumi.core.Either<java.lang.String,​InstanceType> instanceType)
        Parameters:
        instanceType - 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.
        Returns:
        builder

      • instanceType

        public InstanceArgs.Builder instanceType​(java.lang.String instanceType)
        Parameters:
        instanceType - 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.
        Returns:
        builder

      • instanceType

        public InstanceArgs.Builder instanceType​(InstanceType instanceType)
        Parameters:
        instanceType - 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.
        Returns:
        builder

      • ipv6AddressCount

        public InstanceArgs.Builder ipv6AddressCount​(@Nullable
                                             com.pulumi.core.Output<java.lang.Integer> ipv6AddressCount)
        Parameters:
        ipv6AddressCount - Number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 addresses from the range of your subnet.
        Returns:
        builder

      • ipv6AddressCount

        public InstanceArgs.Builder ipv6AddressCount​(java.lang.Integer ipv6AddressCount)
        Parameters:
        ipv6AddressCount - Number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 addresses from the range of your subnet.
        Returns:
        builder

      • ipv6Addresses

        public InstanceArgs.Builder ipv6Addresses​(@Nullable
                                          com.pulumi.core.Output<java.util.List<java.lang.String>> ipv6Addresses)
        Parameters:
        ipv6Addresses - Specify one or more IPv6 addresses from the range of the subnet to associate with the primary network interface
        Returns:
        builder

      • ipv6Addresses

        public InstanceArgs.Builder ipv6Addresses​(java.util.List<java.lang.String> ipv6Addresses)
        Parameters:
        ipv6Addresses - Specify one or more IPv6 addresses from the range of the subnet to associate with the primary network interface
        Returns:
        builder

      • ipv6Addresses

        public InstanceArgs.Builder ipv6Addresses​(java.lang.String... ipv6Addresses)
        Parameters:
        ipv6Addresses - Specify one or more IPv6 addresses from the range of the subnet to associate with the primary network interface
        Returns:
        builder

      • keyName

        public InstanceArgs.Builder keyName​(@Nullable
                                    com.pulumi.core.Output<java.lang.String> keyName)
        Parameters:
        keyName - Key name of the Key Pair to use for the instance; which can be managed using the `aws.ec2.KeyPair` resource.
        Returns:
        builder

      • keyName

        public InstanceArgs.Builder keyName​(java.lang.String keyName)
        Parameters:
        keyName - Key name of the Key Pair to use for the instance; which can be managed using the `aws.ec2.KeyPair` resource.
        Returns:
        builder

      • launchTemplate

        public InstanceArgs.Builder launchTemplate​(@Nullable
                                           com.pulumi.core.Output<InstanceLaunchTemplateArgs> launchTemplate)
        Parameters:
        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.
        Returns:
        builder

      • launchTemplate

        public InstanceArgs.Builder launchTemplate​(InstanceLaunchTemplateArgs launchTemplate)
        Parameters:
        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.
        Returns:
        builder

      • maintenanceOptions

        public InstanceArgs.Builder maintenanceOptions​(@Nullable
                                               com.pulumi.core.Output<InstanceMaintenanceOptionsArgs> maintenanceOptions)
        Parameters:
        maintenanceOptions - Maintenance and recovery options for the instance. See Maintenance Options below for more details.
        Returns:
        builder

      • maintenanceOptions

        public InstanceArgs.Builder maintenanceOptions​(InstanceMaintenanceOptionsArgs maintenanceOptions)
        Parameters:
        maintenanceOptions - Maintenance and recovery options for the instance. See Maintenance Options below for more details.
        Returns:
        builder

      • metadataOptions

        public InstanceArgs.Builder metadataOptions​(@Nullable
                                            com.pulumi.core.Output<InstanceMetadataOptionsArgs> metadataOptions)
        Parameters:
        metadataOptions - Customize the metadata options of the instance. See Metadata Options below for more details.
        Returns:
        builder

      • metadataOptions

        public InstanceArgs.Builder metadataOptions​(InstanceMetadataOptionsArgs metadataOptions)
        Parameters:
        metadataOptions - Customize the metadata options of the instance. See Metadata Options below for more details.
        Returns:
        builder

      • monitoring

        public InstanceArgs.Builder monitoring​(@Nullable
                                       com.pulumi.core.Output<java.lang.Boolean> monitoring)
        Parameters:
        monitoring - If true, the launched EC2 instance will have detailed monitoring enabled. (Available since v0.6.0)
        Returns:
        builder

      • monitoring

        public InstanceArgs.Builder monitoring​(java.lang.Boolean monitoring)
        Parameters:
        monitoring - If true, the launched EC2 instance will have detailed monitoring enabled. (Available since v0.6.0)
        Returns:
        builder

      • networkInterfaces

        public InstanceArgs.Builder networkInterfaces​(@Nullable
                                              com.pulumi.core.Output<java.util.List<InstanceNetworkInterfaceArgs>> networkInterfaces)
        Parameters:
        networkInterfaces - Customize network interfaces to be attached at instance boot time. See Network Interfaces below for more details.
        Returns:
        builder

      • networkInterfaces

        public InstanceArgs.Builder networkInterfaces​(java.util.List<InstanceNetworkInterfaceArgs> networkInterfaces)
        Parameters:
        networkInterfaces - Customize network interfaces to be attached at instance boot time. See Network Interfaces below for more details.
        Returns:
        builder

      • networkInterfaces

        public InstanceArgs.Builder networkInterfaces​(InstanceNetworkInterfaceArgs... networkInterfaces)
        Parameters:
        networkInterfaces - Customize network interfaces to be attached at instance boot time. See Network Interfaces below for more details.
        Returns:
        builder

      • placementGroup

        public InstanceArgs.Builder placementGroup​(@Nullable
                                           com.pulumi.core.Output<java.lang.String> placementGroup)
        Parameters:
        placementGroup - Placement Group to start the instance in.
        Returns:
        builder

      • placementGroup

        public InstanceArgs.Builder placementGroup​(java.lang.String placementGroup)
        Parameters:
        placementGroup - Placement Group to start the instance in.
        Returns:
        builder

      • placementPartitionNumber

        public InstanceArgs.Builder placementPartitionNumber​(@Nullable
                                                     com.pulumi.core.Output<java.lang.Integer> placementPartitionNumber)
        Parameters:
        placementPartitionNumber - Number of the partition the instance is in. Valid only if the `aws.ec2.PlacementGroup` resource's `strategy` argument is set to `"partition"`.
        Returns:
        builder

      • placementPartitionNumber

        public InstanceArgs.Builder placementPartitionNumber​(java.lang.Integer placementPartitionNumber)
        Parameters:
        placementPartitionNumber - Number of the partition the instance is in. Valid only if the `aws.ec2.PlacementGroup` resource's `strategy` argument is set to `"partition"`.
        Returns:
        builder

      • privateDnsNameOptions

        public InstanceArgs.Builder privateDnsNameOptions​(@Nullable
                                                  com.pulumi.core.Output<InstancePrivateDnsNameOptionsArgs> privateDnsNameOptions)
        Parameters:
        privateDnsNameOptions - Options for the instance hostname. The default values are inherited from the subnet. See Private DNS Name Options below for more details.
        Returns:
        builder

      • privateDnsNameOptions

        public InstanceArgs.Builder privateDnsNameOptions​(InstancePrivateDnsNameOptionsArgs privateDnsNameOptions)
        Parameters:
        privateDnsNameOptions - Options for the instance hostname. The default values are inherited from the subnet. See Private DNS Name Options below for more details.
        Returns:
        builder

      • privateIp

        public InstanceArgs.Builder privateIp​(@Nullable
                                      com.pulumi.core.Output<java.lang.String> privateIp)
        Parameters:
        privateIp - Private IP address to associate with the instance in a VPC.
        Returns:
        builder

      • privateIp

        public InstanceArgs.Builder privateIp​(java.lang.String privateIp)
        Parameters:
        privateIp - Private IP address to associate with the instance in a VPC.
        Returns:
        builder

      • rootBlockDevice

        public InstanceArgs.Builder rootBlockDevice​(@Nullable
                                            com.pulumi.core.Output<InstanceRootBlockDeviceArgs> rootBlockDevice)
        Parameters:
        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.
        Returns:
        builder

      • rootBlockDevice

        public InstanceArgs.Builder rootBlockDevice​(InstanceRootBlockDeviceArgs rootBlockDevice)
        Parameters:
        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.
        Returns:
        builder

      • secondaryPrivateIps

        public InstanceArgs.Builder secondaryPrivateIps​(@Nullable
                                                com.pulumi.core.Output<java.util.List<java.lang.String>> secondaryPrivateIps)
        Parameters:
        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 `network_interface` block. Refer to the [Elastic network interfaces documentation](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html#AvailableIpPerENI) to see the maximum number of private IP addresses allowed per instance type.
        Returns:
        builder

      • secondaryPrivateIps

        public InstanceArgs.Builder secondaryPrivateIps​(java.util.List<java.lang.String> secondaryPrivateIps)
        Parameters:
        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 `network_interface` block. Refer to the [Elastic network interfaces documentation](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html#AvailableIpPerENI) to see the maximum number of private IP addresses allowed per instance type.
        Returns:
        builder

      • secondaryPrivateIps

        public InstanceArgs.Builder secondaryPrivateIps​(java.lang.String... secondaryPrivateIps)
        Parameters:
        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 `network_interface` block. Refer to the [Elastic network interfaces documentation](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html#AvailableIpPerENI) to see the maximum number of private IP addresses allowed per instance type.
        Returns:
        builder

      • securityGroups

        @Deprecated
public InstanceArgs.Builder securityGroups​(@Nullable
                                           com.pulumi.core.Output<java.util.List<java.lang.String>> securityGroups)
        Deprecated.
        Use of `securityGroups` is discouraged as it does not allow for changes and will force your instance to be replaced if changes are made. To avoid this, use `vpcSecurityGroupIds` which allows for updates.
        Parameters:
        securityGroups - List of security group names to associate with. > **NOTE:** If you are creating Instances in a VPC, use `vpc_security_group_ids` instead.
        Returns:
        builder

      • securityGroups

        @Deprecated
public InstanceArgs.Builder securityGroups​(java.util.List<java.lang.String> securityGroups)
        Deprecated.
        Use of `securityGroups` is discouraged as it does not allow for changes and will force your instance to be replaced if changes are made. To avoid this, use `vpcSecurityGroupIds` which allows for updates.
        Parameters:
        securityGroups - List of security group names to associate with. > **NOTE:** If you are creating Instances in a VPC, use `vpc_security_group_ids` instead.
        Returns:
        builder

      • securityGroups

        @Deprecated
public InstanceArgs.Builder securityGroups​(java.lang.String... securityGroups)
        Deprecated.
        Use of `securityGroups` is discouraged as it does not allow for changes and will force your instance to be replaced if changes are made. To avoid this, use `vpcSecurityGroupIds` which allows for updates.
        Parameters:
        securityGroups - List of security group names to associate with. > **NOTE:** If you are creating Instances in a VPC, use `vpc_security_group_ids` instead.
        Returns:
        builder

      • sourceDestCheck

        public InstanceArgs.Builder sourceDestCheck​(@Nullable
                                            com.pulumi.core.Output<java.lang.Boolean> sourceDestCheck)
        Parameters:
        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.
        Returns:
        builder

      • sourceDestCheck

        public InstanceArgs.Builder sourceDestCheck​(java.lang.Boolean sourceDestCheck)
        Parameters:
        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.
        Returns:
        builder

      • subnetId

        public InstanceArgs.Builder subnetId​(@Nullable
                                     com.pulumi.core.Output<java.lang.String> subnetId)
        Parameters:
        subnetId - VPC Subnet ID to launch in.
        Returns:
        builder

      • subnetId

        public InstanceArgs.Builder subnetId​(java.lang.String subnetId)
        Parameters:
        subnetId - VPC Subnet ID to launch in.
        Returns:
        builder

      • tags

        public InstanceArgs.Builder tags​(@Nullable
                                 com.pulumi.core.Output<java.util.Map<java.lang.String,​java.lang.String>> tags)
        Parameters:
        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 `default_tags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
        Returns:
        builder

      • tags

        public InstanceArgs.Builder tags​(java.util.Map<java.lang.String,​java.lang.String> tags)
        Parameters:
        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 `default_tags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
        Returns:
        builder

      • tenancy

        public InstanceArgs.Builder tenancy​(@Nullable
                                    com.pulumi.core.Output<com.pulumi.core.Either<java.lang.String,​Tenancy>> tenancy)
        Parameters:
        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`.
        Returns:
        builder

      • tenancy

        public InstanceArgs.Builder tenancy​(com.pulumi.core.Either<java.lang.String,​Tenancy> tenancy)
        Parameters:
        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`.
        Returns:
        builder

      • tenancy

        public InstanceArgs.Builder tenancy​(java.lang.String tenancy)
        Parameters:
        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`.
        Returns:
        builder

      • tenancy

        public InstanceArgs.Builder tenancy​(Tenancy tenancy)
        Parameters:
        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`.
        Returns:
        builder

      • userData

        public InstanceArgs.Builder userData​(@Nullable
                                     com.pulumi.core.Output<java.lang.String> userData)
        Parameters:
        userData - 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.
        Returns:
        builder

      • userData

        public InstanceArgs.Builder userData​(java.lang.String userData)
        Parameters:
        userData - 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.
        Returns:
        builder

      • userDataBase64

        public InstanceArgs.Builder userDataBase64​(@Nullable
                                           com.pulumi.core.Output<java.lang.String> userDataBase64)
        Parameters:
        userDataBase64 - 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.
        Returns:
        builder

      • userDataBase64

        public InstanceArgs.Builder userDataBase64​(java.lang.String userDataBase64)
        Parameters:
        userDataBase64 - 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.
        Returns:
        builder

      • userDataReplaceOnChange

        public InstanceArgs.Builder userDataReplaceOnChange​(@Nullable
                                                    com.pulumi.core.Output<java.lang.Boolean> userDataReplaceOnChange)
        Parameters:
        userDataReplaceOnChange - When used in combination with `user_data` or `user_data_base64` will trigger a destroy and recreate when set to `true`. Defaults to `false` if not set.
        Returns:
        builder

      • userDataReplaceOnChange

        public InstanceArgs.Builder userDataReplaceOnChange​(java.lang.Boolean userDataReplaceOnChange)
        Parameters:
        userDataReplaceOnChange - When used in combination with `user_data` or `user_data_base64` will trigger a destroy and recreate when set to `true`. Defaults to `false` if not set.
        Returns:
        builder

      • volumeTags

        public InstanceArgs.Builder volumeTags​(@Nullable
                                       com.pulumi.core.Output<java.util.Map<java.lang.String,​java.lang.String>> volumeTags)
        Parameters:
        volumeTags - 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 the `aws.ec2.Instance` configuration, such as using `tags` in an `aws.ebs.Volume` resource attached via `aws.ec2.VolumeAttachment`. Doing so will result in resource cycling and inconsistent behavior.
        Returns:
        builder

      • volumeTags

        public InstanceArgs.Builder volumeTags​(java.util.Map<java.lang.String,​java.lang.String> volumeTags)
        Parameters:
        volumeTags - 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 the `aws.ec2.Instance` configuration, such as using `tags` in an `aws.ebs.Volume` resource attached via `aws.ec2.VolumeAttachment`. Doing so will result in resource cycling and inconsistent behavior.
        Returns:
        builder

      • vpcSecurityGroupIds

        public InstanceArgs.Builder vpcSecurityGroupIds​(@Nullable
                                                com.pulumi.core.Output<java.util.List<java.lang.String>> vpcSecurityGroupIds)
        Parameters:
        vpcSecurityGroupIds - List of security group IDs to associate with.
        Returns:
        builder

      • vpcSecurityGroupIds

        public InstanceArgs.Builder vpcSecurityGroupIds​(java.util.List<java.lang.String> vpcSecurityGroupIds)
        Parameters:
        vpcSecurityGroupIds - List of security group IDs to associate with.
        Returns:
        builder

      • vpcSecurityGroupIds

        public InstanceArgs.Builder vpcSecurityGroupIds​(java.lang.String... vpcSecurityGroupIds)
        Parameters:
        vpcSecurityGroupIds - List of security group IDs to associate with.
        Returns:
        builder