We recommend new projects start with resources from the AWS provider.
aws-native.ec2.Instance
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
Resource Type definition for AWS::EC2::Instance
Create Instance Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Instance(name: string, args?: InstanceArgs, opts?: CustomResourceOptions);@overload
def Instance(resource_name: str,
             args: Optional[InstanceArgs] = None,
             opts: Optional[ResourceOptions] = None)
@overload
def Instance(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             additional_info: Optional[str] = None,
             affinity: Optional[InstanceAffinity] = None,
             availability_zone: Optional[str] = None,
             block_device_mappings: Optional[Sequence[InstanceBlockDeviceMappingArgs]] = None,
             cpu_options: Optional[CpuOptionsPropertiesArgs] = None,
             credit_specification: Optional[CreditSpecificationPropertiesArgs] = None,
             disable_api_termination: Optional[bool] = None,
             ebs_optimized: Optional[bool] = None,
             elastic_gpu_specifications: Optional[Sequence[InstanceElasticGpuSpecificationArgs]] = None,
             elastic_inference_accelerators: Optional[Sequence[InstanceElasticInferenceAcceleratorArgs]] = None,
             enclave_options: Optional[EnclaveOptionsPropertiesArgs] = None,
             hibernation_options: Optional[HibernationOptionsPropertiesArgs] = None,
             host_id: Optional[str] = None,
             host_resource_group_arn: Optional[str] = None,
             iam_instance_profile: Optional[str] = None,
             image_id: Optional[str] = None,
             instance_initiated_shutdown_behavior: Optional[str] = None,
             instance_type: Optional[str] = None,
             ipv6_address_count: Optional[int] = None,
             ipv6_addresses: Optional[Sequence[InstanceIpv6AddressArgs]] = None,
             kernel_id: Optional[str] = None,
             key_name: Optional[str] = None,
             launch_template: Optional[InstanceLaunchTemplateSpecificationArgs] = None,
             license_specifications: Optional[Sequence[InstanceLicenseSpecificationArgs]] = None,
             monitoring: Optional[bool] = None,
             network_interfaces: Optional[Sequence[InstanceNetworkInterfaceArgs]] = None,
             placement_group_name: Optional[str] = None,
             private_dns_name_options: Optional[InstancePrivateDnsNameOptionsArgs] = None,
             private_ip_address: Optional[str] = None,
             propagate_tags_to_volume_on_creation: Optional[bool] = None,
             ramdisk_id: Optional[str] = None,
             security_group_ids: Optional[Sequence[str]] = None,
             security_groups: Optional[Sequence[str]] = None,
             source_dest_check: Optional[bool] = None,
             ssm_associations: Optional[Sequence[InstanceSsmAssociationArgs]] = None,
             subnet_id: Optional[str] = None,
             tags: Optional[Sequence[_root_inputs.TagArgs]] = None,
             tenancy: Optional[str] = None,
             user_data: Optional[str] = None,
             volumes: Optional[Sequence[InstanceVolumeArgs]] = None)func NewInstance(ctx *Context, name string, args *InstanceArgs, opts ...ResourceOption) (*Instance, error)public Instance(string name, InstanceArgs? args = null, CustomResourceOptions? opts = null)
