AWS Native v0.105.0, May 2 24

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.105.0 published on Thursday, May 2, 2024 by Pulumi

pulumi/pulumi-aws-native

aws-native.ec2.Instance

Explore with Pulumi AI

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.105.0 published on Thursday, May 2, 2024 by Pulumi

pulumi/pulumi-aws-native

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.

Example

The following reference example uses placeholder values for all input properties.

Coming soon!

Coming soon!

Coming soon!

Coming soon!

const aws_nativeInstanceResource = new aws_native.ec2.Instance("aws-nativeInstanceResource", {
    additionalInfo: "string",
    affinity: aws_native.ec2.InstanceAffinity.Default,
    availabilityZone: "string",
    blockDeviceMappings: [{
        deviceName: "string",
        ebs: {
            deleteOnTermination: false,
            encrypted: false,
            iops: 0,
            kmsKeyId: "string",
            snapshotId: "string",
            volumeSize: 0,
            volumeType: "string",
        },
        noDevice: "any",
        virtualName: "string",
    }],
    cpuOptions: {
        coreCount: 0,
        threadsPerCore: 0,
    },
    creditSpecification: {
        cpuCredits: "string",
    },
    disableApiTermination: false,
    ebsOptimized: false,
    elasticGpuSpecifications: [{
        type: "string",
    }],
    elasticInferenceAccelerators: [{
        type: "string",
        count: 0,
    }],
    enclaveOptions: {
        enabled: false,
    },
    hibernationOptions: {
        configured: false,
    },
    hostId: "string",
    hostResourceGroupArn: "string",
    iamInstanceProfile: "string",
    imageId: "string",
    instanceInitiatedShutdownBehavior: "string",
    instanceType: "string",
    ipv6AddressCount: 0,
    ipv6Addresses: [{
        ipv6Address: "string",
    }],
    kernelId: "string",
    keyName: "string",
    launchTemplate: {
        launchTemplateId: "string",
        launchTemplateName: "string",
        version: "string",
    },
    licenseSpecifications: [{
        licenseConfigurationArn: "string",
    }],
    monitoring: false,
    networkInterfaces: [{
        deviceIndex: "string",
        ipv6AddressCount: 0,
        deleteOnTermination: false,
        description: "string",
        associatePublicIpAddress: false,
        groupSet: ["string"],
        associateCarrierIpAddress: false,
        ipv6Addresses: [{
            ipv6Address: "string",
        }],
        networkInterfaceId: "string",
        privateIpAddress: "string",
        privateIpAddresses: [{
            primary: false,
            privateIpAddress: "string",
        }],
        secondaryPrivateIpAddressCount: 0,
        subnetId: "string",
    }],
    placementGroupName: "string",
    privateDnsNameOptions: {
        enableResourceNameDnsARecord: false,
        enableResourceNameDnsAaaaRecord: false,
        hostnameType: aws_native.ec2.InstancePrivateDnsNameOptionsHostnameType.IpName,
    },
    privateIpAddress: "string",
    propagateTagsToVolumeOnCreation: false,
    ramdiskId: "string",
    securityGroupIds: ["string"],
    securityGroups: ["string"],
    sourceDestCheck: false,
    ssmAssociations: [{
        documentName: "string",
        associationParameters: [{
            key: "string",
            value: ["string"],
        }],
    }],
    subnetId: "string",
    tags: [{
        key: "string",
        value: "string",
    }],
    tenancy: "string",
    userData: "string",
    volumes: [{
        device: "string",
        volumeId: "string",
    }],
});

