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
The Instance resource accepts the following input properties:
- Additional
Info 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.
- Availability
Zone string - The Availability Zone of the instance.
- Block
Device 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.
- Cpu
Options Pulumi.Aws Native. Ec2. Inputs. Cpu Options Properties - The CPU options for the instance.
- Credit
Specification 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.
- 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 List<Pulumi.Specifications Aws Native. Ec2. Inputs. Instance Elastic Gpu Specification> - An elastic GPU to associate with the instance.
- Elastic
Inference List<Pulumi.Accelerators Aws Native. Ec2. Inputs. Instance Elastic Inference Accelerator> - An elastic inference accelerator to associate with the instance.
- Enclave
Options Pulumi.Aws Native. Ec2. Inputs. Enclave Options Properties - Indicates whether the instance is enabled for AWS Nitro Enclaves.
- Hibernation
Options Pulumi.Aws Native. Ec2. Inputs. Hibernation Options Properties - Indicates whether an instance is enabled for hibernation.
- Host
Id 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.
- Host
Resource 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.
- Iam
Instance stringProfile - The IAM instance profile.
- Image
Id 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.
- Instance
Initiated stringShutdown 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 string - The instance type.
- Ipv6Address
Count 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.
- Kernel
Id string - The ID of the kernel.
- Key
Name string - The name of the key pair.
- Launch
Template Pulumi.Aws Native. Ec2. Inputs. Instance Launch Template Specification - The launch template to use to launch the instances.
- License
Specifications List<Pulumi.Aws Native. Ec2. Inputs. Instance License Specification> - The license configurations.
- Monitoring bool
- Specifies whether detailed monitoring is enabled for the instance.
- Network
Interfaces List<Pulumi.Aws Native. Ec2. Inputs. Instance Network Interface> - The network interfaces to associate with the instance.
- Placement
Group stringName - The name of an existing placement group that you want to launch the instance into (cluster | partition | spread).
- Private
Dns Pulumi.Name Options Aws Native. Ec2. Inputs. Instance Private Dns Name Options - The options for the instance hostname.
- Private
Ip 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.
- Ramdisk
Id string - The ID of the RAM disk to select.
- Security
Group List<string>Ids - The IDs of the security groups.
- Security
Groups List<string> - 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 List<Pulumi.Aws Native. Ec2. Inputs. Instance Ssm Association> - The SSM document and parameter values in AWS Systems Manager to associate with this instance.
- Subnet
Id 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.
- User
Data 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.
- Additional
Info 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
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.
- Availability
Zone string - The Availability Zone of the instance.
- Block
Device []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 []InstanceSpecifications Elastic Gpu Specification Args - An elastic GPU to associate with the instance.
- Elastic
Inference []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 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.
- Host
Resource 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.
- Iam
Instance stringProfile - The IAM instance profile.
- Image
Id 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.
- Instance
Initiated stringShutdown 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 string - The instance type.
- Ipv6Address
Count 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
[]Instance
Ipv6Address Args - [EC2-VPC] The IPv6 addresses from the range of the subnet to associate with the primary network interface.
- Kernel
Id string - The ID of the kernel.
- Key
Name string - The name of the key pair.
- Launch
Template InstanceLaunch Template Specification Args - The launch template to use to launch the instances.
- License
Specifications []InstanceLicense Specification Args - The license configurations.
- Monitoring bool
- Specifies whether detailed monitoring is enabled for the instance.
- Network
Interfaces []InstanceNetwork Interface Args - The network interfaces to associate with the instance.
- Placement
Group stringName - 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 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.
- Ramdisk
Id string - The ID of the RAM disk to select.
- Security
Group []stringIds - The IDs of the security groups.
- Security
Groups []string - 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 []InstanceSsm Association Args - The SSM document and parameter values in AWS Systems Manager to associate with this instance.
- Subnet
Id string - [EC2-VPC] The ID of the subnet to launch the instance into.
- Tag
Args - 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.
- User
Data string - The user data to make available to the instance.
- Volumes
[]Instance
Volume Args - The volumes to attach to the instance.
- additional
Info 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
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.
- availability
Zone String - The Availability Zone of the instance.
- block
Device List<InstanceMappings Block Device Mapping> - The block device mapping entries that defines the block devices to attach to the instance at launch.
- cpu
Options CpuOptions Properties - The CPU options for the instance.
- credit
Specification CreditSpecification Properties - The credit option for CPU usage of the burstable performance instance. Valid values are standard and unlimited.
- disable
Api 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.
- ebs
Optimized Boolean - Indicates whether the instance is optimized for Amazon EBS I/O.
- elastic
Gpu List<InstanceSpecifications Elastic Gpu Specification> - An elastic GPU to associate with the instance.
- elastic
Inference List<InstanceAccelerators Elastic Inference Accelerator> - An elastic inference accelerator to associate with the instance.
- enclave
Options EnclaveOptions Properties - Indicates whether the instance is enabled for AWS Nitro Enclaves.
- hibernation
Options HibernationOptions Properties - Indicates whether an instance is enabled for hibernation.
- host
Id 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.
- host
Resource 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.
- iam
Instance StringProfile - The IAM instance profile.
- image
Id 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.
- instance
Initiated StringShutdown 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 String - The instance type.
- ipv6Address
Count 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<Instance
Ipv6Address> - [EC2-VPC] The IPv6 addresses from the range of the subnet to associate with the primary network interface.
- kernel
Id String - The ID of the kernel.
- key
Name String - The name of the key pair.
- launch
Template InstanceLaunch Template Specification - The launch template to use to launch the instances.
- license
Specifications List<InstanceLicense Specification> - The license configurations.
- monitoring Boolean
- Specifies whether detailed monitoring is enabled for the instance.
- network
Interfaces List<InstanceNetwork Interface> - The network interfaces to associate with the instance.
- placement
Group StringName - 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 - The options for the instance hostname.
- private
Ip 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.
- ramdisk
Id String - The ID of the RAM disk to select.
- security
Group List<String>Ids - The IDs of the security groups.
- security
Groups List<String> - the names of the security groups. For a nondefault VPC, you must use security group IDs instead.
- source
Dest BooleanCheck - Specifies whether to enable an instance launched in a VPC to perform NAT.
- ssm
Associations List<InstanceSsm Association> - The SSM document and parameter values in AWS Systems Manager to associate with this instance.
- subnet
Id 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.
- user
Data String - The user data to make available to the instance.
- volumes
List<Instance
Volume> - The volumes to attach to the instance.
- additional
Info 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
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.
- availability
Zone string - The Availability Zone of the instance.
- block
Device InstanceMappings Block Device Mapping[] - The block device mapping entries that defines the block devices to attach to the instance at launch.
- cpu
Options CpuOptions Properties - The CPU options for the instance.
- credit
Specification CreditSpecification Properties - The credit option for CPU usage of the burstable performance instance. Valid values are standard and unlimited.
- disable
Api 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.
- ebs
Optimized boolean - Indicates whether the instance is optimized for Amazon EBS I/O.
- elastic
Gpu InstanceSpecifications Elastic Gpu Specification[] - An elastic GPU to associate with the instance.
- elastic
Inference InstanceAccelerators Elastic Inference Accelerator[] - An elastic inference accelerator to associate with the instance.
- enclave
Options EnclaveOptions Properties - Indicates whether the instance is enabled for AWS Nitro Enclaves.
- hibernation
Options HibernationOptions Properties - Indicates whether an instance is enabled for hibernation.
- host
Id 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.
- host
Resource 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.
- iam
Instance stringProfile - The IAM instance profile.
- image
Id 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.
- instance
Initiated stringShutdown 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 string - The instance type.
- ipv6Address
Count 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
Instance
Ipv6Address[] - [EC2-VPC] The IPv6 addresses from the range of the subnet to associate with the primary network interface.
- kernel
Id string - The ID of the kernel.
- key
Name string - The name of the key pair.
- launch
Template InstanceLaunch Template Specification - The launch template to use to launch the instances.
- license
Specifications InstanceLicense Specification[] - The license configurations.
- monitoring boolean
- Specifies whether detailed monitoring is enabled for the instance.
- network
Interfaces InstanceNetwork Interface[] - The network interfaces to associate with the instance.
- placement
Group stringName - 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 - The options for the instance hostname.
- private
Ip 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.
- ramdisk
Id string - The ID of the RAM disk to select.
- security
Group string[]Ids - The IDs of the security groups.
- security
Groups string[] - the names of the security groups. For a nondefault VPC, you must use security group IDs instead.
- source
Dest booleanCheck - Specifies whether to enable an instance launched in a VPC to perform NAT.
- ssm
Associations InstanceSsm Association[] - The SSM document and parameter values in AWS Systems Manager to associate with this instance.
- subnet
Id 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.
- user
Data string - The user data to make available to the instance.
- volumes
Instance
Volume[] - 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
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.
- 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[Tag
Args] - 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[Instance
Volume Args] - The volumes to attach to the instance.
- additional
Info 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.
- availability
Zone String - The Availability Zone of the instance.
- block
Device List<Property Map>Mappings - The block device mapping entries that defines the block devices to attach to the instance at launch.
- cpu
Options Property Map - The CPU options for the instance.
- credit
Specification Property Map - The credit option for CPU usage of the burstable performance instance. Valid values are standard and unlimited.
- disable
Api 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.
- ebs
Optimized Boolean - Indicates whether the instance is optimized for Amazon EBS I/O.
- elastic
Gpu List<Property Map>Specifications - An elastic GPU to associate with the instance.
- elastic
Inference List<Property Map>Accelerators - An elastic inference accelerator to associate with the instance.
- enclave
Options Property Map - Indicates whether the instance is enabled for AWS Nitro Enclaves.
- hibernation
Options Property Map - Indicates whether an instance is enabled for hibernation.
- host
Id 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.
- host
Resource 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.
- iam
Instance StringProfile - The IAM instance profile.
- image
Id 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.
- instance
Initiated StringShutdown 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 String - The instance type.
- ipv6Address
Count 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.
- kernel
Id String - The ID of the kernel.
- key
Name String - The name of the key pair.
- launch
Template Property Map - The launch template to use to launch the instances.
- license
Specifications List<Property Map> - The license configurations.
- monitoring Boolean
- Specifies whether detailed monitoring is enabled for the instance.
- network
Interfaces List<Property Map> - The network interfaces to associate with the instance.
- placement
Group StringName - The name of an existing placement group that you want to launch the instance into (cluster | partition | spread).
- private
Dns Property MapName Options - The options for the instance hostname.
- private
Ip 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.
- ramdisk
Id String - The ID of the RAM disk to select.
- security
Group List<String>Ids - The IDs of the security groups.
- security
Groups List<String> - the names of the security groups. For a nondefault VPC, you must use security group IDs instead.
- source
Dest BooleanCheck - Specifies whether to enable an instance launched in a VPC to perform NAT.
- ssm
Associations List<Property Map> - The SSM document and parameter values in AWS Systems Manager to associate with this instance.
- subnet
Id 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.
- user
Data 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.
- Instance
Id string - The EC2 Instance ID.
- Private
Dns stringName - The private DNS name of the specified instance. For example: ip-10-24-34-0.ec2.internal.
- Private
Ip string - The private IP address of the specified instance. For example: 10.24.34.0.
- Public
Dns stringName - The public DNS name of the specified instance. For example: ec2-107-20-50-45.compute-1.amazonaws.com.
- Public
Ip 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.
- Vpc
Id string - The ID of the VPC that the instance is running in.
- Id string
- The provider-assigned unique ID for this managed resource.
- Instance
Id string - The EC2 Instance ID.
- Private
Dns stringName - The private DNS name of the specified instance. For example: ip-10-24-34-0.ec2.internal.
- Private
Ip string - The private IP address of the specified instance. For example: 10.24.34.0.
- Public
Dns stringName - The public DNS name of the specified instance. For example: ec2-107-20-50-45.compute-1.amazonaws.com.
- Public
Ip string - The public IP address of the specified instance. For example: 192.0.2.0.
- State
Instance
State Type - The current state of the instance.
- Vpc
Id string - The ID of the VPC that the instance is running in.
- id String
- The provider-assigned unique ID for this managed resource.
- instance
Id String - The EC2 Instance ID.
- private
Dns StringName - The private DNS name of the specified instance. For example: ip-10-24-34-0.ec2.internal.
- private
Ip String - The private IP address of the specified instance. For example: 10.24.34.0.
- public
Dns StringName - The public DNS name of the specified instance. For example: ec2-107-20-50-45.compute-1.amazonaws.com.
- public
Ip String - The public IP address of the specified instance. For example: 192.0.2.0.
- state
Instance
State - The current state of the instance.
- vpc
Id String - The ID of the VPC that the instance is running in.
- id string
- The provider-assigned unique ID for this managed resource.
- instance
Id string - The EC2 Instance ID.
- private
Dns stringName - The private DNS name of the specified instance. For example: ip-10-24-34-0.ec2.internal.
- private
Ip string - The private IP address of the specified instance. For example: 10.24.34.0.
- public
Dns stringName - The public DNS name of the specified instance. For example: ec2-107-20-50-45.compute-1.amazonaws.com.
- public
Ip string - The public IP address of the specified instance. For example: 192.0.2.0.
- state
Instance
State - The current state of the instance.
- vpc
Id 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
Instance
State - 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.
- instance
Id String - The EC2 Instance ID.
- private
Dns StringName - The private DNS name of the specified instance. For example: ip-10-24-34-0.ec2.internal.
- private
Ip String - The private IP address of the specified instance. For example: 10.24.34.0.
- public
Dns StringName - The public DNS name of the specified instance. For example: ec2-107-20-50-45.compute-1.amazonaws.com.
- public
Ip String - The public IP address of the specified instance. For example: 192.0.2.0.
- state Property Map
- The current state of the instance.
- vpc
Id String - The ID of the VPC that the instance is running in.
Supporting Types
CpuOptionsProperties, CpuOptionsPropertiesArgs
- Core
Count int - The number of CPU cores for the instance.
- Threads
Per intCore - 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.
- core
Count Integer - The number of CPU cores for the instance.
- threads
Per IntegerCore - The number of threads per CPU core.
- core
Count number - The number of CPU cores for the instance.
- threads
Per 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.
- core
Count Number - The number of CPU cores for the instance.
- threads
Per NumberCore - The number of threads per CPU core.
CreditSpecificationProperties, CreditSpecificationPropertiesArgs
- Cpu
Credits string The credit option for CPU usage of the instance.
Valid values:
standard
|unlimited
T3 instances with
host
tenancy do not support theunlimited
CPU credit option.
- Cpu
Credits string The credit option for CPU usage of the instance.
Valid values:
standard
|unlimited
T3 instances with
host
tenancy do not support theunlimited
CPU credit option.
- cpu
Credits String The credit option for CPU usage of the instance.
Valid values:
standard
|unlimited
T3 instances with
host
tenancy do not support theunlimited
CPU credit option.
- cpu
Credits string The credit option for CPU usage of the instance.
Valid values:
standard
|unlimited
T3 instances with
host
tenancy do not support theunlimited
CPU credit option.
- cpu_
credits str The credit option for CPU usage of the instance.
Valid values:
standard
|unlimited
T3 instances with
host
tenancy do not support theunlimited
CPU credit option.
- cpu
Credits String The credit option for CPU usage of the instance.
Valid values:
standard
|unlimited
T3 instances with
host
tenancy do not support theunlimited
CPU 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
- Instance
Affinity Default - default
- Instance
Affinity Host - host
- Default
- default
- Host
- host
- Default
- default
- Host
- host
- DEFAULT
- default
- HOST
- host
- "default"
- default
- "host"
- host
InstanceAssociationParameter, InstanceAssociationParameterArgs
InstanceBlockDeviceMapping, InstanceBlockDeviceMappingArgs
- Device
Name 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.
- No
Device 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 .
- Virtual
Name string The virtual device name (
ephemeral
N). The name must be in the formephemeral
X where X is a number starting from zero (0). For example, an instance type with 2 available instance store volumes can specify mappings forephemeral0
andephemeral1
. 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 string - The device name (for example, /dev/sdh or xvdh).
- Ebs
Instance
Ebs - Parameters used to automatically set up EBS volumes when the instance is launched.
- No
Device 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 .
- Virtual
Name string The virtual device name (
ephemeral
N). The name must be in the formephemeral
X where X is a number starting from zero (0). For example, an instance type with 2 available instance store volumes can specify mappings forephemeral0
andephemeral1
. 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 String - The device name (for example, /dev/sdh or xvdh).
- ebs
Instance
Ebs - Parameters used to automatically set up EBS volumes when the instance is launched.
- no
Device 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 .
- virtual
Name String The virtual device name (
ephemeral
N). The name must be in the formephemeral
X where X is a number starting from zero (0). For example, an instance type with 2 available instance store volumes can specify mappings forephemeral0
andephemeral1
. 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 string - The device name (for example, /dev/sdh or xvdh).
- ebs
Instance
Ebs - 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 string The virtual device name (
ephemeral
N). The name must be in the formephemeral
X where X is a number starting from zero (0). For example, an instance type with 2 available instance store volumes can specify mappings forephemeral0
andephemeral1
. 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
Instance
Ebs - 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 (
ephemeral
N). The name must be in the formephemeral
X where X is a number starting from zero (0). For example, an instance type with 2 available instance store volumes can specify mappings forephemeral0
andephemeral1
. 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 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.
- 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 String The virtual device name (
ephemeral
N). The name must be in the formephemeral
X where X is a number starting from zero (0). For example, an instance type with 2 available instance store volumes can specify mappings forephemeral0
andephemeral1
. 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
- 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 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.
- Snapshot
Id string - 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 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 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.
- Snapshot
Id string - 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 string - The volume type.
- delete
On 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.
- kms
Key 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.
- snapshot
Id String - The ID of the snapshot.
- volume
Size 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.
- volume
Type String - The volume type.
- delete
On 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.
- kms
Key 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.
- snapshot
Id string - The ID of the snapshot.
- volume
Size 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.
- volume
Type 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.
- delete
On 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.
- kms
Key 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.
- snapshot
Id String - The ID of the snapshot.
- volume
Size 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.
- volume
Type 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
- Launch
Template stringId - The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- Launch
Template 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 stringId - The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- Launch
Template 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 StringId - The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- launch
Template 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 stringId - The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- launch
Template 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.
- launch
Template StringId - The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
- launch
Template 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
- License
Configuration stringArn - The Amazon Resource Name (ARN) of the license configuration.
- License
Configuration stringArn - The Amazon Resource Name (ARN) of the license configuration.
- license
Configuration StringArn - The Amazon Resource Name (ARN) of the license configuration.
- license
Configuration stringArn - The Amazon Resource Name (ARN) of the license configuration.
- license_
configuration_ strarn - The Amazon Resource Name (ARN) of the license configuration.
- license
Configuration StringArn - The Amazon Resource Name (ARN) of the license configuration.
InstanceNetworkInterface, InstanceNetworkInterfaceArgs
- Device
Index string - 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 string
- The description of the network interface.
- Group
Set List<string> - The IDs of the security groups for the network interface.
- Ipv6Address
Count 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.
- Network
Interface stringId - The ID of the network interface.
- Private
Ip stringAddress - The private IPv4 address of the network interface.
- Private
Ip List<Pulumi.Addresses Aws Native. Ec2. Inputs. Instance 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 string - The ID of the subnet.
- Device
Index string - 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 string
- The description of the network interface.
- Group
Set []string - The IDs of the security groups for the network interface.
- Ipv6Address
Count int - A number of IPv6 addresses to assign to the network interface.
- Ipv6Addresses
[]Instance
Ipv6Address - The IPv6 addresses associated with the network interface.
- Network
Interface stringId - The ID of the network interface.
- Private
Ip stringAddress - The private IPv4 address of the network interface.
- Private
Ip []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 string - The ID of the subnet.
- device
Index String - The position of the network interface in the attachment order. A primary network interface has a device index of 0.
- associate
Carrier BooleanIp Address - Not currently supported by AWS CloudFormation.
- associate
Public BooleanIp Address - Indicates whether to assign a public IPv4 address to an instance you launch in a VPC.
- delete
On BooleanTermination - If set to true, the interface is deleted when the instance is terminated.
- description String
- The description of the network interface.
- group
Set List<String> - The IDs of the security groups for the network interface.
- ipv6Address
Count Integer - A number of IPv6 addresses to assign to the network interface.
- ipv6Addresses
List<Instance
Ipv6Address> - The IPv6 addresses associated with the network interface.
- network
Interface StringId - The ID of the network interface.
- private
Ip StringAddress - The private IPv4 address of the network interface.
- private
Ip List<InstanceAddresses Private Ip Address Specification> - One or more private IPv4 addresses to assign to the network interface.
- secondary
Private IntegerIp Address Count - The number of secondary private IPv4 addresses.
- subnet
Id String - The ID of the subnet.
- device
Index string - The position of the network interface in the attachment order. A primary network interface has a device index of 0.
- associate
Carrier booleanIp Address - Not currently supported by AWS CloudFormation.
- associate
Public booleanIp Address - Indicates whether to assign a public IPv4 address to an instance you launch in a VPC.
- delete
On booleanTermination - If set to true, the interface is deleted when the instance is terminated.
- description string
- The description of the network interface.
- group
Set string[] - The IDs of the security groups for the network interface.
- ipv6Address
Count number - A number of IPv6 addresses to assign to the network interface.
- ipv6Addresses
Instance
Ipv6Address[] - The IPv6 addresses associated with the network interface.
- network
Interface stringId - The ID of the network interface.
- private
Ip stringAddress - The private IPv4 address of the network interface.
- private
Ip InstanceAddresses Private Ip Address Specification[] - One or more private IPv4 addresses to assign to the network interface.
- secondary
Private numberIp Address Count - The number of secondary private IPv4 addresses.
- subnet
Id 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.
- device
Index String - The position of the network interface in the attachment order. A primary network interface has a device index of 0.
- associate
Carrier BooleanIp Address - Not currently supported by AWS CloudFormation.
- associate
Public BooleanIp Address - Indicates whether to assign a public IPv4 address to an instance you launch in a VPC.
- delete
On BooleanTermination - If set to true, the interface is deleted when the instance is terminated.
- description String
- The description of the network interface.
- group
Set List<String> - The IDs of the security groups for the network interface.
- ipv6Address
Count Number - A number of IPv6 addresses to assign to the network interface.
- ipv6Addresses List<Property Map>
- The IPv6 addresses associated with the network interface.
- network
Interface StringId - The ID of the network interface.
- private
Ip StringAddress - The private IPv4 address of the network interface.
- private
Ip List<Property Map>Addresses - One or more private IPv4 addresses to assign to the network interface.
- secondary
Private NumberIp Address Count - The number of secondary private IPv4 addresses.
- subnet
Id String - The ID of the subnet.
InstancePrivateDnsNameOptions, InstancePrivateDnsNameOptionsArgs
- Enable
Resource 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.
- 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 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.
- Enable
Resource 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.
- 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.
- enable
Resource 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.
- enable
Resource 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.
- 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.
- enable
Resource 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.
- enable
Resource 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.
- 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.
- 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.
- enable
Resource 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.
- enable
Resource 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.
- hostname
Type "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
- Ip
Name - ip-name
- Resource
Name - resource-name
- Instance
Private Dns Name Options Hostname Type Ip Name - ip-name
- Instance
Private Dns Name Options Hostname Type Resource Name - resource-name
- Ip
Name - ip-name
- Resource
Name - resource-name
- Ip
Name - ip-name
- Resource
Name - 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.
- Private
Ip 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 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.
- private
Ip 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.
- private
Ip 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.
- private
Ip StringAddress - The private IPv4 addresses.
InstanceSsmAssociation, InstanceSsmAssociationArgs
- Document
Name string - The name of an SSM document to associate with the instance.
- Association
Parameters List<Pulumi.Aws Native. Ec2. Inputs. Instance Association Parameter> - The input parameter values to use with the associated SSM document.
- Document
Name string - The name of an SSM document to associate with the instance.
- Association
Parameters []InstanceAssociation Parameter - The input parameter values to use with the associated SSM document.
- document
Name String - The name of an SSM document to associate with the instance.
- association
Parameters List<InstanceAssociation Parameter> - The input parameter values to use with the associated SSM document.
- document
Name string - The name of an SSM document to associate with the instance.
- association
Parameters 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.
- document
Name String - The name of an SSM document to associate with the instance.
- association
Parameters 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.