1. Packages
  2. AWS Native
  3. API Docs
  4. ec2
  5. NetworkInterface

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

AWS Native v0.102.0 published on Tuesday, Apr 16, 2024 by Pulumi

aws-native.ec2.NetworkInterface

Explore with Pulumi AI

aws-native logo

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

AWS Native v0.102.0 published on Tuesday, Apr 16, 2024 by Pulumi

    The AWS::EC2::NetworkInterface resource creates network interface

    Create NetworkInterface Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new NetworkInterface(name: string, args: NetworkInterfaceArgs, opts?: CustomResourceOptions);
    @overload
    def NetworkInterface(resource_name: str,
                         args: NetworkInterfaceArgs,
                         opts: Optional[ResourceOptions] = None)
    
    @overload
    def NetworkInterface(resource_name: str,
                         opts: Optional[ResourceOptions] = None,
                         subnet_id: Optional[str] = None,
                         ipv6_addresses: Optional[Sequence[NetworkInterfaceInstanceIpv6AddressArgs]] = None,
                         ipv6_address_count: Optional[int] = None,
                         group_set: Optional[Sequence[str]] = None,
                         interface_type: Optional[str] = None,
                         ipv6_prefix_count: Optional[int] = None,
                         ipv4_prefixes: Optional[Sequence[NetworkInterfaceIpv4PrefixSpecificationArgs]] = None,
                         enable_primary_ipv6: Optional[bool] = None,
                         connection_tracking_specification: Optional[NetworkInterfaceConnectionTrackingSpecificationArgs] = None,
                         ipv4_prefix_count: Optional[int] = None,
                         ipv6_prefixes: Optional[Sequence[NetworkInterfaceIpv6PrefixSpecificationArgs]] = None,
                         private_ip_address: Optional[str] = None,
                         private_ip_addresses: Optional[Sequence[NetworkInterfacePrivateIpAddressSpecificationArgs]] = None,
                         secondary_private_ip_address_count: Optional[int] = None,
                         source_dest_check: Optional[bool] = None,
                         description: Optional[str] = None,
                         tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
    func NewNetworkInterface(ctx *Context, name string, args NetworkInterfaceArgs, opts ...ResourceOption) (*NetworkInterface, error)
    public NetworkInterface(string name, NetworkInterfaceArgs args, CustomResourceOptions? opts = null)
    public NetworkInterface(String name, NetworkInterfaceArgs args)
    public NetworkInterface(String name, NetworkInterfaceArgs args, CustomResourceOptions options)
    
    type: aws-native:ec2:NetworkInterface
    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 NetworkInterfaceArgs
    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 NetworkInterfaceArgs
    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 NetworkInterfaceArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args NetworkInterfaceArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args NetworkInterfaceArgs
    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 networkInterfaceResource = new aws_native.ec2.NetworkInterface("networkInterfaceResource", {
        subnetId: "string",
        ipv6Addresses: [{
            ipv6Address: "string",
        }],
        ipv6AddressCount: 0,
        groupSet: ["string"],
        interfaceType: "string",
        ipv6PrefixCount: 0,
        ipv4Prefixes: [{
            ipv4Prefix: "string",
        }],
        enablePrimaryIpv6: false,
        connectionTrackingSpecification: {
            tcpEstablishedTimeout: 0,
            udpStreamTimeout: 0,
            udpTimeout: 0,
        },
        ipv4PrefixCount: 0,
        ipv6Prefixes: [{
            ipv6Prefix: "string",
        }],
        privateIpAddress: "string",
        privateIpAddresses: [{
            primary: false,
            privateIpAddress: "string",
        }],
        secondaryPrivateIpAddressCount: 0,
        sourceDestCheck: false,
        description: "string",
        tags: [{
            key: "string",
            value: "string",
        }],
    });
    
    Coming soon!
    

    NetworkInterface 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 NetworkInterface resource accepts the following input properties:

    SubnetId string
    The ID of the subnet to associate with the network interface.
    ConnectionTrackingSpecification Pulumi.AwsNative.Ec2.Inputs.NetworkInterfaceConnectionTrackingSpecification
    Description string
    A description for the network interface.
    EnablePrimaryIpv6 bool
    If you have instances or ENIs that rely on the IPv6 address not changing, to avoid disrupting traffic to instances or ENIs, you can enable a primary IPv6 address. Enable this option to automatically assign an IPv6 associated with the ENI attached to your instance to be the primary IPv6 address. When you enable an IPv6 address to be a primary IPv6, you cannot disable it. Traffic will be routed to the primary IPv6 address until the instance is terminated or the ENI is detached. If you have multiple IPv6 addresses associated with an ENI and you enable a primary IPv6 address, the first IPv6 address associated with the ENI becomes the primary IPv6 address.
    GroupSet List<string>
    A list of security group IDs associated with this network interface.
    InterfaceType string
    Indicates the type of network interface.
    Ipv4PrefixCount int
    The number of IPv4 prefixes to assign to a network interface. When you specify a number of IPv4 prefixes, Amazon EC2 selects these prefixes from your existing subnet CIDR reservations, if available, or from free spaces in the subnet. By default, these will be /28 prefixes. You can't specify a count of IPv4 prefixes if you've specified one of the following: specific IPv4 prefixes, specific private IPv4 addresses, or a count of private IPv4 addresses.
    Ipv4Prefixes List<Pulumi.AwsNative.Ec2.Inputs.NetworkInterfaceIpv4PrefixSpecification>
    Assigns a list of IPv4 prefixes to the network interface. If you want EC2 to automatically assign IPv4 prefixes, use the Ipv4PrefixCount property and do not specify this property. Presently, only /28 prefixes are supported. You can't specify IPv4 prefixes if you've specified one of the following: a count of IPv4 prefixes, specific private IPv4 addresses, or a count of private IPv4 addresses.
    Ipv6AddressCount int
    The number of IPv6 addresses to assign to a network interface. Amazon EC2 automatically selects the IPv6 addresses from the subnet range. To specify specific IPv6 addresses, use the Ipv6Addresses property and don't specify this property.
    Ipv6Addresses List<Pulumi.AwsNative.Ec2.Inputs.NetworkInterfaceInstanceIpv6Address>
    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet to associate with the network interface. If you're specifying a number of IPv6 addresses, use the Ipv6AddressCount property and don't specify this property.
    Ipv6PrefixCount int
    The number of IPv6 prefixes to assign to a network interface. When you specify a number of IPv6 prefixes, Amazon EC2 selects these prefixes from your existing subnet CIDR reservations, if available, or from free spaces in the subnet. By default, these will be /80 prefixes. You can't specify a count of IPv6 prefixes if you've specified one of the following: specific IPv6 prefixes, specific IPv6 addresses, or a count of IPv6 addresses.
    Ipv6Prefixes List<Pulumi.AwsNative.Ec2.Inputs.NetworkInterfaceIpv6PrefixSpecification>
    Assigns a list of IPv6 prefixes to the network interface. If you want EC2 to automatically assign IPv6 prefixes, use the Ipv6PrefixCount property and do not specify this property. Presently, only /80 prefixes are supported. You can't specify IPv6 prefixes if you've specified one of the following: a count of IPv6 prefixes, specific IPv6 addresses, or a count of IPv6 addresses.
    PrivateIpAddress string
    Assigns a single private IP address to the network interface, which is used as the primary private IP address. If you want to specify multiple private IP address, use the PrivateIpAddresses property.
    PrivateIpAddresses List<Pulumi.AwsNative.Ec2.Inputs.NetworkInterfacePrivateIpAddressSpecification>
    Assigns a list of private IP addresses to the network interface. You can specify a primary private IP address by setting the value of the Primary property to true in the PrivateIpAddressSpecification property. If you want EC2 to automatically assign private IP addresses, use the SecondaryPrivateIpAddressCount property and do not specify this property.
    SecondaryPrivateIpAddressCount int
    The number of secondary private IPv4 addresses to assign to a network interface. When you specify a number of secondary IPv4 addresses, Amazon EC2 selects these IP addresses within the subnet's IPv4 CIDR range. You can't specify this option and specify more than one private IP address using privateIpAddresses
    SourceDestCheck bool
    Indicates whether traffic to or from the instance is validated.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    An arbitrary set of tags (key-value pairs) for this network interface.
    SubnetId string
    The ID of the subnet to associate with the network interface.
    ConnectionTrackingSpecification NetworkInterfaceConnectionTrackingSpecificationArgs
    Description string
    A description for the network interface.
    EnablePrimaryIpv6 bool
    If you have instances or ENIs that rely on the IPv6 address not changing, to avoid disrupting traffic to instances or ENIs, you can enable a primary IPv6 address. Enable this option to automatically assign an IPv6 associated with the ENI attached to your instance to be the primary IPv6 address. When you enable an IPv6 address to be a primary IPv6, you cannot disable it. Traffic will be routed to the primary IPv6 address until the instance is terminated or the ENI is detached. If you have multiple IPv6 addresses associated with an ENI and you enable a primary IPv6 address, the first IPv6 address associated with the ENI becomes the primary IPv6 address.
    GroupSet []string
    A list of security group IDs associated with this network interface.
    InterfaceType string
    Indicates the type of network interface.
    Ipv4PrefixCount int
    The number of IPv4 prefixes to assign to a network interface. When you specify a number of IPv4 prefixes, Amazon EC2 selects these prefixes from your existing subnet CIDR reservations, if available, or from free spaces in the subnet. By default, these will be /28 prefixes. You can't specify a count of IPv4 prefixes if you've specified one of the following: specific IPv4 prefixes, specific private IPv4 addresses, or a count of private IPv4 addresses.
    Ipv4Prefixes []NetworkInterfaceIpv4PrefixSpecificationArgs
    Assigns a list of IPv4 prefixes to the network interface. If you want EC2 to automatically assign IPv4 prefixes, use the Ipv4PrefixCount property and do not specify this property. Presently, only /28 prefixes are supported. You can't specify IPv4 prefixes if you've specified one of the following: a count of IPv4 prefixes, specific private IPv4 addresses, or a count of private IPv4 addresses.
    Ipv6AddressCount int
    The number of IPv6 addresses to assign to a network interface. Amazon EC2 automatically selects the IPv6 addresses from the subnet range. To specify specific IPv6 addresses, use the Ipv6Addresses property and don't specify this property.
    Ipv6Addresses []NetworkInterfaceInstanceIpv6AddressArgs
    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet to associate with the network interface. If you're specifying a number of IPv6 addresses, use the Ipv6AddressCount property and don't specify this property.
    Ipv6PrefixCount int
    The number of IPv6 prefixes to assign to a network interface. When you specify a number of IPv6 prefixes, Amazon EC2 selects these prefixes from your existing subnet CIDR reservations, if available, or from free spaces in the subnet. By default, these will be /80 prefixes. You can't specify a count of IPv6 prefixes if you've specified one of the following: specific IPv6 prefixes, specific IPv6 addresses, or a count of IPv6 addresses.
    Ipv6Prefixes []NetworkInterfaceIpv6PrefixSpecificationArgs
    Assigns a list of IPv6 prefixes to the network interface. If you want EC2 to automatically assign IPv6 prefixes, use the Ipv6PrefixCount property and do not specify this property. Presently, only /80 prefixes are supported. You can't specify IPv6 prefixes if you've specified one of the following: a count of IPv6 prefixes, specific IPv6 addresses, or a count of IPv6 addresses.
    PrivateIpAddress string
    Assigns a single private IP address to the network interface, which is used as the primary private IP address. If you want to specify multiple private IP address, use the PrivateIpAddresses property.
    PrivateIpAddresses []NetworkInterfacePrivateIpAddressSpecificationArgs
    Assigns a list of private IP addresses to the network interface. You can specify a primary private IP address by setting the value of the Primary property to true in the PrivateIpAddressSpecification property. If you want EC2 to automatically assign private IP addresses, use the SecondaryPrivateIpAddressCount property and do not specify this property.
    SecondaryPrivateIpAddressCount int
    The number of secondary private IPv4 addresses to assign to a network interface. When you specify a number of secondary IPv4 addresses, Amazon EC2 selects these IP addresses within the subnet's IPv4 CIDR range. You can't specify this option and specify more than one private IP address using privateIpAddresses
    SourceDestCheck bool
    Indicates whether traffic to or from the instance is validated.
    Tags TagArgs
    An arbitrary set of tags (key-value pairs) for this network interface.
    subnetId String
    The ID of the subnet to associate with the network interface.
    connectionTrackingSpecification NetworkInterfaceConnectionTrackingSpecification
    description String
    A description for the network interface.
    enablePrimaryIpv6 Boolean
    If you have instances or ENIs that rely on the IPv6 address not changing, to avoid disrupting traffic to instances or ENIs, you can enable a primary IPv6 address. Enable this option to automatically assign an IPv6 associated with the ENI attached to your instance to be the primary IPv6 address. When you enable an IPv6 address to be a primary IPv6, you cannot disable it. Traffic will be routed to the primary IPv6 address until the instance is terminated or the ENI is detached. If you have multiple IPv6 addresses associated with an ENI and you enable a primary IPv6 address, the first IPv6 address associated with the ENI becomes the primary IPv6 address.
    groupSet List<String>
    A list of security group IDs associated with this network interface.
    interfaceType String
    Indicates the type of network interface.
    ipv4PrefixCount Integer
    The number of IPv4 prefixes to assign to a network interface. When you specify a number of IPv4 prefixes, Amazon EC2 selects these prefixes from your existing subnet CIDR reservations, if available, or from free spaces in the subnet. By default, these will be /28 prefixes. You can't specify a count of IPv4 prefixes if you've specified one of the following: specific IPv4 prefixes, specific private IPv4 addresses, or a count of private IPv4 addresses.
    ipv4Prefixes List<NetworkInterfaceIpv4PrefixSpecification>
    Assigns a list of IPv4 prefixes to the network interface. If you want EC2 to automatically assign IPv4 prefixes, use the Ipv4PrefixCount property and do not specify this property. Presently, only /28 prefixes are supported. You can't specify IPv4 prefixes if you've specified one of the following: a count of IPv4 prefixes, specific private IPv4 addresses, or a count of private IPv4 addresses.
    ipv6AddressCount Integer
    The number of IPv6 addresses to assign to a network interface. Amazon EC2 automatically selects the IPv6 addresses from the subnet range. To specify specific IPv6 addresses, use the Ipv6Addresses property and don't specify this property.
    ipv6Addresses List<NetworkInterfaceInstanceIpv6Address>
    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet to associate with the network interface. If you're specifying a number of IPv6 addresses, use the Ipv6AddressCount property and don't specify this property.
    ipv6PrefixCount Integer
    The number of IPv6 prefixes to assign to a network interface. When you specify a number of IPv6 prefixes, Amazon EC2 selects these prefixes from your existing subnet CIDR reservations, if available, or from free spaces in the subnet. By default, these will be /80 prefixes. You can't specify a count of IPv6 prefixes if you've specified one of the following: specific IPv6 prefixes, specific IPv6 addresses, or a count of IPv6 addresses.
    ipv6Prefixes List<NetworkInterfaceIpv6PrefixSpecification>
    Assigns a list of IPv6 prefixes to the network interface. If you want EC2 to automatically assign IPv6 prefixes, use the Ipv6PrefixCount property and do not specify this property. Presently, only /80 prefixes are supported. You can't specify IPv6 prefixes if you've specified one of the following: a count of IPv6 prefixes, specific IPv6 addresses, or a count of IPv6 addresses.
    privateIpAddress String
    Assigns a single private IP address to the network interface, which is used as the primary private IP address. If you want to specify multiple private IP address, use the PrivateIpAddresses property.
    privateIpAddresses List<NetworkInterfacePrivateIpAddressSpecification>
    Assigns a list of private IP addresses to the network interface. You can specify a primary private IP address by setting the value of the Primary property to true in the PrivateIpAddressSpecification property. If you want EC2 to automatically assign private IP addresses, use the SecondaryPrivateIpAddressCount property and do not specify this property.
    secondaryPrivateIpAddressCount Integer
    The number of secondary private IPv4 addresses to assign to a network interface. When you specify a number of secondary IPv4 addresses, Amazon EC2 selects these IP addresses within the subnet's IPv4 CIDR range. You can't specify this option and specify more than one private IP address using privateIpAddresses
    sourceDestCheck Boolean
    Indicates whether traffic to or from the instance is validated.
    tags List<Tag>
    An arbitrary set of tags (key-value pairs) for this network interface.
    subnetId string
    The ID of the subnet to associate with the network interface.
    connectionTrackingSpecification NetworkInterfaceConnectionTrackingSpecification
    description string
    A description for the network interface.
    enablePrimaryIpv6 boolean
    If you have instances or ENIs that rely on the IPv6 address not changing, to avoid disrupting traffic to instances or ENIs, you can enable a primary IPv6 address. Enable this option to automatically assign an IPv6 associated with the ENI attached to your instance to be the primary IPv6 address. When you enable an IPv6 address to be a primary IPv6, you cannot disable it. Traffic will be routed to the primary IPv6 address until the instance is terminated or the ENI is detached. If you have multiple IPv6 addresses associated with an ENI and you enable a primary IPv6 address, the first IPv6 address associated with the ENI becomes the primary IPv6 address.
    groupSet string[]
    A list of security group IDs associated with this network interface.
    interfaceType string
    Indicates the type of network interface.
    ipv4PrefixCount number
    The number of IPv4 prefixes to assign to a network interface. When you specify a number of IPv4 prefixes, Amazon EC2 selects these prefixes from your existing subnet CIDR reservations, if available, or from free spaces in the subnet. By default, these will be /28 prefixes. You can't specify a count of IPv4 prefixes if you've specified one of the following: specific IPv4 prefixes, specific private IPv4 addresses, or a count of private IPv4 addresses.
    ipv4Prefixes NetworkInterfaceIpv4PrefixSpecification[]
    Assigns a list of IPv4 prefixes to the network interface. If you want EC2 to automatically assign IPv4 prefixes, use the Ipv4PrefixCount property and do not specify this property. Presently, only /28 prefixes are supported. You can't specify IPv4 prefixes if you've specified one of the following: a count of IPv4 prefixes, specific private IPv4 addresses, or a count of private IPv4 addresses.
    ipv6AddressCount number
    The number of IPv6 addresses to assign to a network interface. Amazon EC2 automatically selects the IPv6 addresses from the subnet range. To specify specific IPv6 addresses, use the Ipv6Addresses property and don't specify this property.
    ipv6Addresses NetworkInterfaceInstanceIpv6Address[]
    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet to associate with the network interface. If you're specifying a number of IPv6 addresses, use the Ipv6AddressCount property and don't specify this property.
    ipv6PrefixCount number
    The number of IPv6 prefixes to assign to a network interface. When you specify a number of IPv6 prefixes, Amazon EC2 selects these prefixes from your existing subnet CIDR reservations, if available, or from free spaces in the subnet. By default, these will be /80 prefixes. You can't specify a count of IPv6 prefixes if you've specified one of the following: specific IPv6 prefixes, specific IPv6 addresses, or a count of IPv6 addresses.
    ipv6Prefixes NetworkInterfaceIpv6PrefixSpecification[]
    Assigns a list of IPv6 prefixes to the network interface. If you want EC2 to automatically assign IPv6 prefixes, use the Ipv6PrefixCount property and do not specify this property. Presently, only /80 prefixes are supported. You can't specify IPv6 prefixes if you've specified one of the following: a count of IPv6 prefixes, specific IPv6 addresses, or a count of IPv6 addresses.
    privateIpAddress string
    Assigns a single private IP address to the network interface, which is used as the primary private IP address. If you want to specify multiple private IP address, use the PrivateIpAddresses property.
    privateIpAddresses NetworkInterfacePrivateIpAddressSpecification[]
    Assigns a list of private IP addresses to the network interface. You can specify a primary private IP address by setting the value of the Primary property to true in the PrivateIpAddressSpecification property. If you want EC2 to automatically assign private IP addresses, use the SecondaryPrivateIpAddressCount property and do not specify this property.
    secondaryPrivateIpAddressCount number
    The number of secondary private IPv4 addresses to assign to a network interface. When you specify a number of secondary IPv4 addresses, Amazon EC2 selects these IP addresses within the subnet's IPv4 CIDR range. You can't specify this option and specify more than one private IP address using privateIpAddresses
    sourceDestCheck boolean
    Indicates whether traffic to or from the instance is validated.
    tags Tag[]
    An arbitrary set of tags (key-value pairs) for this network interface.
    subnet_id str
    The ID of the subnet to associate with the network interface.
    connection_tracking_specification NetworkInterfaceConnectionTrackingSpecificationArgs
    description str
    A description for the network interface.
    enable_primary_ipv6 bool
    If you have instances or ENIs that rely on the IPv6 address not changing, to avoid disrupting traffic to instances or ENIs, you can enable a primary IPv6 address. Enable this option to automatically assign an IPv6 associated with the ENI attached to your instance to be the primary IPv6 address. When you enable an IPv6 address to be a primary IPv6, you cannot disable it. Traffic will be routed to the primary IPv6 address until the instance is terminated or the ENI is detached. If you have multiple IPv6 addresses associated with an ENI and you enable a primary IPv6 address, the first IPv6 address associated with the ENI becomes the primary IPv6 address.
    group_set Sequence[str]
    A list of security group IDs associated with this network interface.
    interface_type str
    Indicates the type of network interface.
    ipv4_prefix_count int
    The number of IPv4 prefixes to assign to a network interface. When you specify a number of IPv4 prefixes, Amazon EC2 selects these prefixes from your existing subnet CIDR reservations, if available, or from free spaces in the subnet. By default, these will be /28 prefixes. You can't specify a count of IPv4 prefixes if you've specified one of the following: specific IPv4 prefixes, specific private IPv4 addresses, or a count of private IPv4 addresses.
    ipv4_prefixes Sequence[NetworkInterfaceIpv4PrefixSpecificationArgs]
    Assigns a list of IPv4 prefixes to the network interface. If you want EC2 to automatically assign IPv4 prefixes, use the Ipv4PrefixCount property and do not specify this property. Presently, only /28 prefixes are supported. You can't specify IPv4 prefixes if you've specified one of the following: a count of IPv4 prefixes, specific private IPv4 addresses, or a count of private IPv4 addresses.
    ipv6_address_count int
    The number of IPv6 addresses to assign to a network interface. Amazon EC2 automatically selects the IPv6 addresses from the subnet range. To specify specific IPv6 addresses, use the Ipv6Addresses property and don't specify this property.
    ipv6_addresses Sequence[NetworkInterfaceInstanceIpv6AddressArgs]
    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet to associate with the network interface. If you're specifying a number of IPv6 addresses, use the Ipv6AddressCount property and don't specify this property.
    ipv6_prefix_count int
    The number of IPv6 prefixes to assign to a network interface. When you specify a number of IPv6 prefixes, Amazon EC2 selects these prefixes from your existing subnet CIDR reservations, if available, or from free spaces in the subnet. By default, these will be /80 prefixes. You can't specify a count of IPv6 prefixes if you've specified one of the following: specific IPv6 prefixes, specific IPv6 addresses, or a count of IPv6 addresses.
    ipv6_prefixes Sequence[NetworkInterfaceIpv6PrefixSpecificationArgs]
    Assigns a list of IPv6 prefixes to the network interface. If you want EC2 to automatically assign IPv6 prefixes, use the Ipv6PrefixCount property and do not specify this property. Presently, only /80 prefixes are supported. You can't specify IPv6 prefixes if you've specified one of the following: a count of IPv6 prefixes, specific IPv6 addresses, or a count of IPv6 addresses.
    private_ip_address str
    Assigns a single private IP address to the network interface, which is used as the primary private IP address. If you want to specify multiple private IP address, use the PrivateIpAddresses property.
    private_ip_addresses Sequence[NetworkInterfacePrivateIpAddressSpecificationArgs]
    Assigns a list of private IP addresses to the network interface. You can specify a primary private IP address by setting the value of the Primary property to true in the PrivateIpAddressSpecification property. If you want EC2 to automatically assign private IP addresses, use the SecondaryPrivateIpAddressCount property and do not specify this property.
    secondary_private_ip_address_count int
    The number of secondary private IPv4 addresses to assign to a network interface. When you specify a number of secondary IPv4 addresses, Amazon EC2 selects these IP addresses within the subnet's IPv4 CIDR range. You can't specify this option and specify more than one private IP address using privateIpAddresses
    source_dest_check bool
    Indicates whether traffic to or from the instance is validated.
    tags Sequence[TagArgs]
    An arbitrary set of tags (key-value pairs) for this network interface.
    subnetId String
    The ID of the subnet to associate with the network interface.
    connectionTrackingSpecification Property Map
    description String
    A description for the network interface.
    enablePrimaryIpv6 Boolean
    If you have instances or ENIs that rely on the IPv6 address not changing, to avoid disrupting traffic to instances or ENIs, you can enable a primary IPv6 address. Enable this option to automatically assign an IPv6 associated with the ENI attached to your instance to be the primary IPv6 address. When you enable an IPv6 address to be a primary IPv6, you cannot disable it. Traffic will be routed to the primary IPv6 address until the instance is terminated or the ENI is detached. If you have multiple IPv6 addresses associated with an ENI and you enable a primary IPv6 address, the first IPv6 address associated with the ENI becomes the primary IPv6 address.
    groupSet List<String>
    A list of security group IDs associated with this network interface.
    interfaceType String
    Indicates the type of network interface.
    ipv4PrefixCount Number
    The number of IPv4 prefixes to assign to a network interface. When you specify a number of IPv4 prefixes, Amazon EC2 selects these prefixes from your existing subnet CIDR reservations, if available, or from free spaces in the subnet. By default, these will be /28 prefixes. You can't specify a count of IPv4 prefixes if you've specified one of the following: specific IPv4 prefixes, specific private IPv4 addresses, or a count of private IPv4 addresses.
    ipv4Prefixes List<Property Map>
    Assigns a list of IPv4 prefixes to the network interface. If you want EC2 to automatically assign IPv4 prefixes, use the Ipv4PrefixCount property and do not specify this property. Presently, only /28 prefixes are supported. You can't specify IPv4 prefixes if you've specified one of the following: a count of IPv4 prefixes, specific private IPv4 addresses, or a count of private IPv4 addresses.
    ipv6AddressCount Number
    The number of IPv6 addresses to assign to a network interface. Amazon EC2 automatically selects the IPv6 addresses from the subnet range. To specify specific IPv6 addresses, use the Ipv6Addresses property and don't specify this property.
    ipv6Addresses List<Property Map>
    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet to associate with the network interface. If you're specifying a number of IPv6 addresses, use the Ipv6AddressCount property and don't specify this property.
    ipv6PrefixCount Number
    The number of IPv6 prefixes to assign to a network interface. When you specify a number of IPv6 prefixes, Amazon EC2 selects these prefixes from your existing subnet CIDR reservations, if available, or from free spaces in the subnet. By default, these will be /80 prefixes. You can't specify a count of IPv6 prefixes if you've specified one of the following: specific IPv6 prefixes, specific IPv6 addresses, or a count of IPv6 addresses.
    ipv6Prefixes List<Property Map>
    Assigns a list of IPv6 prefixes to the network interface. If you want EC2 to automatically assign IPv6 prefixes, use the Ipv6PrefixCount property and do not specify this property. Presently, only /80 prefixes are supported. You can't specify IPv6 prefixes if you've specified one of the following: a count of IPv6 prefixes, specific IPv6 addresses, or a count of IPv6 addresses.
    privateIpAddress String
    Assigns a single private IP address to the network interface, which is used as the primary private IP address. If you want to specify multiple private IP address, use the PrivateIpAddresses property.
    privateIpAddresses List<Property Map>
    Assigns a list of private IP addresses to the network interface. You can specify a primary private IP address by setting the value of the Primary property to true in the PrivateIpAddressSpecification property. If you want EC2 to automatically assign private IP addresses, use the SecondaryPrivateIpAddressCount property and do not specify this property.
    secondaryPrivateIpAddressCount Number
    The number of secondary private IPv4 addresses to assign to a network interface. When you specify a number of secondary IPv4 addresses, Amazon EC2 selects these IP addresses within the subnet's IPv4 CIDR range. You can't specify this option and specify more than one private IP address using privateIpAddresses
    sourceDestCheck Boolean
    Indicates whether traffic to or from the instance is validated.
    tags List<Property Map>
    An arbitrary set of tags (key-value pairs) for this network interface.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the NetworkInterface resource produces the following output properties:

    AwsId string
    Network interface id.
    Id string
    The provider-assigned unique ID for this managed resource.
    PrimaryIpv6Address string
    The primary IPv6 address
    PrimaryPrivateIpAddress string
    Returns the primary private IP address of the network interface.
    SecondaryPrivateIpAddresses List<string>
    Returns the secondary private IP addresses of the network interface.
    VpcId string
    The ID of the VPC
    AwsId string
    Network interface id.
    Id string
    The provider-assigned unique ID for this managed resource.
    PrimaryIpv6Address string
    The primary IPv6 address
    PrimaryPrivateIpAddress string
    Returns the primary private IP address of the network interface.
    SecondaryPrivateIpAddresses []string
    Returns the secondary private IP addresses of the network interface.
    VpcId string
    The ID of the VPC
    awsId String
    Network interface id.
    id String
    The provider-assigned unique ID for this managed resource.
    primaryIpv6Address String
    The primary IPv6 address
    primaryPrivateIpAddress String
    Returns the primary private IP address of the network interface.
    secondaryPrivateIpAddresses List<String>
    Returns the secondary private IP addresses of the network interface.
    vpcId String
    The ID of the VPC
    awsId string
    Network interface id.
    id string
    The provider-assigned unique ID for this managed resource.
    primaryIpv6Address string
    The primary IPv6 address
    primaryPrivateIpAddress string
    Returns the primary private IP address of the network interface.
    secondaryPrivateIpAddresses string[]
    Returns the secondary private IP addresses of the network interface.
    vpcId string
    The ID of the VPC
    aws_id str
    Network interface id.
    id str
    The provider-assigned unique ID for this managed resource.
    primary_ipv6_address str
    The primary IPv6 address
    primary_private_ip_address str
    Returns the primary private IP address of the network interface.
    secondary_private_ip_addresses Sequence[str]
    Returns the secondary private IP addresses of the network interface.
    vpc_id str
    The ID of the VPC
    awsId String
    Network interface id.
    id String
    The provider-assigned unique ID for this managed resource.
    primaryIpv6Address String
    The primary IPv6 address
    primaryPrivateIpAddress String
    Returns the primary private IP address of the network interface.
    secondaryPrivateIpAddresses List<String>
    Returns the secondary private IP addresses of the network interface.
    vpcId String
    The ID of the VPC

    Supporting Types

    NetworkInterfaceConnectionTrackingSpecification, NetworkInterfaceConnectionTrackingSpecificationArgs

    NetworkInterfaceInstanceIpv6Address, NetworkInterfaceInstanceIpv6AddressArgs

    NetworkInterfaceIpv4PrefixSpecification, NetworkInterfaceIpv4PrefixSpecificationArgs

    Ipv4Prefix string
    Ipv4Prefix string
    ipv4Prefix String
    ipv4Prefix string
    ipv4Prefix String

    NetworkInterfaceIpv6PrefixSpecification, NetworkInterfaceIpv6PrefixSpecificationArgs

    Ipv6Prefix string
    Ipv6Prefix string
    ipv6Prefix String
    ipv6Prefix string
    ipv6Prefix String

    NetworkInterfacePrivateIpAddressSpecification, NetworkInterfacePrivateIpAddressSpecificationArgs

    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 logo

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

    AWS Native v0.102.0 published on Tuesday, Apr 16, 2024 by Pulumi