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

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.2.1 published on Friday, Sep 22, 2023 by Pulumi

aws.ec2.NetworkInterface

Explore with Pulumi AI

aws logo

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.2.1 published on Friday, Sep 22, 2023 by Pulumi

    Provides an Elastic network interface (ENI) resource.

    Example Usage

    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var test = new Aws.Ec2.NetworkInterface("test", new()
        {
            SubnetId = aws_subnet.Public_a.Id,
            PrivateIps = new[]
            {
                "10.0.0.50",
            },
            SecurityGroups = new[]
            {
                aws_security_group.Web.Id,
            },
            Attachments = new[]
            {
                new Aws.Ec2.Inputs.NetworkInterfaceAttachmentArgs
                {
                    Instance = aws_instance.Test.Id,
                    DeviceIndex = 1,
                },
            },
        });
    
    });
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ec2.NewNetworkInterface(ctx, "test", &ec2.NetworkInterfaceArgs{
    			SubnetId: pulumi.Any(aws_subnet.Public_a.Id),
    			PrivateIps: pulumi.StringArray{
    				pulumi.String("10.0.0.50"),
    			},
    			SecurityGroups: pulumi.StringArray{
    				aws_security_group.Web.Id,
    			},
    			Attachments: ec2.NetworkInterfaceAttachmentTypeArray{
    				&ec2.NetworkInterfaceAttachmentTypeArgs{
    					Instance:    pulumi.Any(aws_instance.Test.Id),
    					DeviceIndex: pulumi.Int(1),
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.ec2.NetworkInterface;
    import com.pulumi.aws.ec2.NetworkInterfaceArgs;
    import com.pulumi.aws.ec2.inputs.NetworkInterfaceAttachmentArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var test = new NetworkInterface("test", NetworkInterfaceArgs.builder()        
                .subnetId(aws_subnet.public_a().id())
                .privateIps("10.0.0.50")
                .securityGroups(aws_security_group.web().id())
                .attachments(NetworkInterfaceAttachmentArgs.builder()
                    .instance(aws_instance.test().id())
                    .deviceIndex(1)
                    .build())
                .build());
    
        }
    }
    
    import pulumi
    import pulumi_aws as aws
    
    test = aws.ec2.NetworkInterface("test",
        subnet_id=aws_subnet["public_a"]["id"],
        private_ips=["10.0.0.50"],
        security_groups=[aws_security_group["web"]["id"]],
        attachments=[aws.ec2.NetworkInterfaceAttachmentArgs(
            instance=aws_instance["test"]["id"],
            device_index=1,
        )])
    
    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const test = new aws.ec2.NetworkInterface("test", {
        subnetId: aws_subnet.public_a.id,
        privateIps: ["10.0.0.50"],
        securityGroups: [aws_security_group.web.id],
        attachments: [{
            instance: aws_instance.test.id,
            deviceIndex: 1,
        }],
    });
    
    resources:
      test:
        type: aws:ec2:NetworkInterface
        properties:
          subnetId: ${aws_subnet.public_a.id}
          privateIps:
            - 10.0.0.50
          securityGroups:
            - ${aws_security_group.web.id}
          attachments:
            - instance: ${aws_instance.test.id}
              deviceIndex: 1
    

    Create NetworkInterface Resource

    new NetworkInterface(name: string, args: NetworkInterfaceArgs, opts?: CustomResourceOptions);
    @overload
    def NetworkInterface(resource_name: str,
                         opts: Optional[ResourceOptions] = None,
                         attachments: Optional[Sequence[NetworkInterfaceAttachmentArgs]] = None,
                         description: Optional[str] = None,
                         interface_type: Optional[str] = None,
                         ipv4_prefix_count: Optional[int] = None,
                         ipv4_prefixes: Optional[Sequence[str]] = None,
                         ipv6_address_count: Optional[int] = None,
                         ipv6_address_list_enabled: Optional[bool] = None,
                         ipv6_address_lists: Optional[Sequence[str]] = None,
                         ipv6_addresses: Optional[Sequence[str]] = None,
                         ipv6_prefix_count: Optional[int] = None,
                         ipv6_prefixes: Optional[Sequence[str]] = None,
                         private_ip: Optional[str] = None,
                         private_ip_list_enabled: Optional[bool] = None,
                         private_ip_lists: Optional[Sequence[str]] = None,
                         private_ips: Optional[Sequence[str]] = None,
                         private_ips_count: Optional[int] = None,
                         security_groups: Optional[Sequence[str]] = None,
                         source_dest_check: Optional[bool] = None,
                         subnet_id: Optional[str] = None,
                         tags: Optional[Mapping[str, str]] = None)
    @overload
    def NetworkInterface(resource_name: str,
                         args: NetworkInterfaceArgs,
                         opts: Optional[ResourceOptions] = 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:ec2:NetworkInterface
    properties: # The arguments to resource properties.
    options: # 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.
    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.

    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

    Subnet ID to create the ENI in.

    The following arguments are optional:

    Attachments List<NetworkInterfaceAttachment>

    Configuration block to define the attachment of the ENI. See Attachment below for more details!

    Description string

    Description for the network interface.

    InterfaceType string

    Type of network interface to create. Set to efa for Elastic Fabric Adapter. Changing interface_type will cause the resource to be destroyed and re-created.

    Ipv4PrefixCount int

    Number of IPv4 prefixes that AWS automatically assigns to the network interface.

    Ipv4Prefixes List<string>

    One or more IPv4 prefixes assigned to the network interface.

    Ipv6AddressCount int

    Number of IPv6 addresses to assign to a network interface. You can't use this option if specifying specific ipv6_addresses. If your subnet has the AssignIpv6AddressOnCreation attribute set to true, you can specify 0 to override this setting.

    Ipv6AddressListEnabled bool

    Whether ipv6_address_list is allowed and controls the IPs to assign to the ENI and ipv6_addresses and ipv6_address_count become read-only. Default false.

    Ipv6AddressLists List<string>

    List of private IPs to assign to the ENI in sequential order.

    Ipv6Addresses List<string>

    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet. Addresses are assigned without regard to order. You can't use this option if you're specifying ipv6_address_count.

    Ipv6PrefixCount int

    Number of IPv6 prefixes that AWS automatically assigns to the network interface.

    Ipv6Prefixes List<string>

    One or more IPv6 prefixes assigned to the network interface.

    PrivateIp string
    PrivateIpListEnabled bool

    Whether private_ip_list is allowed and controls the IPs to assign to the ENI and private_ips and private_ips_count become read-only. Default false.

    PrivateIpLists List<string>

    List of private IPs to assign to the ENI in sequential order. Requires setting private_ip_list_enabled to true.

    PrivateIps List<string>

    List of private IPs to assign to the ENI without regard to order.

    PrivateIpsCount int

    Number of secondary private IPs to assign to the ENI. The total number of private IPs will be 1 + private_ips_count, as a primary private IP will be assiged to an ENI by default.

    SecurityGroups List<string>

    List of security group IDs to assign to the ENI.

    SourceDestCheck bool

    Whether to enable source destination checking for the ENI. Default true.

    Tags Dictionary<string, string>

    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    SubnetId string

    Subnet ID to create the ENI in.

    The following arguments are optional:

    Attachments []NetworkInterfaceAttachmentTypeArgs

    Configuration block to define the attachment of the ENI. See Attachment below for more details!

    Description string

    Description for the network interface.

    InterfaceType string

    Type of network interface to create. Set to efa for Elastic Fabric Adapter. Changing interface_type will cause the resource to be destroyed and re-created.

    Ipv4PrefixCount int

    Number of IPv4 prefixes that AWS automatically assigns to the network interface.

    Ipv4Prefixes []string

    One or more IPv4 prefixes assigned to the network interface.

    Ipv6AddressCount int

    Number of IPv6 addresses to assign to a network interface. You can't use this option if specifying specific ipv6_addresses. If your subnet has the AssignIpv6AddressOnCreation attribute set to true, you can specify 0 to override this setting.

    Ipv6AddressListEnabled bool

    Whether ipv6_address_list is allowed and controls the IPs to assign to the ENI and ipv6_addresses and ipv6_address_count become read-only. Default false.

    Ipv6AddressLists []string

    List of private IPs to assign to the ENI in sequential order.

    Ipv6Addresses []string

    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet. Addresses are assigned without regard to order. You can't use this option if you're specifying ipv6_address_count.

    Ipv6PrefixCount int

    Number of IPv6 prefixes that AWS automatically assigns to the network interface.

    Ipv6Prefixes []string

    One or more IPv6 prefixes assigned to the network interface.

    PrivateIp string
    PrivateIpListEnabled bool

    Whether private_ip_list is allowed and controls the IPs to assign to the ENI and private_ips and private_ips_count become read-only. Default false.

    PrivateIpLists []string

    List of private IPs to assign to the ENI in sequential order. Requires setting private_ip_list_enabled to true.

    PrivateIps []string

    List of private IPs to assign to the ENI without regard to order.

    PrivateIpsCount int

    Number of secondary private IPs to assign to the ENI. The total number of private IPs will be 1 + private_ips_count, as a primary private IP will be assiged to an ENI by default.

    SecurityGroups []string

    List of security group IDs to assign to the ENI.

    SourceDestCheck bool

    Whether to enable source destination checking for the ENI. Default true.

    Tags map[string]string

    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    subnetId String

    Subnet ID to create the ENI in.

    The following arguments are optional:

    attachments List<NetworkInterfaceAttachment>

    Configuration block to define the attachment of the ENI. See Attachment below for more details!

    description String

    Description for the network interface.

    interfaceType String

    Type of network interface to create. Set to efa for Elastic Fabric Adapter. Changing interface_type will cause the resource to be destroyed and re-created.

    ipv4PrefixCount Integer

    Number of IPv4 prefixes that AWS automatically assigns to the network interface.

    ipv4Prefixes List<String>

    One or more IPv4 prefixes assigned to the network interface.

    ipv6AddressCount Integer

    Number of IPv6 addresses to assign to a network interface. You can't use this option if specifying specific ipv6_addresses. If your subnet has the AssignIpv6AddressOnCreation attribute set to true, you can specify 0 to override this setting.

    ipv6AddressListEnabled Boolean

    Whether ipv6_address_list is allowed and controls the IPs to assign to the ENI and ipv6_addresses and ipv6_address_count become read-only. Default false.

    ipv6AddressLists List<String>

    List of private IPs to assign to the ENI in sequential order.

    ipv6Addresses List<String>

    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet. Addresses are assigned without regard to order. You can't use this option if you're specifying ipv6_address_count.

    ipv6PrefixCount Integer

    Number of IPv6 prefixes that AWS automatically assigns to the network interface.

    ipv6Prefixes List<String>

    One or more IPv6 prefixes assigned to the network interface.

    privateIp String
    privateIpListEnabled Boolean

    Whether private_ip_list is allowed and controls the IPs to assign to the ENI and private_ips and private_ips_count become read-only. Default false.

    privateIpLists List<String>

    List of private IPs to assign to the ENI in sequential order. Requires setting private_ip_list_enabled to true.

    privateIps List<String>

    List of private IPs to assign to the ENI without regard to order.

    privateIpsCount Integer

    Number of secondary private IPs to assign to the ENI. The total number of private IPs will be 1 + private_ips_count, as a primary private IP will be assiged to an ENI by default.

    securityGroups List<String>

    List of security group IDs to assign to the ENI.

    sourceDestCheck Boolean

    Whether to enable source destination checking for the ENI. Default true.

    tags Map<String,String>

    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    subnetId string

    Subnet ID to create the ENI in.

    The following arguments are optional:

    attachments NetworkInterfaceAttachment[]

    Configuration block to define the attachment of the ENI. See Attachment below for more details!

    description string

    Description for the network interface.

    interfaceType string

    Type of network interface to create. Set to efa for Elastic Fabric Adapter. Changing interface_type will cause the resource to be destroyed and re-created.

    ipv4PrefixCount number

    Number of IPv4 prefixes that AWS automatically assigns to the network interface.

    ipv4Prefixes string[]

    One or more IPv4 prefixes assigned to the network interface.

    ipv6AddressCount number

    Number of IPv6 addresses to assign to a network interface. You can't use this option if specifying specific ipv6_addresses. If your subnet has the AssignIpv6AddressOnCreation attribute set to true, you can specify 0 to override this setting.

    ipv6AddressListEnabled boolean

    Whether ipv6_address_list is allowed and controls the IPs to assign to the ENI and ipv6_addresses and ipv6_address_count become read-only. Default false.

    ipv6AddressLists string[]

    List of private IPs to assign to the ENI in sequential order.

    ipv6Addresses string[]

    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet. Addresses are assigned without regard to order. You can't use this option if you're specifying ipv6_address_count.

    ipv6PrefixCount number

    Number of IPv6 prefixes that AWS automatically assigns to the network interface.

    ipv6Prefixes string[]

    One or more IPv6 prefixes assigned to the network interface.

    privateIp string
    privateIpListEnabled boolean

    Whether private_ip_list is allowed and controls the IPs to assign to the ENI and private_ips and private_ips_count become read-only. Default false.

    privateIpLists string[]

    List of private IPs to assign to the ENI in sequential order. Requires setting private_ip_list_enabled to true.

    privateIps string[]

    List of private IPs to assign to the ENI without regard to order.

    privateIpsCount number

    Number of secondary private IPs to assign to the ENI. The total number of private IPs will be 1 + private_ips_count, as a primary private IP will be assiged to an ENI by default.

    securityGroups string[]

    List of security group IDs to assign to the ENI.

    sourceDestCheck boolean

    Whether to enable source destination checking for the ENI. Default true.

    tags {[key: string]: string}

    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    subnet_id str

    Subnet ID to create the ENI in.

    The following arguments are optional:

    attachments Sequence[NetworkInterfaceAttachmentArgs]

    Configuration block to define the attachment of the ENI. See Attachment below for more details!

    description str

    Description for the network interface.

    interface_type str

    Type of network interface to create. Set to efa for Elastic Fabric Adapter. Changing interface_type will cause the resource to be destroyed and re-created.

    ipv4_prefix_count int

    Number of IPv4 prefixes that AWS automatically assigns to the network interface.

    ipv4_prefixes Sequence[str]

    One or more IPv4 prefixes assigned to the network interface.

    ipv6_address_count int

    Number of IPv6 addresses to assign to a network interface. You can't use this option if specifying specific ipv6_addresses. If your subnet has the AssignIpv6AddressOnCreation attribute set to true, you can specify 0 to override this setting.

    ipv6_address_list_enabled bool

    Whether ipv6_address_list is allowed and controls the IPs to assign to the ENI and ipv6_addresses and ipv6_address_count become read-only. Default false.

    ipv6_address_lists Sequence[str]

    List of private IPs to assign to the ENI in sequential order.

    ipv6_addresses Sequence[str]

    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet. Addresses are assigned without regard to order. You can't use this option if you're specifying ipv6_address_count.

    ipv6_prefix_count int

    Number of IPv6 prefixes that AWS automatically assigns to the network interface.

    ipv6_prefixes Sequence[str]

    One or more IPv6 prefixes assigned to the network interface.

    private_ip str
    private_ip_list_enabled bool

    Whether private_ip_list is allowed and controls the IPs to assign to the ENI and private_ips and private_ips_count become read-only. Default false.

    private_ip_lists Sequence[str]

    List of private IPs to assign to the ENI in sequential order. Requires setting private_ip_list_enabled to true.

    private_ips Sequence[str]

    List of private IPs to assign to the ENI without regard to order.

    private_ips_count int

    Number of secondary private IPs to assign to the ENI. The total number of private IPs will be 1 + private_ips_count, as a primary private IP will be assiged to an ENI by default.

    security_groups Sequence[str]

    List of security group IDs to assign to the ENI.

    source_dest_check bool

    Whether to enable source destination checking for the ENI. Default true.

    tags Mapping[str, str]

    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    subnetId String

    Subnet ID to create the ENI in.

    The following arguments are optional:

    attachments List<Property Map>

    Configuration block to define the attachment of the ENI. See Attachment below for more details!

    description String

    Description for the network interface.

    interfaceType String

    Type of network interface to create. Set to efa for Elastic Fabric Adapter. Changing interface_type will cause the resource to be destroyed and re-created.

    ipv4PrefixCount Number

    Number of IPv4 prefixes that AWS automatically assigns to the network interface.

    ipv4Prefixes List<String>

    One or more IPv4 prefixes assigned to the network interface.

    ipv6AddressCount Number

    Number of IPv6 addresses to assign to a network interface. You can't use this option if specifying specific ipv6_addresses. If your subnet has the AssignIpv6AddressOnCreation attribute set to true, you can specify 0 to override this setting.

    ipv6AddressListEnabled Boolean

    Whether ipv6_address_list is allowed and controls the IPs to assign to the ENI and ipv6_addresses and ipv6_address_count become read-only. Default false.

    ipv6AddressLists List<String>

    List of private IPs to assign to the ENI in sequential order.

    ipv6Addresses List<String>

    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet. Addresses are assigned without regard to order. You can't use this option if you're specifying ipv6_address_count.

    ipv6PrefixCount Number

    Number of IPv6 prefixes that AWS automatically assigns to the network interface.

    ipv6Prefixes List<String>

    One or more IPv6 prefixes assigned to the network interface.

    privateIp String
    privateIpListEnabled Boolean

    Whether private_ip_list is allowed and controls the IPs to assign to the ENI and private_ips and private_ips_count become read-only. Default false.

    privateIpLists List<String>

    List of private IPs to assign to the ENI in sequential order. Requires setting private_ip_list_enabled to true.

    privateIps List<String>

    List of private IPs to assign to the ENI without regard to order.

    privateIpsCount Number

    Number of secondary private IPs to assign to the ENI. The total number of private IPs will be 1 + private_ips_count, as a primary private IP will be assiged to an ENI by default.

    securityGroups List<String>

    List of security group IDs to assign to the ENI.

    sourceDestCheck Boolean

    Whether to enable source destination checking for the ENI. Default true.

    tags Map<String>

    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    Outputs

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

    Arn string

    ARN of the network interface.

    Id string

    The provider-assigned unique ID for this managed resource.

    MacAddress string

    MAC address of the network interface.

    OutpostArn string
    OwnerId string

    AWS account ID of the owner of the network interface.

    PrivateDnsName string

    Private DNS name of the network interface (IPv4).

    TagsAll Dictionary<string, string>

    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    Arn string

    ARN of the network interface.

    Id string

    The provider-assigned unique ID for this managed resource.

    MacAddress string

    MAC address of the network interface.

    OutpostArn string
    OwnerId string

    AWS account ID of the owner of the network interface.

    PrivateDnsName string

    Private DNS name of the network interface (IPv4).

    TagsAll map[string]string

    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    arn String

    ARN of the network interface.

    id String

    The provider-assigned unique ID for this managed resource.

    macAddress String

    MAC address of the network interface.

    outpostArn String
    ownerId String

    AWS account ID of the owner of the network interface.

    privateDnsName String

    Private DNS name of the network interface (IPv4).

    tagsAll Map<String,String>

    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    arn string

    ARN of the network interface.

    id string

    The provider-assigned unique ID for this managed resource.

    macAddress string

    MAC address of the network interface.

    outpostArn string
    ownerId string

    AWS account ID of the owner of the network interface.

    privateDnsName string

    Private DNS name of the network interface (IPv4).

    tagsAll {[key: string]: string}

    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    arn str

    ARN of the network interface.

    id str

    The provider-assigned unique ID for this managed resource.

    mac_address str

    MAC address of the network interface.

    outpost_arn str
    owner_id str

    AWS account ID of the owner of the network interface.

    private_dns_name str

    Private DNS name of the network interface (IPv4).

    tags_all Mapping[str, str]

    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    arn String

    ARN of the network interface.

    id String

    The provider-assigned unique ID for this managed resource.

    macAddress String

    MAC address of the network interface.

    outpostArn String
    ownerId String

    AWS account ID of the owner of the network interface.

    privateDnsName String

    Private DNS name of the network interface (IPv4).

    tagsAll Map<String>

    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    Look up Existing NetworkInterface Resource

    Get an existing NetworkInterface resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: NetworkInterfaceState, opts?: CustomResourceOptions): NetworkInterface
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            arn: Optional[str] = None,
            attachments: Optional[Sequence[NetworkInterfaceAttachmentArgs]] = None,
            description: Optional[str] = None,
            interface_type: Optional[str] = None,
            ipv4_prefix_count: Optional[int] = None,
            ipv4_prefixes: Optional[Sequence[str]] = None,
            ipv6_address_count: Optional[int] = None,
            ipv6_address_list_enabled: Optional[bool] = None,
            ipv6_address_lists: Optional[Sequence[str]] = None,
            ipv6_addresses: Optional[Sequence[str]] = None,
            ipv6_prefix_count: Optional[int] = None,
            ipv6_prefixes: Optional[Sequence[str]] = None,
            mac_address: Optional[str] = None,
            outpost_arn: Optional[str] = None,
            owner_id: Optional[str] = None,
            private_dns_name: Optional[str] = None,
            private_ip: Optional[str] = None,
            private_ip_list_enabled: Optional[bool] = None,
            private_ip_lists: Optional[Sequence[str]] = None,
            private_ips: Optional[Sequence[str]] = None,
            private_ips_count: Optional[int] = None,
            security_groups: Optional[Sequence[str]] = None,
            source_dest_check: Optional[bool] = None,
            subnet_id: Optional[str] = None,
            tags: Optional[Mapping[str, str]] = None,
            tags_all: Optional[Mapping[str, str]] = None) -> NetworkInterface
    func GetNetworkInterface(ctx *Context, name string, id IDInput, state *NetworkInterfaceState, opts ...ResourceOption) (*NetworkInterface, error)
    public static NetworkInterface Get(string name, Input<string> id, NetworkInterfaceState? state, CustomResourceOptions? opts = null)
    public static NetworkInterface get(String name, Output<String> id, NetworkInterfaceState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Arn string

    ARN of the network interface.

    Attachments List<NetworkInterfaceAttachment>

    Configuration block to define the attachment of the ENI. See Attachment below for more details!

    Description string

    Description for the network interface.

    InterfaceType string

    Type of network interface to create. Set to efa for Elastic Fabric Adapter. Changing interface_type will cause the resource to be destroyed and re-created.

    Ipv4PrefixCount int

    Number of IPv4 prefixes that AWS automatically assigns to the network interface.

    Ipv4Prefixes List<string>

    One or more IPv4 prefixes assigned to the network interface.

    Ipv6AddressCount int

    Number of IPv6 addresses to assign to a network interface. You can't use this option if specifying specific ipv6_addresses. If your subnet has the AssignIpv6AddressOnCreation attribute set to true, you can specify 0 to override this setting.

    Ipv6AddressListEnabled bool

    Whether ipv6_address_list is allowed and controls the IPs to assign to the ENI and ipv6_addresses and ipv6_address_count become read-only. Default false.

    Ipv6AddressLists List<string>

    List of private IPs to assign to the ENI in sequential order.

    Ipv6Addresses List<string>

    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet. Addresses are assigned without regard to order. You can't use this option if you're specifying ipv6_address_count.

    Ipv6PrefixCount int

    Number of IPv6 prefixes that AWS automatically assigns to the network interface.

    Ipv6Prefixes List<string>

    One or more IPv6 prefixes assigned to the network interface.

    MacAddress string

    MAC address of the network interface.

    OutpostArn string
    OwnerId string

    AWS account ID of the owner of the network interface.

    PrivateDnsName string

    Private DNS name of the network interface (IPv4).

    PrivateIp string
    PrivateIpListEnabled bool

    Whether private_ip_list is allowed and controls the IPs to assign to the ENI and private_ips and private_ips_count become read-only. Default false.

    PrivateIpLists List<string>

    List of private IPs to assign to the ENI in sequential order. Requires setting private_ip_list_enabled to true.

    PrivateIps List<string>

    List of private IPs to assign to the ENI without regard to order.

    PrivateIpsCount int

    Number of secondary private IPs to assign to the ENI. The total number of private IPs will be 1 + private_ips_count, as a primary private IP will be assiged to an ENI by default.

    SecurityGroups List<string>

    List of security group IDs to assign to the ENI.

    SourceDestCheck bool

    Whether to enable source destination checking for the ENI. Default true.

    SubnetId string

    Subnet ID to create the ENI in.

    The following arguments are optional:

    Tags Dictionary<string, string>

    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    TagsAll Dictionary<string, string>

    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    Arn string

    ARN of the network interface.

    Attachments []NetworkInterfaceAttachmentTypeArgs

    Configuration block to define the attachment of the ENI. See Attachment below for more details!

    Description string

    Description for the network interface.

    InterfaceType string

    Type of network interface to create. Set to efa for Elastic Fabric Adapter. Changing interface_type will cause the resource to be destroyed and re-created.

    Ipv4PrefixCount int

    Number of IPv4 prefixes that AWS automatically assigns to the network interface.

    Ipv4Prefixes []string

    One or more IPv4 prefixes assigned to the network interface.

    Ipv6AddressCount int

    Number of IPv6 addresses to assign to a network interface. You can't use this option if specifying specific ipv6_addresses. If your subnet has the AssignIpv6AddressOnCreation attribute set to true, you can specify 0 to override this setting.

    Ipv6AddressListEnabled bool

    Whether ipv6_address_list is allowed and controls the IPs to assign to the ENI and ipv6_addresses and ipv6_address_count become read-only. Default false.

    Ipv6AddressLists []string

    List of private IPs to assign to the ENI in sequential order.

    Ipv6Addresses []string

    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet. Addresses are assigned without regard to order. You can't use this option if you're specifying ipv6_address_count.

    Ipv6PrefixCount int

    Number of IPv6 prefixes that AWS automatically assigns to the network interface.

    Ipv6Prefixes []string

    One or more IPv6 prefixes assigned to the network interface.

    MacAddress string

    MAC address of the network interface.

    OutpostArn string
    OwnerId string

    AWS account ID of the owner of the network interface.

    PrivateDnsName string

    Private DNS name of the network interface (IPv4).

    PrivateIp string
    PrivateIpListEnabled bool

    Whether private_ip_list is allowed and controls the IPs to assign to the ENI and private_ips and private_ips_count become read-only. Default false.

    PrivateIpLists []string

    List of private IPs to assign to the ENI in sequential order. Requires setting private_ip_list_enabled to true.

    PrivateIps []string

    List of private IPs to assign to the ENI without regard to order.

    PrivateIpsCount int

    Number of secondary private IPs to assign to the ENI. The total number of private IPs will be 1 + private_ips_count, as a primary private IP will be assiged to an ENI by default.

    SecurityGroups []string

    List of security group IDs to assign to the ENI.

    SourceDestCheck bool

    Whether to enable source destination checking for the ENI. Default true.

    SubnetId string

    Subnet ID to create the ENI in.

    The following arguments are optional:

    Tags map[string]string

    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    TagsAll map[string]string

    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    arn String

    ARN of the network interface.

    attachments List<NetworkInterfaceAttachment>

    Configuration block to define the attachment of the ENI. See Attachment below for more details!

    description String

    Description for the network interface.

    interfaceType String

    Type of network interface to create. Set to efa for Elastic Fabric Adapter. Changing interface_type will cause the resource to be destroyed and re-created.

    ipv4PrefixCount Integer

    Number of IPv4 prefixes that AWS automatically assigns to the network interface.

    ipv4Prefixes List<String>

    One or more IPv4 prefixes assigned to the network interface.

    ipv6AddressCount Integer

    Number of IPv6 addresses to assign to a network interface. You can't use this option if specifying specific ipv6_addresses. If your subnet has the AssignIpv6AddressOnCreation attribute set to true, you can specify 0 to override this setting.

    ipv6AddressListEnabled Boolean

    Whether ipv6_address_list is allowed and controls the IPs to assign to the ENI and ipv6_addresses and ipv6_address_count become read-only. Default false.

    ipv6AddressLists List<String>

    List of private IPs to assign to the ENI in sequential order.

    ipv6Addresses List<String>

    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet. Addresses are assigned without regard to order. You can't use this option if you're specifying ipv6_address_count.

    ipv6PrefixCount Integer

    Number of IPv6 prefixes that AWS automatically assigns to the network interface.

    ipv6Prefixes List<String>

    One or more IPv6 prefixes assigned to the network interface.

    macAddress String

    MAC address of the network interface.

    outpostArn String
    ownerId String

    AWS account ID of the owner of the network interface.

    privateDnsName String

    Private DNS name of the network interface (IPv4).

    privateIp String
    privateIpListEnabled Boolean

    Whether private_ip_list is allowed and controls the IPs to assign to the ENI and private_ips and private_ips_count become read-only. Default false.

    privateIpLists List<String>

    List of private IPs to assign to the ENI in sequential order. Requires setting private_ip_list_enabled to true.

    privateIps List<String>

    List of private IPs to assign to the ENI without regard to order.

    privateIpsCount Integer

    Number of secondary private IPs to assign to the ENI. The total number of private IPs will be 1 + private_ips_count, as a primary private IP will be assiged to an ENI by default.

    securityGroups List<String>

    List of security group IDs to assign to the ENI.

    sourceDestCheck Boolean

    Whether to enable source destination checking for the ENI. Default true.

    subnetId String

    Subnet ID to create the ENI in.

    The following arguments are optional:

    tags Map<String,String>

    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    tagsAll Map<String,String>

    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    arn string

    ARN of the network interface.

    attachments NetworkInterfaceAttachment[]

    Configuration block to define the attachment of the ENI. See Attachment below for more details!

    description string

    Description for the network interface.

    interfaceType string

    Type of network interface to create. Set to efa for Elastic Fabric Adapter. Changing interface_type will cause the resource to be destroyed and re-created.

    ipv4PrefixCount number

    Number of IPv4 prefixes that AWS automatically assigns to the network interface.

    ipv4Prefixes string[]

    One or more IPv4 prefixes assigned to the network interface.

    ipv6AddressCount number

    Number of IPv6 addresses to assign to a network interface. You can't use this option if specifying specific ipv6_addresses. If your subnet has the AssignIpv6AddressOnCreation attribute set to true, you can specify 0 to override this setting.

    ipv6AddressListEnabled boolean

    Whether ipv6_address_list is allowed and controls the IPs to assign to the ENI and ipv6_addresses and ipv6_address_count become read-only. Default false.

    ipv6AddressLists string[]

    List of private IPs to assign to the ENI in sequential order.

    ipv6Addresses string[]

    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet. Addresses are assigned without regard to order. You can't use this option if you're specifying ipv6_address_count.

    ipv6PrefixCount number

    Number of IPv6 prefixes that AWS automatically assigns to the network interface.

    ipv6Prefixes string[]

    One or more IPv6 prefixes assigned to the network interface.

    macAddress string

    MAC address of the network interface.

    outpostArn string
    ownerId string

    AWS account ID of the owner of the network interface.

    privateDnsName string

    Private DNS name of the network interface (IPv4).

    privateIp string
    privateIpListEnabled boolean

    Whether private_ip_list is allowed and controls the IPs to assign to the ENI and private_ips and private_ips_count become read-only. Default false.

    privateIpLists string[]

    List of private IPs to assign to the ENI in sequential order. Requires setting private_ip_list_enabled to true.

    privateIps string[]

    List of private IPs to assign to the ENI without regard to order.

    privateIpsCount number

    Number of secondary private IPs to assign to the ENI. The total number of private IPs will be 1 + private_ips_count, as a primary private IP will be assiged to an ENI by default.

    securityGroups string[]

    List of security group IDs to assign to the ENI.

    sourceDestCheck boolean

    Whether to enable source destination checking for the ENI. Default true.

    subnetId string

    Subnet ID to create the ENI in.

    The following arguments are optional:

    tags {[key: string]: string}

    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    tagsAll {[key: string]: string}

    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    arn str

    ARN of the network interface.

    attachments Sequence[NetworkInterfaceAttachmentArgs]

    Configuration block to define the attachment of the ENI. See Attachment below for more details!

    description str

    Description for the network interface.

    interface_type str

    Type of network interface to create. Set to efa for Elastic Fabric Adapter. Changing interface_type will cause the resource to be destroyed and re-created.

    ipv4_prefix_count int

    Number of IPv4 prefixes that AWS automatically assigns to the network interface.

    ipv4_prefixes Sequence[str]

    One or more IPv4 prefixes assigned to the network interface.

    ipv6_address_count int

    Number of IPv6 addresses to assign to a network interface. You can't use this option if specifying specific ipv6_addresses. If your subnet has the AssignIpv6AddressOnCreation attribute set to true, you can specify 0 to override this setting.

    ipv6_address_list_enabled bool

    Whether ipv6_address_list is allowed and controls the IPs to assign to the ENI and ipv6_addresses and ipv6_address_count become read-only. Default false.

    ipv6_address_lists Sequence[str]

    List of private IPs to assign to the ENI in sequential order.

    ipv6_addresses Sequence[str]

    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet. Addresses are assigned without regard to order. You can't use this option if you're specifying ipv6_address_count.

    ipv6_prefix_count int

    Number of IPv6 prefixes that AWS automatically assigns to the network interface.

    ipv6_prefixes Sequence[str]

    One or more IPv6 prefixes assigned to the network interface.

    mac_address str

    MAC address of the network interface.

    outpost_arn str
    owner_id str

    AWS account ID of the owner of the network interface.

    private_dns_name str

    Private DNS name of the network interface (IPv4).

    private_ip str
    private_ip_list_enabled bool

    Whether private_ip_list is allowed and controls the IPs to assign to the ENI and private_ips and private_ips_count become read-only. Default false.

    private_ip_lists Sequence[str]

    List of private IPs to assign to the ENI in sequential order. Requires setting private_ip_list_enabled to true.

    private_ips Sequence[str]

    List of private IPs to assign to the ENI without regard to order.

    private_ips_count int

    Number of secondary private IPs to assign to the ENI. The total number of private IPs will be 1 + private_ips_count, as a primary private IP will be assiged to an ENI by default.

    security_groups Sequence[str]

    List of security group IDs to assign to the ENI.

    source_dest_check bool

    Whether to enable source destination checking for the ENI. Default true.

    subnet_id str

    Subnet ID to create the ENI in.

    The following arguments are optional:

    tags Mapping[str, str]

    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    tags_all Mapping[str, str]

    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    arn String

    ARN of the network interface.

    attachments List<Property Map>

    Configuration block to define the attachment of the ENI. See Attachment below for more details!

    description String

    Description for the network interface.

    interfaceType String

    Type of network interface to create. Set to efa for Elastic Fabric Adapter. Changing interface_type will cause the resource to be destroyed and re-created.

    ipv4PrefixCount Number

    Number of IPv4 prefixes that AWS automatically assigns to the network interface.

    ipv4Prefixes List<String>

    One or more IPv4 prefixes assigned to the network interface.

    ipv6AddressCount Number

    Number of IPv6 addresses to assign to a network interface. You can't use this option if specifying specific ipv6_addresses. If your subnet has the AssignIpv6AddressOnCreation attribute set to true, you can specify 0 to override this setting.

    ipv6AddressListEnabled Boolean

    Whether ipv6_address_list is allowed and controls the IPs to assign to the ENI and ipv6_addresses and ipv6_address_count become read-only. Default false.

    ipv6AddressLists List<String>

    List of private IPs to assign to the ENI in sequential order.

    ipv6Addresses List<String>

    One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet. Addresses are assigned without regard to order. You can't use this option if you're specifying ipv6_address_count.

    ipv6PrefixCount Number

    Number of IPv6 prefixes that AWS automatically assigns to the network interface.

    ipv6Prefixes List<String>

    One or more IPv6 prefixes assigned to the network interface.

    macAddress String

    MAC address of the network interface.

    outpostArn String
    ownerId String

    AWS account ID of the owner of the network interface.

    privateDnsName String

    Private DNS name of the network interface (IPv4).

    privateIp String
    privateIpListEnabled Boolean

    Whether private_ip_list is allowed and controls the IPs to assign to the ENI and private_ips and private_ips_count become read-only. Default false.

    privateIpLists List<String>

    List of private IPs to assign to the ENI in sequential order. Requires setting private_ip_list_enabled to true.

    privateIps List<String>

    List of private IPs to assign to the ENI without regard to order.

    privateIpsCount Number

    Number of secondary private IPs to assign to the ENI. The total number of private IPs will be 1 + private_ips_count, as a primary private IP will be assiged to an ENI by default.

    securityGroups List<String>

    List of security group IDs to assign to the ENI.

    sourceDestCheck Boolean

    Whether to enable source destination checking for the ENI. Default true.

    subnetId String

    Subnet ID to create the ENI in.

    The following arguments are optional:

    tags Map<String>

    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    tagsAll Map<String>

    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    Supporting Types

    NetworkInterfaceAttachment, NetworkInterfaceAttachmentArgs

    DeviceIndex int

    Integer to define the devices index.

    Instance string

    ID of the instance to attach to.

    AttachmentId string
    DeviceIndex int

    Integer to define the devices index.

    Instance string

    ID of the instance to attach to.

    AttachmentId string
    deviceIndex Integer

    Integer to define the devices index.

    instance String

    ID of the instance to attach to.

    attachmentId String
    deviceIndex number

    Integer to define the devices index.

    instance string

    ID of the instance to attach to.

    attachmentId string
    device_index int

    Integer to define the devices index.

    instance str

    ID of the instance to attach to.

    attachment_id str
    deviceIndex Number

    Integer to define the devices index.

    instance String

    ID of the instance to attach to.

    attachmentId String

    Import

    In TODO v1.5.0 and later, use an import block to import Network Interfaces using the id. For exampleterraform import {

    to = aws_network_interface.test

    id = “eni-e5aa89a3” } Using TODO import, import Network Interfaces using the id. For exampleconsole % TODO import aws_network_interface.test eni-e5aa89a3

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes

    This Pulumi package is based on the aws Terraform Provider.

    aws logo

    Try AWS Native preview for resources not in the classic version.

    AWS Classic v6.2.1 published on Friday, Sep 22, 2023 by Pulumi