public Instance(String name, InstanceArgs args)
public Instance(String name, InstanceArgs args, CustomResourceOptions options)
type: aws-native:ec2:Instance
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args InstanceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args InstanceArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args InstanceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args InstanceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args InstanceArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Instance Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Instance resource accepts the following input properties:
- AdditionalInfo string
- This property is reserved for internal use. If you use it, the stack fails with this error: Bad property set: [Testing this property] (Service: AmazonEC2; Status Code: 400; Error Code: InvalidParameterCombination; Request ID: 0XXXXXX-49c7-4b40-8bcc-76885dcXXXXX).
- Affinity
Pulumi.Aws Native. Ec2. Instance Affinity 
- Indicates whether the instance is associated with a dedicated host. If you want the instance to always restart on the same host on which it was launched, specify host. If you want the instance to restart on any available host, but try to launch onto the last host it ran on (on a best-effort basis), specify default.
- AvailabilityZone string
- The Availability Zone of the instance.
- BlockDevice List<Pulumi.Mappings Aws Native. Ec2. Inputs. Instance Block Device Mapping> 
- The block device mapping entries that defines the block devices to attach to the instance at launch.
- CpuOptions Pulumi.Aws Native. Ec2. Inputs. Cpu Options Properties 
- The CPU options for the instance.
- CreditSpecification Pulumi.Aws Native. Ec2. Inputs. Credit Specification Properties 
- The credit option for CPU usage of the burstable performance instance. Valid values are standard and unlimited.
- DisableApi boolTermination 
- If you set this parameter to true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can.
- EbsOptimized bool
- Indicates whether the instance is optimized for Amazon EBS I/O.
- ElasticGpu List<Pulumi.Specifications Aws Native. Ec2. Inputs. Instance Elastic Gpu Specification> 
- An elastic GPU to associate with the instance.
- ElasticInference List<Pulumi.Accelerators Aws Native. Ec2. Inputs. Instance Elastic Inference Accelerator> 
- An elastic inference accelerator to associate with the instance.
- EnclaveOptions Pulumi.Aws Native. Ec2. Inputs. Enclave Options Properties 
- Indicates whether the instance is enabled for AWS Nitro Enclaves.
- HibernationOptions Pulumi.Aws Native. Ec2. Inputs. Hibernation Options Properties 
- Indicates whether an instance is enabled for hibernation.
- HostId string
- If you specify host for the Affinity property, the ID of a dedicated host that the instance is associated with. If you don't specify an ID, Amazon EC2 launches the instance onto any available, compatible dedicated host in your account.
- HostResource stringGroup Arn 
- The ARN of the host resource group in which to launch the instances. If you specify a host resource group ARN, omit the Tenancy parameter or set it to host.
- IamInstance stringProfile 
- The IAM instance profile.
- ImageId string
- The ID of the AMI. An AMI ID is required to launch an instance and must be specified here or in a launch template.
- InstanceInitiated stringShutdown Behavior 
- Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).
- InstanceType string
- The instance type.
- Ipv6AddressCount int
- [EC2-VPC] The number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 addresses from the range of your subnet.
- Ipv6Addresses
List<Pulumi.Aws Native. Ec2. Inputs. Instance Ipv6Address> 
- [EC2-VPC] The IPv6 addresses from the range of the subnet to associate with the primary network interface.
- KernelId string
- The ID of the kernel.
- KeyName string
- The name of the key pair.
- LaunchTemplate Pulumi.Aws Native. Ec2. Inputs. Instance Launch Template Specification 
- The launch template to use to launch the instances.
- LicenseSpecifications List<Pulumi.Aws Native. Ec2. Inputs. Instance License Specification> 
- The license configurations.
- Monitoring bool
- Specifies whether detailed monitoring is enabled for the instance.
- NetworkInterfaces List<Pulumi.Aws Native. Ec2. Inputs. Instance Network Interface> 
- The network interfaces to associate with the instance.
- PlacementGroup stringName 
- The name of an existing placement group that you want to launch the instance into (cluster | partition | spread).
- PrivateDns Pulumi.Name Options Aws Native. Ec2. Inputs. Instance Private Dns Name Options 
- The options for the instance hostname.
- PrivateIp stringAddress 
- [EC2-VPC] The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet.
- bool
- Indicates whether to assign the tags from the instance to all of the volumes attached to the instance at launch. If you specify true and you assign tags to the instance, those tags are automatically assigned to all of the volumes that you attach to the instance at launch. If you specify false, those tags are not assigned to the attached volumes.
- RamdiskId string
- The ID of the RAM disk to select.
- SecurityGroup List<string>Ids 
- The IDs of the security groups.
- SecurityGroups List<string>
- the names of the security groups. For a nondefault VPC, you must use security group IDs instead.
- SourceDest boolCheck 
- Specifies whether to enable an instance launched in a VPC to perform NAT.
- SsmAssociations List<Pulumi.Aws Native. Ec2. Inputs. Instance Ssm Association> 
- The SSM document and parameter values in AWS Systems Manager to associate with this instance.
- SubnetId string
- [EC2-VPC] The ID of the subnet to launch the instance into.
- 
List<Pulumi.Aws Native. Inputs. Tag> 
- The tags to add to the instance.
- Tenancy string
- The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware.
- UserData string
- The user data to make available to the instance.
- Volumes
List<Pulumi.Aws Native. Ec2. Inputs. Instance Volume> 
- The volumes to attach to the instance.
- AdditionalInfo string
- This property is reserved for internal use. If you use it, the stack fails with this error: Bad property set: [Testing this property] (Service: AmazonEC2; Status Code: 400; Error Code: InvalidParameterCombination; Request ID: 0XXXXXX-49c7-4b40-8bcc-76885dcXXXXX).
- Affinity
InstanceAffinity 
- Indicates whether the instance is associated with a dedicated host. If you want the instance to always restart on the same host on which it was launched, specify host. If you want the instance to restart on any available host, but try to launch onto the last host it ran on (on a best-effort basis), specify default.
- AvailabilityZone string
- The Availability Zone of the instance.
- BlockDevice []InstanceMappings Block Device Mapping Args 
- The block device mapping entries that defines the block devices to attach to the instance at launch.
- CpuOptions CpuOptions Properties Args 
- The CPU options for the instance.
- CreditSpecification CreditSpecification Properties Args 
- The credit option for CPU usage of the burstable performance instance. Valid values are standard and unlimited.
- DisableApi boolTermination 
- If you set this parameter to true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can.
- EbsOptimized bool
- Indicates whether the instance is optimized for Amazon EBS I/O.
- ElasticGpu []InstanceSpecifications Elastic Gpu Specification Args 
- An elastic GPU to associate with the instance.
- ElasticInference []InstanceAccelerators Elastic Inference Accelerator Args 
- An elastic inference accelerator to associate with the instance.
- EnclaveOptions EnclaveOptions Properties Args 
- Indicates whether the instance is enabled for AWS Nitro Enclaves.
- HibernationOptions HibernationOptions Properties Args 
- Indicates whether an instance is enabled for hibernation.
- HostId string
- If you specify host for the Affinity property, the ID of a dedicated host that the instance is associated with. If you don't specify an ID, Amazon EC2 launches the instance onto any available, compatible dedicated host in your account.
- HostResource stringGroup Arn 
- The ARN of the host resource group in which to launch the instances. If you specify a host resource group ARN, omit the Tenancy parameter or set it to host.
- IamInstance stringProfile 
- The IAM instance profile.
- ImageId string
- The ID of the AMI. An AMI ID is required to launch an instance and must be specified here or in a launch template.
- InstanceInitiated stringShutdown Behavior 
- Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).
- InstanceType string
- The instance type.
- Ipv6AddressCount int
- [EC2-VPC] The number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 addresses from the range of your subnet.
- Ipv6Addresses
[]InstanceIpv6Address Args 
- [EC2-VPC] The IPv6 addresses from the range of the subnet to associate with the primary network interface.
- KernelId string
- The ID of the kernel.
- KeyName string
- The name of the key pair.
- LaunchTemplate InstanceLaunch Template Specification Args 
- The launch template to use to launch the instances.
- LicenseSpecifications []InstanceLicense Specification Args 
- The license configurations.
- Monitoring bool
- Specifies whether detailed monitoring is enabled for the instance.
- NetworkInterfaces []InstanceNetwork Interface Args 
- The network interfaces to associate with the instance.
- PlacementGroup stringName 
- The name of an existing placement group that you want to launch the instance into (cluster | partition | spread).
- PrivateDns InstanceName Options Private Dns Name Options Args 
- The options for the instance hostname.
- PrivateIp stringAddress 
- [EC2-VPC] The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet.
- bool
- Indicates whether to assign the tags from the instance to all of the volumes attached to the instance at launch. If you specify true and you assign tags to the instance, those tags are automatically assigned to all of the volumes that you attach to the instance at launch. If you specify false, those tags are not assigned to the attached volumes.
- RamdiskId string
- The ID of the RAM disk to select.
- SecurityGroup []stringIds 
- The IDs of the security groups.
- SecurityGroups []string
- the names of the security groups. For a nondefault VPC, you must use security group IDs instead.
- SourceDest boolCheck 
- Specifies whether to enable an instance launched in a VPC to perform NAT.
- SsmAssociations []InstanceSsm Association Args 
- The SSM document and parameter values in AWS Systems Manager to associate with this instance.
- SubnetId string
- [EC2-VPC] The ID of the subnet to launch the instance into.
- 
TagArgs 
- The tags to add to the instance.
- Tenancy string
- The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware.
- UserData string
- The user data to make available to the instance.
- Volumes
[]InstanceVolume Args 
- The volumes to attach to the instance.
- additionalInfo String
- This property is reserved for internal use. If you use it, the stack fails with this error: Bad property set: [Testing this property] (Service: AmazonEC2; Status Code: 400; Error Code: InvalidParameterCombination; Request ID: 0XXXXXX-49c7-4b40-8bcc-76885dcXXXXX).
- affinity
InstanceAffinity 
- Indicates whether the instance is associated with a dedicated host. If you want the instance to always restart on the same host on which it was launched, specify host. If you want the instance to restart on any available host, but try to launch onto the last host it ran on (on a best-effort basis), specify default.
- availabilityZone String
- The Availability Zone of the instance.
- blockDevice List<InstanceMappings Block Device Mapping> 
- The block device mapping entries that defines the block devices to attach to the instance at launch.
- cpuOptions CpuOptions Properties 
- The CPU options for the instance.
- creditSpecification CreditSpecification Properties 
- The credit option for CPU usage of the burstable performance instance. Valid values are standard and unlimited.
- disableApi BooleanTermination 
- If you set this parameter to true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can.
- ebsOptimized Boolean
- Indicates whether the instance is optimized for Amazon EBS I/O.
- elasticGpu List<InstanceSpecifications Elastic Gpu Specification> 
- An elastic GPU to associate with the instance.
- elasticInference List<InstanceAccelerators Elastic Inference Accelerator> 
- An elastic inference accelerator to associate with the instance.
- enclaveOptions EnclaveOptions Properties 
- Indicates whether the instance is enabled for AWS Nitro Enclaves.
- hibernationOptions HibernationOptions Properties 
- Indicates whether an instance is enabled for hibernation.
- hostId String
- If you specify host for the Affinity property, the ID of a dedicated host that the instance is associated with. If you don't specify an ID, Amazon EC2 launches the instance onto any available, compatible dedicated host in your account.
- hostResource StringGroup Arn 
- The ARN of the host resource group in which to launch the instances. If you specify a host resource group ARN, omit the Tenancy parameter or set it to host.
- iamInstance StringProfile 
- The IAM instance profile.
- imageId String
- The ID of the AMI. An AMI ID is required to launch an instance and must be specified here or in a launch template.
- instanceInitiated StringShutdown Behavior 
- Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).
- instanceType String
- The instance type.
- ipv6AddressCount Integer
- [EC2-VPC] The number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 addresses from the range of your subnet.
- ipv6Addresses
List<InstanceIpv6Address> 
- [EC2-VPC] The IPv6 addresses from the range of the subnet to associate with the primary network interface.
- kernelId String
- The ID of the kernel.
- keyName String
- The name of the key pair.
- launchTemplate InstanceLaunch Template Specification 
- The launch template to use to launch the instances.
- licenseSpecifications List<InstanceLicense Specification> 
- The license configurations.
- monitoring Boolean
- Specifies whether detailed monitoring is enabled for the instance.
- networkInterfaces List<InstanceNetwork Interface> 
- The network interfaces to associate with the instance.
- placementGroup StringName 
- The name of an existing placement group that you want to launch the instance into (cluster | partition | spread).
- privateDns InstanceName Options Private Dns Name Options 
- The options for the instance hostname.
- privateIp StringAddress 
- [EC2-VPC] The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet.
- Boolean
- Indicates whether to assign the tags from the instance to all of the volumes attached to the instance at launch. If you specify true and you assign tags to the instance, those tags are automatically assigned to all of the volumes that you attach to the instance at launch. If you specify false, those tags are not assigned to the attached volumes.
- ramdiskId String
- The ID of the RAM disk to select.
- securityGroup List<String>Ids 
- The IDs of the security groups.
- securityGroups List<String>
- the names of the security groups. For a nondefault VPC, you must use security group IDs instead.
- sourceDest BooleanCheck 
- Specifies whether to enable an instance launched in a VPC to perform NAT.
- ssmAssociations List<InstanceSsm Association> 
- The SSM document and parameter values in AWS Systems Manager to associate with this instance.
- subnetId String
- [EC2-VPC] The ID of the subnet to launch the instance into.
- List<Tag>
- The tags to add to the instance.
- tenancy String
- The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware.
- userData String
- The user data to make available to the instance.
- volumes
List<InstanceVolume> 
- The volumes to attach to the instance.
- additionalInfo string
- This property is reserved for internal use. If you use it, the stack fails with this error: Bad property set: [Testing this property] (Service: AmazonEC2; Status Code: 400; Error Code: InvalidParameterCombination; Request ID: 0XXXXXX-49c7-4b40-8bcc-76885dcXXXXX).
- affinity
InstanceAffinity 
- Indicates whether the instance is associated with a dedicated host. If you want the instance to always restart on the same host on which it was launched, specify host. If you want the instance to restart on any available host, but try to launch onto the last host it ran on (on a best-effort basis), specify default.
- availabilityZone string
- The Availability Zone of the instance.
- blockDevice InstanceMappings Block Device Mapping[] 
- The block device mapping entries that defines the block devices to attach to the instance at launch.
- cpuOptions CpuOptions Properties 
- The CPU options for the instance.
- creditSpecification CreditSpecification Properties 
- The credit option for CPU usage of the burstable performance instance. Valid values are standard and unlimited.
- disableApi booleanTermination 
- If you set this parameter to true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can.
- ebsOptimized boolean
- Indicates whether the instance is optimized for Amazon EBS I/O.
- elasticGpu InstanceSpecifications Elastic Gpu Specification[] 
- An elastic GPU to associate with the instance.
- elasticInference InstanceAccelerators Elastic Inference Accelerator[] 
- An elastic inference accelerator to associate with the instance.
- enclaveOptions EnclaveOptions Properties 
- Indicates whether the instance is enabled for AWS Nitro Enclaves.
- hibernationOptions HibernationOptions Properties 
- Indicates whether an instance is enabled for hibernation.
- hostId string
- If you specify host for the Affinity property, the ID of a dedicated host that the instance is associated with. If you don't specify an ID, Amazon EC2 launches the instance onto any available, compatible dedicated host in your account.
- hostResource stringGroup Arn 
- The ARN of the host resource group in which to launch the instances. If you specify a host resource group ARN, omit the Tenancy parameter or set it to host.
- iamInstance stringProfile 
- The IAM instance profile.
- imageId string
- The ID of the AMI. An AMI ID is required to launch an instance and must be specified here or in a launch template.
- instanceInitiated stringShutdown Behavior 
- Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).
- instanceType string
- The instance type.
- ipv6AddressCount number
- [EC2-VPC] The number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 addresses from the range of your subnet.
- ipv6Addresses
InstanceIpv6Address[] 
- [EC2-VPC] The IPv6 addresses from the range of the subnet to associate with the primary network interface.
- kernelId string
- The ID of the kernel.
- keyName string
- The name of the key pair.
- launchTemplate InstanceLaunch Template Specification 
- The launch template to use to launch the instances.
- licenseSpecifications InstanceLicense Specification[] 
- The license configurations.
- monitoring boolean
- Specifies whether detailed monitoring is enabled for the instance.
- networkInterfaces InstanceNetwork Interface[] 
- The network interfaces to associate with the instance.
- placementGroup stringName 
- The name of an existing placement group that you want to launch the instance into (cluster | partition | spread).
- privateDns InstanceName Options Private Dns Name Options 
- The options for the instance hostname.
- privateIp stringAddress 
- [EC2-VPC] The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet.
- boolean
- Indicates whether to assign the tags from the instance to all of the volumes attached to the instance at launch. If you specify true and you assign tags to the instance, those tags are automatically assigned to all of the volumes that you attach to the instance at launch. If you specify false, those tags are not assigned to the attached volumes.
- ramdiskId string
- The ID of the RAM disk to select.
- securityGroup string[]Ids 
- The IDs of the security groups.
- securityGroups string[]
- the names of the security groups. For a nondefault VPC, you must use security group IDs instead.
- sourceDest booleanCheck 
- Specifies whether to enable an instance launched in a VPC to perform NAT.
- ssmAssociations InstanceSsm Association[] 
- The SSM document and parameter values in AWS Systems Manager to associate with this instance.
- subnetId string
- [EC2-VPC] The ID of the subnet to launch the instance into.
- Tag[]
- The tags to add to the instance.
- tenancy string
- The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware.
- userData string
- The user data to make available to the instance.
- volumes
InstanceVolume[] 
- The volumes to attach to the instance.
- additional_info str
- This property is reserved for internal use. If you use it, the stack fails with this error: Bad property set: [Testing this property] (Service: AmazonEC2; Status Code: 400; Error Code: InvalidParameterCombination; Request ID: 0XXXXXX-49c7-4b40-8bcc-76885dcXXXXX).
- affinity
InstanceAffinity 
- Indicates whether the instance is associated with a dedicated host. If you want the instance to always restart on the same host on which it was launched, specify host. If you want the instance to restart on any available host, but try to launch onto the last host it ran on (on a best-effort basis), specify default.
- availability_zone str
- The Availability Zone of the instance.
- block_device_ Sequence[Instancemappings Block Device Mapping Args] 
- The block device mapping entries that defines the block devices to attach to the instance at launch.
- cpu_options CpuOptions Properties Args 
- The CPU options for the instance.
- credit_specification CreditSpecification Properties Args 
- The credit option for CPU usage of the burstable performance instance. Valid values are standard and unlimited.
- disable_api_ booltermination 
- If you set this parameter to true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can.
- ebs_optimized bool
- Indicates whether the instance is optimized for Amazon EBS I/O.
- elastic_gpu_ Sequence[Instancespecifications Elastic Gpu Specification Args] 
- An elastic GPU to associate with the instance.
- elastic_inference_ Sequence[Instanceaccelerators Elastic Inference Accelerator Args] 
- An elastic inference accelerator to associate with the instance.
- enclave_options EnclaveOptions Properties Args 
- Indicates whether the instance is enabled for AWS Nitro Enclaves.
- hibernation_options HibernationOptions Properties Args 
- Indicates whether an instance is enabled for hibernation.
- host_id str
- If you specify host for the Affinity property, the ID of a dedicated host that the instance is associated with. If you don't specify an ID, Amazon EC2 launches the instance onto any available, compatible dedicated host in your account.
- host_resource_ strgroup_ arn 
- The ARN of the host resource group in which to launch the instances. If you specify a host resource group ARN, omit the Tenancy parameter or set it to host.
- iam_instance_ strprofile 
- The IAM instance profile.
- image_id str
- The ID of the AMI. An AMI ID is required to launch an instance and must be specified here or in a launch template.
- instance_initiated_ strshutdown_ behavior 
- Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).
- instance_type str
- The instance type.
- ipv6_address_ intcount 
- [EC2-VPC] The 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 Sequence[InstanceIpv6Address Args] 
- [EC2-VPC] The IPv6 addresses from the range of the subnet to associate with the primary network interface.
- kernel_id str
- The ID of the kernel.
- key_name str
- The name of the key pair.
- launch_template InstanceLaunch Template Specification Args 
- The launch template to use to launch the instances.
- license_specifications Sequence[InstanceLicense Specification Args] 
- The license configurations.
- monitoring bool
- Specifies whether detailed monitoring is enabled for the instance.
- network_interfaces Sequence[InstanceNetwork Interface Args] 
- The network interfaces to associate with the instance.
- placement_group_ strname 
- The name of an existing placement group that you want to launch the instance into (cluster | partition | spread).
- private_dns_ Instancename_ options Private Dns Name Options Args 
- The options for the instance hostname.
- private_ip_ straddress 
- [EC2-VPC] The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet.
- bool
- Indicates whether to assign the tags from the instance to all of the volumes attached to the instance at launch. If you specify true and you assign tags to the instance, those tags are automatically assigned to all of the volumes that you attach to the instance at launch. If you specify false, those tags are not assigned to the attached volumes.
- ramdisk_id str
- The ID of the RAM disk to select.
- security_group_ Sequence[str]ids 
- The IDs of the security groups.
- security_groups Sequence[str]
- the names of the security groups. For a nondefault VPC, you must use security group IDs instead.
- source_dest_ boolcheck 
- Specifies whether to enable an instance launched in a VPC to perform NAT.
- ssm_associations Sequence[InstanceSsm Association Args] 
- The SSM document and parameter values in AWS Systems Manager to associate with this instance.
- subnet_id str
- [EC2-VPC] The ID of the subnet to launch the instance into.
- 
Sequence[TagArgs] 
- The tags to add to the instance.
- tenancy str
- The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware.
- user_data str
- The user data to make available to the instance.
- volumes
Sequence[InstanceVolume Args] 
- The volumes to attach to the instance.
- additionalInfo String
- This property is reserved for internal use. If you use it, the stack fails with this error: Bad property set: [Testing this property] (Service: AmazonEC2; Status Code: 400; Error Code: InvalidParameterCombination; Request ID: 0XXXXXX-49c7-4b40-8bcc-76885dcXXXXX).
- affinity "default" | "host"
- Indicates whether the instance is associated with a dedicated host. If you want the instance to always restart on the same host on which it was launched, specify host. If you want the instance to restart on any available host, but try to launch onto the last host it ran on (on a best-effort basis), specify default.
- availabilityZone String
- The Availability Zone of the instance.
- blockDevice List<Property Map>Mappings 
- The block device mapping entries that defines the block devices to attach to the instance at launch.
- cpuOptions Property Map
- The CPU options for the instance.
- creditSpecification Property Map
- The credit option for CPU usage of the burstable performance instance. Valid values are standard and unlimited.
- disableApi BooleanTermination 
- If you set this parameter to true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can.
- ebsOptimized Boolean
- Indicates whether the instance is optimized for Amazon EBS I/O.
- elasticGpu List<Property Map>Specifications 
- An elastic GPU to associate with the instance.
- elasticInference List<Property Map>Accelerators 
- An elastic inference accelerator to associate with the instance.
- enclaveOptions Property Map
- Indicates whether the instance is enabled for AWS Nitro Enclaves.
- hibernationOptions Property Map
- Indicates whether an instance is enabled for hibernation.
- hostId String
- If you specify host for the Affinity property, the ID of a dedicated host that the instance is associated with. If you don't specify an ID, Amazon EC2 launches the instance onto any available, compatible dedicated host in your account.
- hostResource StringGroup Arn 
- The ARN of the host resource group in which to launch the instances. If you specify a host resource group ARN, omit the Tenancy parameter or set it to host.
- iamInstance StringProfile 
- The IAM instance profile.
- imageId String
- The ID of the AMI. An AMI ID is required to launch an instance and must be specified here or in a launch template.
- instanceInitiated StringShutdown Behavior 
- Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).
- instanceType String
- The instance type.
- ipv6AddressCount Number
- [EC2-VPC] The number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 addresses from the range of your subnet.
- ipv6Addresses List<Property Map>
- [EC2-VPC] The IPv6 addresses from the range of the subnet to associate with the primary network interface.
- kernelId String
- The ID of the kernel.
- keyName String
- The name of the key pair.
- launchTemplate Property Map
- The launch template to use to launch the instances.
- licenseSpecifications List<Property Map>
- The license configurations.
- monitoring Boolean
- Specifies whether detailed monitoring is enabled for the instance.
- networkInterfaces List<Property Map>
- The network interfaces to associate with the instance.
- placementGroup StringName 
- The name of an existing placement group that you want to launch the instance into (cluster | partition | spread).
- privateDns Property MapName Options 
- The options for the instance hostname.
- privateIp StringAddress 
- [EC2-VPC] The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet.
- Boolean
- Indicates whether to assign the tags from the instance to all of the volumes attached to the instance at launch. If you specify true and you assign tags to the instance, those tags are automatically assigned to all of the volumes that you attach to the instance at launch. If you specify false, those tags are not assigned to the attached volumes.
- ramdiskId String
- The ID of the RAM disk to select.
- securityGroup List<String>Ids 
- The IDs of the security groups.
- securityGroups List<String>
- the names of the security groups. For a nondefault VPC, you must use security group IDs instead.
- sourceDest BooleanCheck 
- Specifies whether to enable an instance launched in a VPC to perform NAT.
- ssmAssociations List<Property Map>
- The SSM document and parameter values in AWS Systems Manager to associate with this instance.
- subnetId String
- [EC2-VPC] The ID of the subnet to launch the instance into.
- List<Property Map>
- The tags to add to the instance.
- tenancy String
- The tenancy of the instance (if the instance is running in a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware.
- userData String
- The user data to make available to the instance.
- volumes List<Property Map>
- The volumes to attach to the instance.
Outputs
All input properties are implicitly available as output properties. Additionally, the Instance resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- InstanceId string
- The EC2 Instance ID.
- PrivateDns stringName 
- The private DNS name of the specified instance. For example: ip-10-24-34-0.ec2.internal.
- PrivateIp string
- The private IP address of the specified instance. For example: 10.24.34.0.
- PublicDns stringName 
- The public DNS name of the specified instance. For example: ec2-107-20-50-45.compute-1.amazonaws.com.
- PublicIp string
- The public IP address of the specified instance. For example: 192.0.2.0.
- State
Pulumi.Aws Native. Ec2. Outputs. Instance State 
- The current state of the instance.
- VpcId string
- The ID of the VPC that the instance is running in.
- Id string
- The provider-assigned unique ID for this managed resource.
- InstanceId string
- The EC2 Instance ID.
- PrivateDns stringName 
- The private DNS name of the specified instance. For example: ip-10-24-34-0.ec2.internal.
- PrivateIp string
- The private IP address of the specified instance. For example: 10.24.34.0.
- PublicDns stringName 
- The public DNS name of the specified instance. For example: ec2-107-20-50-45.compute-1.amazonaws.com.
- PublicIp string
- The public IP address of the specified instance. For example: 192.0.2.0.
- State
InstanceState Type 
- The current state of the instance.
- VpcId string
- The ID of the VPC that the instance is running in.
- id String
- The provider-assigned unique ID for this managed resource.
- instanceId String
- The EC2 Instance ID.
- privateDns StringName 
- The private DNS name of the specified instance. For example: ip-10-24-34-0.ec2.internal.
- privateIp String
- The private IP address of the specified instance. For example: 10.24.34.0.
- publicDns StringName 
- The public DNS name of the specified instance. For example: ec2-107-20-50-45.compute-1.amazonaws.com.
- publicIp String
- The public IP address of the specified instance. For example: 192.0.2.0.
- state
InstanceState 
- The current state of the instance.
- vpcId String
- The ID of the VPC that the instance is running in.
- id string
- The provider-assigned unique ID for this managed resource.
- instanceId string
- The EC2 Instance ID.
- privateDns stringName 
- The private DNS name of the specified instance. For example: ip-10-24-34-0.ec2.internal.
- privateIp string
- The private IP address of the specified instance. For example: 10.24.34.0.
- publicDns stringName 
- The public DNS name of the specified instance. For example: ec2-107-20-50-45.compute-1.amazonaws.com.
- publicIp string
- The public IP address of the specified instance. For example: 192.0.2.0.
- state
InstanceState 
- The current state of the instance.
- vpcId string
- The ID of the VPC that the instance is running in.
- id str
- The provider-assigned unique ID for this managed resource.
- instance_id str
- The EC2 Instance ID.
- private_dns_ strname 
- The private DNS name of the specified instance. For example: ip-10-24-34-0.ec2.internal.
- private_ip str
- The private IP address of the specified instance. For example: 10.24.34.0.
- public_dns_ strname 
- The public DNS name of the specified instance. For example: ec2-107-20-50-45.compute-1.amazonaws.com.
- public_ip str
- The public IP address of the specified instance. For example: 192.0.2.0.
- state
InstanceState 
- The current state of the instance.
- vpc_id str
- The ID of the VPC that the instance is running in.
- id String
- The provider-assigned unique ID for this managed resource.
- instanceId String
- The EC2 Instance ID.
- privateDns StringName 
- The private DNS name of the specified instance. For example: ip-10-24-34-0.ec2.internal.
- privateIp String
- The private IP address of the specified instance. For example: 10.24.34.0.
- publicDns StringName 
- The public DNS name of the specified instance. For example: ec2-107-20-50-45.compute-1.amazonaws.com.
- publicIp String
- The public IP address of the specified instance. For example: 192.0.2.0.
- state Property Map
- The current state of the instance.
- vpcId String
- The ID of the VPC that the instance is running in.
Supporting Types
CpuOptionsProperties, CpuOptionsPropertiesArgs      
- CoreCount int
- The number of CPU cores for the instance.
- ThreadsPer intCore 
- The number of threads per CPU core.
- CoreCount int
- The number of CPU cores for the instance.
- ThreadsPer intCore 
- The number of threads per CPU core.
- coreCount Integer
- The number of CPU cores for the instance.
- threadsPer IntegerCore 
- The number of threads per CPU core.
- coreCount number
- The number of CPU cores for the instance.
- threadsPer numberCore 
- The number of threads per CPU core.
- core_count int
- The number of CPU cores for the instance.
- threads_per_ intcore 
- The number of threads per CPU core.
- coreCount Number
- The number of CPU cores for the instance.
- threadsPer NumberCore 
- The number of threads per CPU core.
CreditSpecificationProperties, CreditSpecificationPropertiesArgs      
- CpuCredits string
- The credit option for CPU usage of the instance. - Valid values: - standard|- unlimited- T3 instances with - hosttenancy do not support the- unlimitedCPU credit option.
- CpuCredits string
- The credit option for CPU usage of the instance. - Valid values: - standard|- unlimited- T3 instances with - hosttenancy do not support the- unlimitedCPU credit option.
- cpuCredits String
- The credit option for CPU usage of the instance. - Valid values: - standard|- unlimited- T3 instances with - hosttenancy do not support the- unlimitedCPU credit option.
- cpuCredits string
- The credit option for CPU usage of the instance. - Valid values: - standard|- unlimited- T3 instances with - hosttenancy do not support the- unlimitedCPU credit option.
- cpu_credits str
- The credit option for CPU usage of the instance. - Valid values: - standard|- unlimited- T3 instances with - hosttenancy do not support the- unlimitedCPU credit option.
- cpuCredits String
- The credit option for CPU usage of the instance. - Valid values: - standard|- unlimited- T3 instances with - hosttenancy do not support the- unlimitedCPU credit option.
EnclaveOptionsProperties, EnclaveOptionsPropertiesArgs      
- Enabled bool
- If this parameter is set to true, the instance is enabled for AWS Nitro Enclaves; otherwise, it is not enabled for AWS Nitro Enclaves.
- Enabled bool
- If this parameter is set to true, the instance is enabled for AWS Nitro Enclaves; otherwise, it is not enabled for AWS Nitro Enclaves.
- enabled Boolean
- If this parameter is set to true, the instance is enabled for AWS Nitro Enclaves; otherwise, it is not enabled for AWS Nitro Enclaves.
- enabled boolean
- If this parameter is set to true, the instance is enabled for AWS Nitro Enclaves; otherwise, it is not enabled for AWS Nitro Enclaves.
- enabled bool
- If this parameter is set to true, the instance is enabled for AWS Nitro Enclaves; otherwise, it is not enabled for AWS Nitro Enclaves.
- enabled Boolean
- If this parameter is set to true, the instance is enabled for AWS Nitro Enclaves; otherwise, it is not enabled for AWS Nitro Enclaves.
HibernationOptionsProperties, HibernationOptionsPropertiesArgs      
- Configured bool
- If you set this parameter to true, your instance is enabled for hibernation.
- Configured bool
- If you set this parameter to true, your instance is enabled for hibernation.
- configured Boolean
- If you set this parameter to true, your instance is enabled for hibernation.
- configured boolean
- If you set this parameter to true, your instance is enabled for hibernation.
- configured bool
- If you set this parameter to true, your instance is enabled for hibernation.
- configured Boolean
- If you set this parameter to true, your instance is enabled for hibernation.
InstanceAffinity, InstanceAffinityArgs    
- Default
- default
- Host
- host
- InstanceAffinity Default 
- default
- InstanceAffinity Host 
- host
- Default
- default
- Host
- host
- Default
- default
- Host
- host
- DEFAULT
- default
- HOST
- host
- "default"
- default
- "host"
- host
InstanceAssociationParameter, InstanceAssociationParameterArgs      
InstanceBlockDeviceMapping, InstanceBlockDeviceMappingArgs        
- DeviceName string
- The device name (for example, /dev/sdh or xvdh).
- Ebs
Pulumi.Aws Native. Ec2. Inputs. Instance Ebs 
- Parameters used to automatically set up EBS volumes when the instance is launched.
- NoDevice object
- To omit the device from the block device mapping, specify an empty string. - After the instance is running, modifying this parameter results in instance replacement . 
- VirtualName string
- The virtual device name ( - ephemeralN). The name must be in the form- ephemeralX where X is a number starting from zero (0). For example, an instance type with 2 available instance store volumes can specify mappings for- ephemeral0and- ephemeral1. The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.- NVMe instance store volumes are automatically enumerated and assigned a device name. Including them in your block device mapping has no effect. - Constraints : For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI. - After the instance is running, modifying this parameter results in instance replacement . 
- DeviceName string
- The device name (for example, /dev/sdh or xvdh).
- Ebs
InstanceEbs 
- Parameters used to automatically set up EBS volumes when the instance is launched.
- NoDevice interface{}
- To omit the device from the block device mapping, specify an empty string. - After the instance is running, modifying this parameter results in instance replacement . 
- VirtualName string
- The virtual device name ( - ephemeralN). The name must be in the form- ephemeralX where X is a number starting from zero (0). For example, an instance type with 2 available instance store volumes can specify mappings for- ephemeral0and- ephemeral1. The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.- NVMe instance store volumes are automatically enumerated and assigned a device name. Including them in your block device mapping has no effect. - Constraints : For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI. - After the instance is running, modifying this parameter results in instance replacement . 
- deviceName String
- The device name (for example, /dev/sdh or xvdh).
- ebs
InstanceEbs 
- Parameters used to automatically set up EBS volumes when the instance is launched.
- noDevice Object
- To omit the device from the block device mapping, specify an empty string. - After the instance is running, modifying this parameter results in instance replacement . 
- virtualName String
- The virtual device name ( - ephemeralN). The name must be in the form- ephemeralX where X is a number starting from zero (0). For example, an instance type with 2 available instance store volumes can specify mappings for- ephemeral0and- ephemeral1. The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.- NVMe instance store volumes are automatically enumerated and assigned a device name. Including them in your block device mapping has no effect. - Constraints : For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI. - After the instance is running, modifying this parameter results in instance replacement . 
- deviceName string
- The device name (for example, /dev/sdh or xvdh).
- ebs
InstanceEbs 
- Parameters used to automatically set up EBS volumes when the instance is launched.
- noDevice any
- To omit the device from the block device mapping, specify an empty string. - After the instance is running, modifying this parameter results in instance replacement . 
- virtualName string
- The virtual device name ( - ephemeralN). The name must be in the form- ephemeralX where X is a number starting from zero (0). For example, an instance type with 2 available instance store volumes can specify mappings for- ephemeral0and- ephemeral1. The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.- NVMe instance store volumes are automatically enumerated and assigned a device name. Including them in your block device mapping has no effect. - Constraints : For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI. - After the instance is running, modifying this parameter results in instance replacement . 
- device_name str
- The device name (for example, /dev/sdh or xvdh).
- ebs
InstanceEbs 
- Parameters used to automatically set up EBS volumes when the instance is launched.
- no_device Any
- To omit the device from the block device mapping, specify an empty string. - After the instance is running, modifying this parameter results in instance replacement . 
- virtual_name str
- The virtual device name ( - ephemeralN). The name must be in the form- ephemeralX where X is a number starting from zero (0). For example, an instance type with 2 available instance store volumes can specify mappings for- ephemeral0and- ephemeral1. The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.- NVMe instance store volumes are automatically enumerated and assigned a device name. Including them in your block device mapping has no effect. - Constraints : For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI. - After the instance is running, modifying this parameter results in instance replacement . 
- deviceName String
- The device name (for example, /dev/sdh or xvdh).
- ebs Property Map
- Parameters used to automatically set up EBS volumes when the instance is launched.
- noDevice Any
- To omit the device from the block device mapping, specify an empty string. - After the instance is running, modifying this parameter results in instance replacement . 
- virtualName String
- The virtual device name ( - ephemeralN). The name must be in the form- ephemeralX where X is a number starting from zero (0). For example, an instance type with 2 available instance store volumes can specify mappings for- ephemeral0and- ephemeral1. The number of available instance store volumes depends on the instance type. After you connect to the instance, you must mount the volume.- NVMe instance store volumes are automatically enumerated and assigned a device name. Including them in your block device mapping has no effect. - Constraints : For M3 instances, you must specify instance store volumes in the block device mapping for the instance. When you launch an M3 instance, we ignore any instance store volumes specified in the block device mapping for the AMI. - After the instance is running, modifying this parameter results in instance replacement . 
InstanceEbs, InstanceEbsArgs    
- DeleteOn boolTermination 
- Indicates whether the EBS volume is deleted on instance termination.
- Encrypted bool
- Indicates whether the volume should be encrypted.
- Iops int
- The number of I/O operations per second (IOPS). For gp3, io1, and io2 volumes, this represents the number of IOPS that are provisioned for the volume. For gp2 volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting.
- KmsKey stringId 
- The identifier of the AWS Key Management Service (AWS KMS) customer managed CMK to use for Amazon EBS encryption. If KmsKeyId is specified, the encrypted state must be true. If the encrypted state is true but you do not specify KmsKeyId, your AWS managed CMK for EBS is used.
- SnapshotId string
- The ID of the snapshot.
- VolumeSize int
- The size of the volume, in GiBs. You must specify either a snapshot ID or a volume size. If you specify a snapshot, the default is the snapshot size. You can specify a volume size that is equal to or larger than the snapshot size.
- VolumeType string
- The volume type.
- DeleteOn boolTermination 
- Indicates whether the EBS volume is deleted on instance termination.
- Encrypted bool
- Indicates whether the volume should be encrypted.
- Iops int
- The number of I/O operations per second (IOPS). For gp3, io1, and io2 volumes, this represents the number of IOPS that are provisioned for the volume. For gp2 volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting.
- KmsKey stringId 
- The identifier of the AWS Key Management Service (AWS KMS) customer managed CMK to use for Amazon EBS encryption. If KmsKeyId is specified, the encrypted state must be true. If the encrypted state is true but you do not specify KmsKeyId, your AWS managed CMK for EBS is used.
- SnapshotId string
- The ID of the snapshot.
- VolumeSize int
- The size of the volume, in GiBs. You must specify either a snapshot ID or a volume size. If you specify a snapshot, the default is the snapshot size. You can specify a volume size that is equal to or larger than the snapshot size.
- VolumeType string
- The volume type.
- deleteOn BooleanTermination 
- Indicates whether the EBS volume is deleted on instance termination.
- encrypted Boolean
- Indicates whether the volume should be encrypted.
- iops Integer
- The number of I/O operations per second (IOPS). For gp3, io1, and io2 volumes, this represents the number of IOPS that are provisioned for the volume. For gp2 volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting.
- kmsKey StringId 
- The identifier of the AWS Key Management Service (AWS KMS) customer managed CMK to use for Amazon EBS encryption. If KmsKeyId is specified, the encrypted state must be true. If the encrypted state is true but you do not specify KmsKeyId, your AWS managed CMK for EBS is used.
- snapshotId String
- The ID of the snapshot.
- volumeSize Integer
- The size of the volume, in GiBs. You must specify either a snapshot ID or a volume size. If you specify a snapshot, the default is the snapshot size. You can specify a volume size that is equal to or larger than the snapshot size.
- volumeType String
- The volume type.
- deleteOn booleanTermination 
- Indicates whether the EBS volume is deleted on instance termination.
- encrypted boolean
- Indicates whether the volume should be encrypted.
- iops number
- The number of I/O operations per second (IOPS). For gp3, io1, and io2 volumes, this represents the number of IOPS that are provisioned for the volume. For gp2 volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting.
- kmsKey stringId 
- The identifier of the AWS Key Management Service (AWS KMS) customer managed CMK to use for Amazon EBS encryption. If KmsKeyId is specified, the encrypted state must be true. If the encrypted state is true but you do not specify KmsKeyId, your AWS managed CMK for EBS is used.
- snapshotId string
- The ID of the snapshot.
- volumeSize number
- The size of the volume, in GiBs. You must specify either a snapshot ID or a volume size. If you specify a snapshot, the default is the snapshot size. You can specify a volume size that is equal to or larger than the snapshot size.
- volumeType string
- The volume type.
- delete_on_ booltermination 
- Indicates whether the EBS volume is deleted on instance termination.
- encrypted bool
- Indicates whether the volume should be encrypted.
- iops int
- The number of I/O operations per second (IOPS). For gp3, io1, and io2 volumes, this represents the number of IOPS that are provisioned for the volume. For gp2 volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting.
- kms_key_ strid 
- The identifier of the AWS Key Management Service (AWS KMS) customer managed CMK to use for Amazon EBS encryption. If KmsKeyId is specified, the encrypted state must be true. If the encrypted state is true but you do not specify KmsKeyId, your AWS managed CMK for EBS is used.
- snapshot_id str
- The ID of the snapshot.
- volume_size int
- The size of the volume, in GiBs. You must specify either a snapshot ID or a volume size. If you specify a snapshot, the default is the snapshot size. You can specify a volume size that is equal to or larger than the snapshot size.
- volume_type str
- The volume type.
- deleteOn BooleanTermination 
- Indicates whether the EBS volume is deleted on instance termination.
- encrypted Boolean
- Indicates whether the volume should be encrypted.
- iops Number
- The number of I/O operations per second (IOPS). For gp3, io1, and io2 volumes, this represents the number of IOPS that are provisioned for the volume. For gp2 volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting.
- kmsKey StringId 
- The identifier of the AWS Key Management Service (AWS KMS) customer managed CMK to use for Amazon EBS encryption. If KmsKeyId is specified, the encrypted state must be true. If the encrypted state is true but you do not specify KmsKeyId, your AWS managed CMK for EBS is used.
- snapshotId String
- The ID of the snapshot.
- volumeSize Number
- The size of the volume, in GiBs. You must specify either a snapshot ID or a volume size. If you specify a snapshot, the default is the snapshot size. You can specify a volume size that is equal to or larger than the snapshot size.
- volumeType String
- The volume type.
InstanceElasticGpuSpecification, InstanceElasticGpuSpecificationArgs        
- Type string
- The type of Elastic Graphics accelerator.
- Type string
- The type of Elastic Graphics accelerator.
- type String
- The type of Elastic Graphics accelerator.
- type string
- The type of Elastic Graphics accelerator.
- type str
- The type of Elastic Graphics accelerator.
- type String
- The type of Elastic Graphics accelerator.
InstanceElasticInferenceAccelerator, InstanceElasticInferenceAcceleratorArgs        
InstanceIpv6Address, InstanceIpv6AddressArgs    
- Ipv6Address string
- The IPv6 address.
- Ipv6Address string
- The IPv6 address.
- ipv6Address String
- The IPv6 address.
- ipv6Address string
- The IPv6 address.
- ipv6_address str
- The IPv6 address.
- ipv6Address String
- The IPv6 address.
InstanceLaunchTemplateSpecification, InstanceLaunchTemplateSpecificationArgs        
- LaunchTemplate stringId 
- The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- LaunchTemplate stringName 
- The name of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- Version string
- The version number of the launch template.
- LaunchTemplate stringId 
- The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- LaunchTemplate stringName 
- The name of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- Version string
- The version number of the launch template.
- launchTemplate StringId 
- The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- launchTemplate StringName 
- The name of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- version String
- The version number of the launch template.
- launchTemplate stringId 
- The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- launchTemplate stringName 
- The name of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- version string
- The version number of the launch template.
- launch_template_ strid 
- The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- launch_template_ strname 
- The name of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- version str
- The version number of the launch template.
- launchTemplate StringId 
- The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- launchTemplate StringName 
- The name of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- version String
- The version number of the launch template.
InstanceLicenseSpecification, InstanceLicenseSpecificationArgs      
- LicenseConfiguration stringArn 
- The Amazon Resource Name (ARN) of the license configuration.
- LicenseConfiguration stringArn 
- The Amazon Resource Name (ARN) of the license configuration.
- licenseConfiguration StringArn 
- The Amazon Resource Name (ARN) of the license configuration.
- licenseConfiguration stringArn 
- The Amazon Resource Name (ARN) of the license configuration.
- license_configuration_ strarn 
- The Amazon Resource Name (ARN) of the license configuration.
- licenseConfiguration StringArn 
- The Amazon Resource Name (ARN) of the license configuration.
InstanceNetworkInterface, InstanceNetworkInterfaceArgs      
- DeviceIndex string
- The position of the network interface in the attachment order. A primary network interface has a device index of 0.
- AssociateCarrier boolIp Address 
- Not currently supported by AWS CloudFormation.
- AssociatePublic boolIp Address 
- Indicates whether to assign a public IPv4 address to an instance you launch in a VPC.
- DeleteOn boolTermination 
- If set to true, the interface is deleted when the instance is terminated.
- Description string
- The description of the network interface.
- GroupSet List<string>
- The IDs of the security groups for the network interface.
- Ipv6AddressCount int
- A number of IPv6 addresses to assign to the network interface.
- Ipv6Addresses
List<Pulumi.Aws Native. Ec2. Inputs. Instance Ipv6Address> 
- The IPv6 addresses associated with the network interface.
- NetworkInterface stringId 
- The ID of the network interface.
- PrivateIp stringAddress 
- The private IPv4 address of the network interface.
- PrivateIp List<Pulumi.Addresses Aws Native. Ec2. Inputs. Instance Private Ip Address Specification> 
- One or more private IPv4 addresses to assign to the network interface.
- SecondaryPrivate intIp Address Count 
- The number of secondary private IPv4 addresses.
- SubnetId string
- The ID of the subnet.
- DeviceIndex string
- The position of the network interface in the attachment order. A primary network interface has a device index of 0.
- AssociateCarrier boolIp Address 
- Not currently supported by AWS CloudFormation.
- AssociatePublic boolIp Address 
- Indicates whether to assign a public IPv4 address to an instance you launch in a VPC.
- DeleteOn boolTermination 
- If set to true, the interface is deleted when the instance is terminated.
- Description string
- The description of the network interface.
- GroupSet []string
- The IDs of the security groups for the network interface.
- Ipv6AddressCount int
- A number of IPv6 addresses to assign to the network interface.
- Ipv6Addresses
[]InstanceIpv6Address 
- The IPv6 addresses associated with the network interface.
- NetworkInterface stringId 
- The ID of the network interface.
- PrivateIp stringAddress 
- The private IPv4 address of the network interface.
- PrivateIp []InstanceAddresses Private Ip Address Specification 
- One or more private IPv4 addresses to assign to the network interface.
- SecondaryPrivate intIp Address Count 
- The number of secondary private IPv4 addresses.
- SubnetId string
- The ID of the subnet.
- deviceIndex String
- The position of the network interface in the attachment order. A primary network interface has a device index of 0.
- associateCarrier BooleanIp Address 
- Not currently supported by AWS CloudFormation.
- associatePublic BooleanIp Address 
- Indicates whether to assign a public IPv4 address to an instance you launch in a VPC.
- deleteOn BooleanTermination 
- If set to true, the interface is deleted when the instance is terminated.
- description String
- The description of the network interface.
- groupSet List<String>
- The IDs of the security groups for the network interface.
- ipv6AddressCount Integer
- A number of IPv6 addresses to assign to the network interface.
- ipv6Addresses
List<InstanceIpv6Address> 
- The IPv6 addresses associated with the network interface.
- networkInterface StringId 
- The ID of the network interface.
- privateIp StringAddress 
- The private IPv4 address of the network interface.
- privateIp List<InstanceAddresses Private Ip Address Specification> 
- One or more private IPv4 addresses to assign to the network interface.
- secondaryPrivate IntegerIp Address Count 
- The number of secondary private IPv4 addresses.
- subnetId String
- The ID of the subnet.
- deviceIndex string
- The position of the network interface in the attachment order. A primary network interface has a device index of 0.
- associateCarrier booleanIp Address 
- Not currently supported by AWS CloudFormation.
- associatePublic booleanIp Address 
- Indicates whether to assign a public IPv4 address to an instance you launch in a VPC.
- deleteOn booleanTermination 
- If set to true, the interface is deleted when the instance is terminated.
- description string
- The description of the network interface.
- groupSet string[]
- The IDs of the security groups for the network interface.
- ipv6AddressCount number
- A number of IPv6 addresses to assign to the network interface.
- ipv6Addresses
InstanceIpv6Address[] 
- The IPv6 addresses associated with the network interface.
- networkInterface stringId 
- The ID of the network interface.
- privateIp stringAddress 
- The private IPv4 address of the network interface.
- privateIp InstanceAddresses Private Ip Address Specification[] 
- One or more private IPv4 addresses to assign to the network interface.
- secondaryPrivate numberIp Address Count 
- The number of secondary private IPv4 addresses.
- subnetId string
- The ID of the subnet.
- device_index str
- The position of the network interface in the attachment order. A primary network interface has a device index of 0.
- associate_carrier_ boolip_ address 
- Not currently supported by AWS CloudFormation.
- associate_public_ boolip_ address 
- Indicates whether to assign a public IPv4 address to an instance you launch in a VPC.
- delete_on_ booltermination 
- If set to true, the interface is deleted when the instance is terminated.
- description str
- The description of the network interface.
- group_set Sequence[str]
- The IDs of the security groups for the network interface.
- ipv6_address_ intcount 
- A number of IPv6 addresses to assign to the network interface.
- ipv6_addresses Sequence[InstanceIpv6Address] 
- The IPv6 addresses associated with the network interface.
- network_interface_ strid 
- The ID of the network interface.
- private_ip_ straddress 
- The private IPv4 address of the network interface.
- private_ip_ Sequence[Instanceaddresses Private Ip Address Specification] 
- One or more private IPv4 addresses to assign to the network interface.
- secondary_private_ intip_ address_ count 
- The number of secondary private IPv4 addresses.
- subnet_id str
- The ID of the subnet.
- deviceIndex String
- The position of the network interface in the attachment order. A primary network interface has a device index of 0.
- associateCarrier BooleanIp Address 
- Not currently supported by AWS CloudFormation.
- associatePublic BooleanIp Address 
- Indicates whether to assign a public IPv4 address to an instance you launch in a VPC.
- deleteOn BooleanTermination 
- If set to true, the interface is deleted when the instance is terminated.
- description String
- The description of the network interface.
- groupSet List<String>
- The IDs of the security groups for the network interface.
- ipv6AddressCount Number
- A number of IPv6 addresses to assign to the network interface.
- ipv6Addresses List<Property Map>
- The IPv6 addresses associated with the network interface.
- networkInterface StringId 
- The ID of the network interface.
- privateIp StringAddress 
- The private IPv4 address of the network interface.
- privateIp List<Property Map>Addresses 
- One or more private IPv4 addresses to assign to the network interface.
- secondaryPrivate NumberIp Address Count 
- The number of secondary private IPv4 addresses.
- subnetId String
- The ID of the subnet.
InstancePrivateDnsNameOptions, InstancePrivateDnsNameOptionsArgs          
- EnableResource boolName Dns ARecord 
- Indicates whether to respond to DNS queries for instance hostnames with DNS A records. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- EnableResource boolName Dns Aaaa Record 
- Indicates whether to respond to DNS queries for instance hostnames with DNS AAAA records. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- HostnameType Pulumi.Aws Native. Ec2. Instance Private Dns Name Options Hostname Type 
- The type of hostnames to assign to instances in the subnet at launch. For IPv4 only subnets, an instance DNS name must be based on the instance IPv4 address. For IPv6 only subnets, an instance DNS name must be based on the instance ID. For dual-stack subnets, you can specify whether DNS names use the instance IPv4 address or the instance ID. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- EnableResource boolName Dns ARecord 
- Indicates whether to respond to DNS queries for instance hostnames with DNS A records. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- EnableResource boolName Dns Aaaa Record 
- Indicates whether to respond to DNS queries for instance hostnames with DNS AAAA records. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- HostnameType InstancePrivate Dns Name Options Hostname Type 
- The type of hostnames to assign to instances in the subnet at launch. For IPv4 only subnets, an instance DNS name must be based on the instance IPv4 address. For IPv6 only subnets, an instance DNS name must be based on the instance ID. For dual-stack subnets, you can specify whether DNS names use the instance IPv4 address or the instance ID. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- enableResource BooleanName Dns ARecord 
- Indicates whether to respond to DNS queries for instance hostnames with DNS A records. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- enableResource BooleanName Dns Aaaa Record 
- Indicates whether to respond to DNS queries for instance hostnames with DNS AAAA records. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- hostnameType InstancePrivate Dns Name Options Hostname Type 
- The type of hostnames to assign to instances in the subnet at launch. For IPv4 only subnets, an instance DNS name must be based on the instance IPv4 address. For IPv6 only subnets, an instance DNS name must be based on the instance ID. For dual-stack subnets, you can specify whether DNS names use the instance IPv4 address or the instance ID. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- enableResource booleanName Dns ARecord 
- Indicates whether to respond to DNS queries for instance hostnames with DNS A records. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- enableResource booleanName Dns Aaaa Record 
- Indicates whether to respond to DNS queries for instance hostnames with DNS AAAA records. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- hostnameType InstancePrivate Dns Name Options Hostname Type 
- The type of hostnames to assign to instances in the subnet at launch. For IPv4 only subnets, an instance DNS name must be based on the instance IPv4 address. For IPv6 only subnets, an instance DNS name must be based on the instance ID. For dual-stack subnets, you can specify whether DNS names use the instance IPv4 address or the instance ID. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- enable_resource_ boolname_ dns_ a_ record 
- Indicates whether to respond to DNS queries for instance hostnames with DNS A records. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- enable_resource_ boolname_ dns_ aaaa_ record 
- Indicates whether to respond to DNS queries for instance hostnames with DNS AAAA records. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- hostname_type InstancePrivate Dns Name Options Hostname Type 
- The type of hostnames to assign to instances in the subnet at launch. For IPv4 only subnets, an instance DNS name must be based on the instance IPv4 address. For IPv6 only subnets, an instance DNS name must be based on the instance ID. For dual-stack subnets, you can specify whether DNS names use the instance IPv4 address or the instance ID. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- enableResource BooleanName Dns ARecord 
- Indicates whether to respond to DNS queries for instance hostnames with DNS A records. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- enableResource BooleanName Dns Aaaa Record 
- Indicates whether to respond to DNS queries for instance hostnames with DNS AAAA records. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
- hostnameType "ip-name" | "resource-name"
- The type of hostnames to assign to instances in the subnet at launch. For IPv4 only subnets, an instance DNS name must be based on the instance IPv4 address. For IPv6 only subnets, an instance DNS name must be based on the instance ID. For dual-stack subnets, you can specify whether DNS names use the instance IPv4 address or the instance ID. For more information, see Amazon EC2 instance hostname types in the Amazon Elastic Compute Cloud User Guide.
InstancePrivateDnsNameOptionsHostnameType, InstancePrivateDnsNameOptionsHostnameTypeArgs              
- IpName 
- ip-name
- ResourceName 
- resource-name
- InstancePrivate Dns Name Options Hostname Type Ip Name 
- ip-name
- InstancePrivate Dns Name Options Hostname Type Resource Name 
- resource-name
- IpName 
- ip-name
- ResourceName 
- resource-name
- IpName 
- ip-name
- ResourceName 
- resource-name
- IP_NAME
- ip-name
- RESOURCE_NAME
- resource-name
- "ip-name"
- ip-name
- "resource-name"
- resource-name
InstancePrivateIpAddressSpecification, InstancePrivateIpAddressSpecificationArgs          
- Primary bool
- Indicates whether the private IPv4 address is the primary private IPv4 address. Only one IPv4 address can be designated as primary.
- PrivateIp stringAddress 
- The private IPv4 addresses.
- Primary bool
- Indicates whether the private IPv4 address is the primary private IPv4 address. Only one IPv4 address can be designated as primary.
- PrivateIp stringAddress 
- The private IPv4 addresses.
- primary Boolean
- Indicates whether the private IPv4 address is the primary private IPv4 address. Only one IPv4 address can be designated as primary.
- privateIp StringAddress 
- The private IPv4 addresses.
- primary boolean
- Indicates whether the private IPv4 address is the primary private IPv4 address. Only one IPv4 address can be designated as primary.
- privateIp stringAddress 
- The private IPv4 addresses.
- primary bool
- Indicates whether the private IPv4 address is the primary private IPv4 address. Only one IPv4 address can be designated as primary.
- private_ip_ straddress 
- The private IPv4 addresses.
- primary Boolean
- Indicates whether the private IPv4 address is the primary private IPv4 address. Only one IPv4 address can be designated as primary.
- privateIp StringAddress 
- The private IPv4 addresses.
InstanceSsmAssociation, InstanceSsmAssociationArgs      
- DocumentName string
- The name of an SSM document to associate with the instance.
- AssociationParameters List<Pulumi.Aws Native. Ec2. Inputs. Instance Association Parameter> 
- The input parameter values to use with the associated SSM document.
- DocumentName string
- The name of an SSM document to associate with the instance.
- AssociationParameters []InstanceAssociation Parameter 
- The input parameter values to use with the associated SSM document.
- documentName String
- The name of an SSM document to associate with the instance.
- associationParameters List<InstanceAssociation Parameter> 
- The input parameter values to use with the associated SSM document.
- documentName string
- The name of an SSM document to associate with the instance.
- associationParameters InstanceAssociation Parameter[] 
- The input parameter values to use with the associated SSM document.
- document_name str
- The name of an SSM document to associate with the instance.
- association_parameters Sequence[InstanceAssociation Parameter] 
- The input parameter values to use with the associated SSM document.
- documentName String
- The name of an SSM document to associate with the instance.
- associationParameters List<Property Map>
- The input parameter values to use with the associated SSM document.
InstanceState, InstanceStateArgs    
InstanceVolume, InstanceVolumeArgs    
Tag, TagArgs  
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.