AWS Native is in preview. AWS Classic is fully supported.
aws-native.ec2.NetworkInterface
Explore with Pulumi AI
AWS Native is in preview. AWS Classic is fully supported.
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:
- Subnet
Id string - The ID of the subnet to associate with the network interface.
- Connection
Tracking Pulumi.Specification Aws Native. Ec2. Inputs. Network Interface Connection Tracking Specification - Description string
- A description for the network interface.
- Enable
Primary boolIpv6 - 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 List<string> - A list of security group IDs associated with this network interface.
- Interface
Type string - Indicates the type of network interface.
- Ipv4Prefix
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.
- Ipv4Prefixes
List<Pulumi.
Aws Native. Ec2. Inputs. Network Interface Ipv4Prefix Specification> - 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.
- Ipv6Address
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.
- Ipv6Addresses
List<Pulumi.
Aws Native. Ec2. Inputs. Network Interface Instance Ipv6Address> - 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.
- Ipv6Prefix
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.
- Ipv6Prefixes
List<Pulumi.
Aws Native. Ec2. Inputs. Network Interface Ipv6Prefix Specification> - 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 stringAddress - 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 List<Pulumi.Addresses Aws Native. Ec2. Inputs. Network Interface Private Ip Address Specification> - 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 intIp Address Count - 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 boolCheck - Indicates whether traffic to or from the instance is validated.
- List<Pulumi.
Aws Native. Inputs. Tag> - An arbitrary set of tags (key-value pairs) for this network interface.
- Subnet
Id string - The ID of the subnet to associate with the network interface.
- Connection
Tracking NetworkSpecification Interface Connection Tracking Specification Args - Description string
- A description for the network interface.
- Enable
Primary boolIpv6 - 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 []string - A list of security group IDs associated with this network interface.
- Interface
Type string - Indicates the type of network interface.
- Ipv4Prefix
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.
- Ipv4Prefixes
[]Network
Interface Ipv4Prefix Specification Args - 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.
- Ipv6Address
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.
- Ipv6Addresses
[]Network
Interface Instance Ipv6Address Args - 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.
- Ipv6Prefix
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.
- Ipv6Prefixes
[]Network
Interface Ipv6Prefix Specification Args - 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 stringAddress - 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 []NetworkAddresses Interface Private Ip Address Specification Args - 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 intIp Address Count - 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 boolCheck - Indicates whether traffic to or from the instance is validated.
- Tag
Args - An arbitrary set of tags (key-value pairs) for this network interface.
- subnet
Id String - The ID of the subnet to associate with the network interface.
- connection
Tracking NetworkSpecification Interface Connection Tracking Specification - description String
- A description for the network interface.
- enable
Primary BooleanIpv6 - 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 List<String> - A list of security group IDs associated with this network interface.
- interface
Type String - Indicates the type of network interface.
- ipv4Prefix
Count 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<Network
Interface Ipv4Prefix Specification> - 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.
- ipv6Address
Count 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<Network
Interface Instance Ipv6Address> - 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.
- ipv6Prefix
Count 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<Network
Interface Ipv6Prefix Specification> - 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 StringAddress - 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 List<NetworkAddresses Interface Private Ip Address Specification> - 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 IntegerIp Address Count - 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 BooleanCheck - Indicates whether traffic to or from the instance is validated.
- List<Tag>
- An arbitrary set of tags (key-value pairs) for this network interface.
- subnet
Id string - The ID of the subnet to associate with the network interface.
- connection
Tracking NetworkSpecification Interface Connection Tracking Specification - description string
- A description for the network interface.
- enable
Primary booleanIpv6 - 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 string[] - A list of security group IDs associated with this network interface.
- interface
Type string - Indicates the type of network interface.
- ipv4Prefix
Count 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
Network
Interface Ipv4Prefix Specification[] - 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.
- ipv6Address
Count 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
Network
Interface Instance Ipv6Address[] - 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.
- ipv6Prefix
Count 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
Network
Interface Ipv6Prefix Specification[] - 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 stringAddress - 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 NetworkAddresses Interface Private Ip Address Specification[] - 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 numberIp Address Count - 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 booleanCheck - Indicates whether traffic to or from the instance is validated.
- 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_ Networkspecification Interface Connection Tracking Specification Args - description str
- A description for the network interface.
- enable_
primary_ boolipv6 - 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_ intcount - 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[NetworkInterface Ipv4Prefix Specification Args] - 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_ intcount - 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[NetworkInterface Instance Ipv6Address Args] - 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_ intcount - 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[NetworkInterface Ipv6Prefix Specification Args] - 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_ straddress - 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_ Sequence[Networkaddresses Interface Private Ip Address Specification Args] - 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_ intip_ address_ count - 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_ boolcheck - Indicates whether traffic to or from the instance is validated.
- Sequence[Tag
Args] - An arbitrary set of tags (key-value pairs) for this network interface.
- subnet
Id String - The ID of the subnet to associate with the network interface.
- connection
Tracking Property MapSpecification - description String
- A description for the network interface.
- enable
Primary BooleanIpv6 - 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 List<String> - A list of security group IDs associated with this network interface.
- interface
Type String - Indicates the type of network interface.
- ipv4Prefix
Count 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.
- ipv6Address
Count 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.
- ipv6Prefix
Count 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.
- private
Ip StringAddress - 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 List<Property Map>Addresses - 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 NumberIp Address Count - 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 BooleanCheck - Indicates whether traffic to or from the instance is validated.
- 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:
- Aws
Id string - Network interface id.
- Id string
- The provider-assigned unique ID for this managed resource.
- Primary
Ipv6Address string - The primary IPv6 address
- Primary
Private stringIp Address - Returns the primary private IP address of the network interface.
- Secondary
Private List<string>Ip Addresses - Returns the secondary private IP addresses of the network interface.
- Vpc
Id string - The ID of the VPC
- Aws
Id string - Network interface id.
- Id string
- The provider-assigned unique ID for this managed resource.
- Primary
Ipv6Address string - The primary IPv6 address
- Primary
Private stringIp Address - Returns the primary private IP address of the network interface.
- Secondary
Private []stringIp Addresses - Returns the secondary private IP addresses of the network interface.
- Vpc
Id string - The ID of the VPC
- aws
Id String - Network interface id.
- id String
- The provider-assigned unique ID for this managed resource.
- primary
Ipv6Address String - The primary IPv6 address
- primary
Private StringIp Address - Returns the primary private IP address of the network interface.
- secondary
Private List<String>Ip Addresses - Returns the secondary private IP addresses of the network interface.
- vpc
Id String - The ID of the VPC
- aws
Id string - Network interface id.
- id string
- The provider-assigned unique ID for this managed resource.
- primary
Ipv6Address string - The primary IPv6 address
- primary
Private stringIp Address - Returns the primary private IP address of the network interface.
- secondary
Private string[]Ip Addresses - Returns the secondary private IP addresses of the network interface.
- vpc
Id 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_ straddress - The primary IPv6 address
- primary_
private_ strip_ address - Returns the primary private IP address of the network interface.
- secondary_
private_ Sequence[str]ip_ addresses - Returns the secondary private IP addresses of the network interface.
- vpc_
id str - The ID of the VPC
- aws
Id String - Network interface id.
- id String
- The provider-assigned unique ID for this managed resource.
- primary
Ipv6Address String - The primary IPv6 address
- primary
Private StringIp Address - Returns the primary private IP address of the network interface.
- secondary
Private List<String>Ip Addresses - Returns the secondary private IP addresses of the network interface.
- vpc
Id String - The ID of the VPC
Supporting Types
NetworkInterfaceConnectionTrackingSpecification, NetworkInterfaceConnectionTrackingSpecificationArgs
- Tcp
Established intTimeout - Udp
Stream intTimeout - Udp
Timeout int
- Tcp
Established intTimeout - Udp
Stream intTimeout - Udp
Timeout int
- tcp
Established IntegerTimeout - udp
Stream IntegerTimeout - udp
Timeout Integer
- tcp
Established numberTimeout - udp
Stream numberTimeout - udp
Timeout number
- tcp
Established NumberTimeout - udp
Stream NumberTimeout - udp
Timeout Number
NetworkInterfaceInstanceIpv6Address, NetworkInterfaceInstanceIpv6AddressArgs
- Ipv6Address string
- Ipv6Address string
- ipv6Address String
- ipv6Address string
- ipv6_
address str
- ipv6Address String
NetworkInterfaceIpv4PrefixSpecification, NetworkInterfaceIpv4PrefixSpecificationArgs
- Ipv4Prefix string
- Ipv4Prefix string
- ipv4Prefix String
- ipv4Prefix string
- ipv4_
prefix str
- ipv4Prefix String
NetworkInterfaceIpv6PrefixSpecification, NetworkInterfaceIpv6PrefixSpecificationArgs
- Ipv6Prefix string
- Ipv6Prefix string
- ipv6Prefix String
- ipv6Prefix string
- ipv6_
prefix str
- ipv6Prefix String
NetworkInterfacePrivateIpAddressSpecification, NetworkInterfacePrivateIpAddressSpecificationArgs
- Primary bool
- Private
Ip stringAddress
- Primary bool
- Private
Ip stringAddress
- primary Boolean
- private
Ip StringAddress
- primary boolean
- private
Ip stringAddress
- primary bool
- private_
ip_ straddress
- primary Boolean
- private
Ip StringAddress
Tag, TagArgs
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
AWS Native is in preview. AWS Classic is fully supported.