Coming soon!

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:

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.AwsNative.Ec2.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.
BlockDeviceMappings List<Pulumi.AwsNative.Ec2.Inputs.InstanceBlockDeviceMapping>: The block device mapping entries that defines the block devices to attach to the instance at launch.
CpuOptions Pulumi.AwsNative.Ec2.Inputs.CpuOptionsProperties: The CPU options for the instance.
CreditSpecification Pulumi.AwsNative.Ec2.Inputs.CreditSpecificationProperties: The credit option for CPU usage of the burstable performance instance. Valid values are standard and unlimited.
DisableApiTermination bool: 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.
ElasticGpuSpecifications List<Pulumi.AwsNative.Ec2.Inputs.InstanceElasticGpuSpecification>: An elastic GPU to associate with the instance.
ElasticInferenceAccelerators List<Pulumi.AwsNative.Ec2.Inputs.InstanceElasticInferenceAccelerator>: An elastic inference accelerator to associate with the instance.
EnclaveOptions Pulumi.AwsNative.Ec2.Inputs.EnclaveOptionsProperties: Indicates whether the instance is enabled for AWS Nitro Enclaves.
HibernationOptions Pulumi.AwsNative.Ec2.Inputs.HibernationOptionsProperties: 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.
HostResourceGroupArn string: 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.
IamInstanceProfile string: 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.
InstanceInitiatedShutdownBehavior string: 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.AwsNative.Ec2.Inputs.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 Pulumi.AwsNative.Ec2.Inputs.InstanceLaunchTemplateSpecification: The launch template to use to launch the instances.
LicenseSpecifications List<Pulumi.AwsNative.Ec2.Inputs.InstanceLicenseSpecification>: The license configurations.
Monitoring bool: Specifies whether detailed monitoring is enabled for the instance.
NetworkInterfaces List<Pulumi.AwsNative.Ec2.Inputs.InstanceNetworkInterface>: The network interfaces to associate with the instance.
PlacementGroupName string: The name of an existing placement group that you want to launch the instance into (cluster | partition | spread).
PrivateDnsNameOptions Pulumi.AwsNative.Ec2.Inputs.InstancePrivateDnsNameOptions: The options for the instance hostname.
PrivateIpAddress string: [EC2-VPC] The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet.
PropagateTagsToVolumeOnCreation 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.
SecurityGroupIds List<string>: 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.
SourceDestCheck bool: Specifies whether to enable an instance launched in a VPC to perform NAT.
SsmAssociations List<Pulumi.AwsNative.Ec2.Inputs.InstanceSsmAssociation>: 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.
Tags List<Pulumi.AwsNative.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.AwsNative.Ec2.Inputs.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.
BlockDeviceMappings []InstanceBlockDeviceMappingArgs: The block device mapping entries that defines the block devices to attach to the instance at launch.
CpuOptions CpuOptionsPropertiesArgs: The CPU options for the instance.
CreditSpecification CreditSpecificationPropertiesArgs: The credit option for CPU usage of the burstable performance instance. Valid values are standard and unlimited.
DisableApiTermination bool: 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.
ElasticGpuSpecifications []InstanceElasticGpuSpecificationArgs: An elastic GPU to associate with the instance.
ElasticInferenceAccelerators []InstanceElasticInferenceAcceleratorArgs: An elastic inference accelerator to associate with the instance.
EnclaveOptions EnclaveOptionsPropertiesArgs: Indicates whether the instance is enabled for AWS Nitro Enclaves.
HibernationOptions HibernationOptionsPropertiesArgs: 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.
HostResourceGroupArn string: 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.
IamInstanceProfile string: 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.
InstanceInitiatedShutdownBehavior string: 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 []InstanceIpv6AddressArgs: [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 InstanceLaunchTemplateSpecificationArgs: The launch template to use to launch the instances.
LicenseSpecifications []InstanceLicenseSpecificationArgs: The license configurations.
Monitoring bool: Specifies whether detailed monitoring is enabled for the instance.
NetworkInterfaces []InstanceNetworkInterfaceArgs: The network interfaces to associate with the instance.
PlacementGroupName string: The name of an existing placement group that you want to launch the instance into (cluster | partition | spread).
PrivateDnsNameOptions InstancePrivateDnsNameOptionsArgs: The options for the instance hostname.
PrivateIpAddress string: [EC2-VPC] The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet.
PropagateTagsToVolumeOnCreation 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.
SecurityGroupIds []string: 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.
SourceDestCheck bool: Specifies whether to enable an instance launched in a VPC to perform NAT.
SsmAssociations []InstanceSsmAssociationArgs: 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.
Tags 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 []InstanceVolumeArgs: 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.
blockDeviceMappings List<InstanceBlockDeviceMapping>: The block device mapping entries that defines the block devices to attach to the instance at launch.
cpuOptions CpuOptionsProperties: The CPU options for the instance.
creditSpecification CreditSpecificationProperties: The credit option for CPU usage of the burstable performance instance. Valid values are standard and unlimited.
disableApiTermination Boolean: 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.
elasticGpuSpecifications List<InstanceElasticGpuSpecification>: An elastic GPU to associate with the instance.
elasticInferenceAccelerators List<InstanceElasticInferenceAccelerator>: An elastic inference accelerator to associate with the instance.
enclaveOptions EnclaveOptionsProperties: Indicates whether the instance is enabled for AWS Nitro Enclaves.
hibernationOptions HibernationOptionsProperties: 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.
hostResourceGroupArn String: 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.
iamInstanceProfile String: 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.
instanceInitiatedShutdownBehavior String: 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 InstanceLaunchTemplateSpecification: The launch template to use to launch the instances.
licenseSpecifications List<InstanceLicenseSpecification>: The license configurations.
monitoring Boolean: Specifies whether detailed monitoring is enabled for the instance.
networkInterfaces List<InstanceNetworkInterface>: The network interfaces to associate with the instance.
placementGroupName String: The name of an existing placement group that you want to launch the instance into (cluster | partition | spread).
privateDnsNameOptions InstancePrivateDnsNameOptions: The options for the instance hostname.
privateIpAddress String: [EC2-VPC] The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet.
propagateTagsToVolumeOnCreation 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.
securityGroupIds List<String>: 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.
sourceDestCheck Boolean: Specifies whether to enable an instance launched in a VPC to perform NAT.
ssmAssociations List<InstanceSsmAssociation>: 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.
tags 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.
blockDeviceMappings InstanceBlockDeviceMapping[]: The block device mapping entries that defines the block devices to attach to the instance at launch.
cpuOptions CpuOptionsProperties: The CPU options for the instance.
creditSpecification CreditSpecificationProperties: The credit option for CPU usage of the burstable performance instance. Valid values are standard and unlimited.
disableApiTermination boolean: 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.
elasticGpuSpecifications InstanceElasticGpuSpecification[]: An elastic GPU to associate with the instance.
elasticInferenceAccelerators InstanceElasticInferenceAccelerator[]: An elastic inference accelerator to associate with the instance.
enclaveOptions EnclaveOptionsProperties: Indicates whether the instance is enabled for AWS Nitro Enclaves.
hibernationOptions HibernationOptionsProperties: 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.
hostResourceGroupArn string: 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.
iamInstanceProfile string: 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.
instanceInitiatedShutdownBehavior string: 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 InstanceLaunchTemplateSpecification: The launch template to use to launch the instances.
licenseSpecifications InstanceLicenseSpecification[]: The license configurations.
monitoring boolean: Specifies whether detailed monitoring is enabled for the instance.
networkInterfaces InstanceNetworkInterface[]: The network interfaces to associate with the instance.
placementGroupName string: The name of an existing placement group that you want to launch the instance into (cluster | partition | spread).
privateDnsNameOptions InstancePrivateDnsNameOptions: The options for the instance hostname.
privateIpAddress string: [EC2-VPC] The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet.
propagateTagsToVolumeOnCreation 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.
securityGroupIds string[]: 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.
sourceDestCheck boolean: Specifies whether to enable an instance launched in a VPC to perform NAT.
ssmAssociations InstanceSsmAssociation[]: 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.
tags 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_mappings Sequence[InstanceBlockDeviceMappingArgs]: The block device mapping entries that defines the block devices to attach to the instance at launch.
cpu_options CpuOptionsPropertiesArgs: The CPU options for the instance.
credit_specification CreditSpecificationPropertiesArgs: The credit option for CPU usage of the burstable performance instance. Valid values are standard and unlimited.
disable_api_termination bool: 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_specifications Sequence[InstanceElasticGpuSpecificationArgs]: An elastic GPU to associate with the instance.
elastic_inference_accelerators Sequence[InstanceElasticInferenceAcceleratorArgs]: An elastic inference accelerator to associate with the instance.
enclave_options EnclaveOptionsPropertiesArgs: Indicates whether the instance is enabled for AWS Nitro Enclaves.
hibernation_options HibernationOptionsPropertiesArgs: 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_group_arn str: 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_profile str: 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_shutdown_behavior str: 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_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.
ipv6_addresses Sequence[InstanceIpv6AddressArgs]: [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 InstanceLaunchTemplateSpecificationArgs: The launch template to use to launch the instances.
license_specifications Sequence[InstanceLicenseSpecificationArgs]: The license configurations.
monitoring bool: Specifies whether detailed monitoring is enabled for the instance.
network_interfaces Sequence[InstanceNetworkInterfaceArgs]: The network interfaces to associate with the instance.
placement_group_name str: The name of an existing placement group that you want to launch the instance into (cluster | partition | spread).
private_dns_name_options InstancePrivateDnsNameOptionsArgs: The options for the instance hostname.
private_ip_address str: [EC2-VPC] The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet.
propagate_tags_to_volume_on_creation 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_ids Sequence[str]: 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_check bool: Specifies whether to enable an instance launched in a VPC to perform NAT.
ssm_associations Sequence[InstanceSsmAssociationArgs]: 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.
tags 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[InstanceVolumeArgs]: 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.
blockDeviceMappings List<Property Map>: 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.
disableApiTermination Boolean: 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.
elasticGpuSpecifications List<Property Map>: An elastic GPU to associate with the instance.
elasticInferenceAccelerators List<Property Map>: 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.
hostResourceGroupArn String: 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.
iamInstanceProfile String: 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.
instanceInitiatedShutdownBehavior String: 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.
placementGroupName String: The name of an existing placement group that you want to launch the instance into (cluster | partition | spread).
privateDnsNameOptions Property Map: The options for the instance hostname.
privateIpAddress String: [EC2-VPC] The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet.
propagateTagsToVolumeOnCreation 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.
securityGroupIds List<String>: 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.
sourceDestCheck Boolean: 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.
tags 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.
PrivateDnsName string: 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.
PublicDnsName string: 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.AwsNative.Ec2.Outputs.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.
PrivateDnsName string: 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.
PublicDnsName string: 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 InstanceStateType: 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.
privateDnsName String: 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.
publicDnsName String: 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.
privateDnsName string: 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.
publicDnsName string: 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_name str: 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_name str: 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.
privateDnsName String: 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.
publicDnsName String: 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
ThreadsPerCore int

CoreCount int
ThreadsPerCore int

coreCount Integer
threadsPerCore Integer

coreCount number
threadsPerCore number

core_count int
threads_per_core int

coreCount Number
threadsPerCore Number

CreditSpecificationProperties, CreditSpecificationPropertiesArgs

CpuCredits string

CpuCredits string

cpuCredits String

cpuCredits string

cpu_credits str

cpuCredits String

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

InstanceAffinityDefault: default
InstanceAffinityHost: host

Default: default
Host: host

Default: default
Host: host

DEFAULT: default
HOST: host

"default": default
"host": host

InstanceAssociationParameter, InstanceAssociationParameterArgs

Key string: The name of an input parameter that is in the associated SSM document.
Value List<string>: The value of an input parameter.

Key string: The name of an input parameter that is in the associated SSM document.
Value []string: The value of an input parameter.

key String: The name of an input parameter that is in the associated SSM document.
value List<String>: The value of an input parameter.

key string: The name of an input parameter that is in the associated SSM document.
value string[]: The value of an input parameter.

key str: The name of an input parameter that is in the associated SSM document.
value Sequence[str]: The value of an input parameter.

key String: The name of an input parameter that is in the associated SSM document.
value List<String>: The value of an input parameter.

InstanceBlockDeviceMapping, InstanceBlockDeviceMappingArgs

DeviceName string: The device name (for example, /dev/sdh or xvdh).
Ebs Pulumi.AwsNative.Ec2.Inputs.InstanceEbs: Parameters used to automatically set up EBS volumes when the instance is launched.
NoDevice object
VirtualName string

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{}
VirtualName string

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
virtualName String

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
virtualName string

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
virtual_name str

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
virtualName String

InstanceEbs, InstanceEbsArgs

DeleteOnTermination bool: 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.
KmsKeyId string: 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.

DeleteOnTermination bool: 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.
KmsKeyId string: 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.

deleteOnTermination Boolean: 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.
kmsKeyId String: 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.

deleteOnTermination boolean: 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.
kmsKeyId string: 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_termination bool: 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_id str: 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.

deleteOnTermination Boolean: 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.
kmsKeyId String: 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

Type string: The type of elastic inference accelerator.
Count int: The number of elastic inference accelerators to attach to the instance.

Type string: The type of elastic inference accelerator.
Count int: The number of elastic inference accelerators to attach to the instance.

type String: The type of elastic inference accelerator.
count Integer: The number of elastic inference accelerators to attach to the instance.

type string: The type of elastic inference accelerator.
count number: The number of elastic inference accelerators to attach to the instance.

type str: The type of elastic inference accelerator.
count int: The number of elastic inference accelerators to attach to the instance.

type String: The type of elastic inference accelerator.
count Number: The number of elastic inference accelerators to attach to the instance.

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

LaunchTemplateId string: The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
LaunchTemplateName string: 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.

LaunchTemplateId string: The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
LaunchTemplateName string: 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.

launchTemplateId String: The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
launchTemplateName String: 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.

launchTemplateId string: The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
launchTemplateName string: 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_id str: The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
launch_template_name str: 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.

launchTemplateId String: The ID of the launch template. You must specify the LaunchTemplateName or the LaunchTemplateId, but not both.
launchTemplateName String: 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

LicenseConfigurationArn string: The Amazon Resource Name (ARN) of the license configuration.

LicenseConfigurationArn string: The Amazon Resource Name (ARN) of the license configuration.

licenseConfigurationArn String: The Amazon Resource Name (ARN) of the license configuration.

licenseConfigurationArn string: The Amazon Resource Name (ARN) of the license configuration.

license_configuration_arn str: The Amazon Resource Name (ARN) of the license configuration.

licenseConfigurationArn String: 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.
AssociateCarrierIpAddress bool: Not currently supported by AWS CloudFormation.
AssociatePublicIpAddress bool: Indicates whether to assign a public IPv4 address to an instance you launch in a VPC.
DeleteOnTermination bool: 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.AwsNative.Ec2.Inputs.InstanceIpv6Address>: The IPv6 addresses associated with the network interface.
NetworkInterfaceId string: The ID of the network interface.
PrivateIpAddress string: The private IPv4 address of the network interface.
PrivateIpAddresses List<Pulumi.AwsNative.Ec2.Inputs.InstancePrivateIpAddressSpecification>: One or more private IPv4 addresses to assign to the network interface.
SecondaryPrivateIpAddressCount int: 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.
AssociateCarrierIpAddress bool: Not currently supported by AWS CloudFormation.
AssociatePublicIpAddress bool: Indicates whether to assign a public IPv4 address to an instance you launch in a VPC.
DeleteOnTermination bool: 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.
NetworkInterfaceId string: The ID of the network interface.
PrivateIpAddress string: The private IPv4 address of the network interface.
PrivateIpAddresses []InstancePrivateIpAddressSpecification: One or more private IPv4 addresses to assign to the network interface.
SecondaryPrivateIpAddressCount int: 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.
associateCarrierIpAddress Boolean: Not currently supported by AWS CloudFormation.
associatePublicIpAddress Boolean: Indicates whether to assign a public IPv4 address to an instance you launch in a VPC.
deleteOnTermination Boolean: 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.
networkInterfaceId String: The ID of the network interface.
privateIpAddress String: The private IPv4 address of the network interface.
privateIpAddresses List<InstancePrivateIpAddressSpecification>: One or more private IPv4 addresses to assign to the network interface.
secondaryPrivateIpAddressCount Integer: 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.
associateCarrierIpAddress boolean: Not currently supported by AWS CloudFormation.
associatePublicIpAddress boolean: Indicates whether to assign a public IPv4 address to an instance you launch in a VPC.
deleteOnTermination boolean: 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.
networkInterfaceId string: The ID of the network interface.
privateIpAddress string: The private IPv4 address of the network interface.
privateIpAddresses InstancePrivateIpAddressSpecification[]: One or more private IPv4 addresses to assign to the network interface.
secondaryPrivateIpAddressCount number: 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_ip_address bool: Not currently supported by AWS CloudFormation.
associate_public_ip_address bool: Indicates whether to assign a public IPv4 address to an instance you launch in a VPC.
delete_on_termination bool: 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_count int: 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_id str: The ID of the network interface.
private_ip_address str: The private IPv4 address of the network interface.
private_ip_addresses Sequence[InstancePrivateIpAddressSpecification]: One or more private IPv4 addresses to assign to the network interface.
secondary_private_ip_address_count int: 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.
associateCarrierIpAddress Boolean: Not currently supported by AWS CloudFormation.
associatePublicIpAddress Boolean: Indicates whether to assign a public IPv4 address to an instance you launch in a VPC.
deleteOnTermination Boolean: 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.
networkInterfaceId String: The ID of the network interface.
privateIpAddress String: The private IPv4 address of the network interface.
privateIpAddresses List<Property Map>: One or more private IPv4 addresses to assign to the network interface.
secondaryPrivateIpAddressCount Number: The number of secondary private IPv4 addresses.
subnetId String: The ID of the subnet.

InstancePrivateDnsNameOptions, InstancePrivateDnsNameOptionsArgs

EnableResourceNameDnsARecord bool: 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.
EnableResourceNameDnsAaaaRecord bool: 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.AwsNative.Ec2.InstancePrivateDnsNameOptionsHostnameType: 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.

EnableResourceNameDnsARecord bool: 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.
EnableResourceNameDnsAaaaRecord bool: 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 InstancePrivateDnsNameOptionsHostnameType: 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.

enableResourceNameDnsARecord Boolean: 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.
enableResourceNameDnsAaaaRecord Boolean: 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 InstancePrivateDnsNameOptionsHostnameType: 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.

enableResourceNameDnsARecord boolean: 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.
enableResourceNameDnsAaaaRecord boolean: 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 InstancePrivateDnsNameOptionsHostnameType: 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_name_dns_a_record bool: 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_name_dns_aaaa_record bool: 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 InstancePrivateDnsNameOptionsHostnameType: 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.

enableResourceNameDnsARecord Boolean: 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.
enableResourceNameDnsAaaaRecord Boolean: 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

InstancePrivateDnsNameOptionsHostnameTypeIpName: ip-name
InstancePrivateDnsNameOptionsHostnameTypeResourceName: 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.
PrivateIpAddress string: 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.
PrivateIpAddress string: 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.
privateIpAddress String: 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.
privateIpAddress string: 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_address str: 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.
privateIpAddress String: The private IPv4 addresses.

InstanceSsmAssociation, InstanceSsmAssociationArgs

DocumentName string: The name of an SSM document to associate with the instance.
AssociationParameters List<Pulumi.AwsNative.Ec2.Inputs.InstanceAssociationParameter>: 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 []InstanceAssociationParameter: 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<InstanceAssociationParameter>: 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 InstanceAssociationParameter[]: 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[InstanceAssociationParameter]: 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

Code string: The state of the instance as a 16-bit unsigned integer.
Name string: The current state of the instance.

Code string: The state of the instance as a 16-bit unsigned integer.
Name string: The current state of the instance.

code String: The state of the instance as a 16-bit unsigned integer.
name String: The current state of the instance.

code string: The state of the instance as a 16-bit unsigned integer.
name string: The current state of the instance.

code str: The state of the instance as a 16-bit unsigned integer.
name str: The current state of the instance.

code String: The state of the instance as a 16-bit unsigned integer.
name String: The current state of the instance.

InstanceVolume, InstanceVolumeArgs

Device string: The device name (for example, /dev/sdh or xvdh).
VolumeId string: The ID of the EBS volume. The volume and instance must be within the same Availability Zone.

Device string: The device name (for example, /dev/sdh or xvdh).
VolumeId string: The ID of the EBS volume. The volume and instance must be within the same Availability Zone.

device String: The device name (for example, /dev/sdh or xvdh).
volumeId String: The ID of the EBS volume. The volume and instance must be within the same Availability Zone.

device string: The device name (for example, /dev/sdh or xvdh).
volumeId string: The ID of the EBS volume. The volume and instance must be within the same Availability Zone.

device str: The device name (for example, /dev/sdh or xvdh).
volume_id str: The ID of the EBS volume. The volume and instance must be within the same Availability Zone.

device String: The device name (for example, /dev/sdh or xvdh).
volumeId String: The ID of the EBS volume. The volume and instance must be within the same Availability Zone.

Tag, TagArgs

Key string: The key name of the tag
Value string: The value of the tag

Key string: The key name of the tag
Value string: The value of the tag

key String: The key name of the tag
value String: The value of the tag

key string: The key name of the tag
value string: The value of the tag

key str: The key name of the tag
value str: The value of the tag

key String: The key name of the tag
value String: The value of the tag

Package Details

Repository: AWS Native pulumi/pulumi-aws-native
License: Apache-2.0

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.105.0 published on Thursday, May 2, 2024 by Pulumi

pulumi/pulumi-aws-native

aws-native.ec2.Instance

On this page

On this page

Create Instance Resource

Constructor syntax

Parameters

Example

Instance Resource Properties

Inputs

Outputs

Supporting Types

CpuOptionsProperties, CpuOptionsPropertiesArgs

CreditSpecificationProperties, CreditSpecificationPropertiesArgs

EnclaveOptionsProperties, EnclaveOptionsPropertiesArgs

HibernationOptionsProperties, HibernationOptionsPropertiesArgs

InstanceAffinity, InstanceAffinityArgs

InstanceAssociationParameter, InstanceAssociationParameterArgs

InstanceBlockDeviceMapping, InstanceBlockDeviceMappingArgs

InstanceEbs, InstanceEbsArgs

InstanceElasticGpuSpecification, InstanceElasticGpuSpecificationArgs

InstanceElasticInferenceAccelerator, InstanceElasticInferenceAcceleratorArgs

InstanceIpv6Address, InstanceIpv6AddressArgs

InstanceLaunchTemplateSpecification, InstanceLaunchTemplateSpecificationArgs

InstanceLicenseSpecification, InstanceLicenseSpecificationArgs

InstanceNetworkInterface, InstanceNetworkInterfaceArgs

InstancePrivateDnsNameOptions, InstancePrivateDnsNameOptionsArgs

InstancePrivateDnsNameOptionsHostnameType, InstancePrivateDnsNameOptionsHostnameTypeArgs

InstancePrivateIpAddressSpecification, InstancePrivateIpAddressSpecificationArgs

InstanceSsmAssociation, InstanceSsmAssociationArgs

InstanceState, InstanceStateArgs

InstanceVolume, InstanceVolumeArgs

Tag, TagArgs

Package Details

On this page

On this page