We recommend new projects start with resources from the AWS provider.
We recommend new projects start with resources from the AWS provider.
Attaches an elastic network interface (ENI) to an Amazon EC2 instance. You can use this resource type to attach additional network interfaces to an instance without interruption.
Create NetworkInterfaceAttachment Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new NetworkInterfaceAttachment(name: string, args: NetworkInterfaceAttachmentArgs, opts?: CustomResourceOptions);@overload
def NetworkInterfaceAttachment(resource_name: str,
args: NetworkInterfaceAttachmentArgs,
opts: Optional[ResourceOptions] = None)
@overload
def NetworkInterfaceAttachment(resource_name: str,
opts: Optional[ResourceOptions] = None,
device_index: Optional[str] = None,
instance_id: Optional[str] = None,
network_interface_id: Optional[str] = None,
delete_on_termination: Optional[bool] = None,
ena_queue_count: Optional[int] = None,
ena_srd_specification: Optional[NetworkInterfaceAttachmentEnaSrdSpecificationArgs] = None)func NewNetworkInterfaceAttachment(ctx *Context, name string, args NetworkInterfaceAttachmentArgs, opts ...ResourceOption) (*NetworkInterfaceAttachment, error)public NetworkInterfaceAttachment(string name, NetworkInterfaceAttachmentArgs args, CustomResourceOptions? opts = null)
public NetworkInterfaceAttachment(String name, NetworkInterfaceAttachmentArgs args)
public NetworkInterfaceAttachment(String name, NetworkInterfaceAttachmentArgs args, CustomResourceOptions options)
type: aws-native:ec2:NetworkInterfaceAttachment
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 NetworkInterfaceAttachmentArgs
- 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 NetworkInterfaceAttachmentArgs
- 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 NetworkInterfaceAttachmentArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args NetworkInterfaceAttachmentArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args NetworkInterfaceAttachmentArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
NetworkInterfaceAttachment Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The NetworkInterfaceAttachment resource accepts the following input properties:
- Device
Index string - The network interface's position in the attachment order. For example, the first attached network interface has a
DeviceIndexof 0. - Instance
Id string - The ID of the instance to which you will attach the ENI.
- Network
Interface stringId - The ID of the ENI that you want to attach.
- Delete
On boolTermination - Whether to delete the network interface when the instance terminates. By default, this value is set to
true. - Ena
Queue intCount - The number of ENA queues created with the instance.
- Ena
Srd Pulumi.Specification Aws Native. Ec2. Inputs. Network Interface Attachment Ena Srd Specification - Configures ENA Express for the network interface that this action attaches to the instance.
- Device
Index string - The network interface's position in the attachment order. For example, the first attached network interface has a
DeviceIndexof 0. - Instance
Id string - The ID of the instance to which you will attach the ENI.
- Network
Interface stringId - The ID of the ENI that you want to attach.
- Delete
On boolTermination - Whether to delete the network interface when the instance terminates. By default, this value is set to
true. - Ena
Queue intCount - The number of ENA queues created with the instance.
- Ena
Srd NetworkSpecification Interface Attachment Ena Srd Specification Args - Configures ENA Express for the network interface that this action attaches to the instance.
- device
Index String - The network interface's position in the attachment order. For example, the first attached network interface has a
DeviceIndexof 0. - instance
Id String - The ID of the instance to which you will attach the ENI.
- network
Interface StringId - The ID of the ENI that you want to attach.
- delete
On BooleanTermination - Whether to delete the network interface when the instance terminates. By default, this value is set to
true. - ena
Queue IntegerCount - The number of ENA queues created with the instance.
- ena
Srd NetworkSpecification Interface Attachment Ena Srd Specification - Configures ENA Express for the network interface that this action attaches to the instance.
- device
Index string - The network interface's position in the attachment order. For example, the first attached network interface has a
DeviceIndexof 0. - instance
Id string - The ID of the instance to which you will attach the ENI.
- network
Interface stringId - The ID of the ENI that you want to attach.
- delete
On booleanTermination - Whether to delete the network interface when the instance terminates. By default, this value is set to
true. - ena
Queue numberCount - The number of ENA queues created with the instance.
- ena
Srd NetworkSpecification Interface Attachment Ena Srd Specification - Configures ENA Express for the network interface that this action attaches to the instance.
- device_
index str - The network interface's position in the attachment order. For example, the first attached network interface has a
DeviceIndexof 0. - instance_
id str - The ID of the instance to which you will attach the ENI.
- network_
interface_ strid - The ID of the ENI that you want to attach.
- delete_
on_ booltermination - Whether to delete the network interface when the instance terminates. By default, this value is set to
true. - ena_
queue_ intcount - The number of ENA queues created with the instance.
- ena_
srd_ Networkspecification Interface Attachment Ena Srd Specification Args - Configures ENA Express for the network interface that this action attaches to the instance.
- device
Index String - The network interface's position in the attachment order. For example, the first attached network interface has a
DeviceIndexof 0. - instance
Id String - The ID of the instance to which you will attach the ENI.
- network
Interface StringId - The ID of the ENI that you want to attach.
- delete
On BooleanTermination - Whether to delete the network interface when the instance terminates. By default, this value is set to
true. - ena
Queue NumberCount - The number of ENA queues created with the instance.
- ena
Srd Property MapSpecification - Configures ENA Express for the network interface that this action attaches to the instance.
Outputs
All input properties are implicitly available as output properties. Additionally, the NetworkInterfaceAttachment resource produces the following output properties:
- Attachment
Id string - The ID of the network interface attachment.
- Id string
- The provider-assigned unique ID for this managed resource.
- Attachment
Id string - The ID of the network interface attachment.
- Id string
- The provider-assigned unique ID for this managed resource.
- attachment
Id String - The ID of the network interface attachment.
- id String
- The provider-assigned unique ID for this managed resource.
- attachment
Id string - The ID of the network interface attachment.
- id string
- The provider-assigned unique ID for this managed resource.
- attachment_
id str - The ID of the network interface attachment.
- id str
- The provider-assigned unique ID for this managed resource.
- attachment
Id String - The ID of the network interface attachment.
- id String
- The provider-assigned unique ID for this managed resource.
Supporting Types
NetworkInterfaceAttachmentEnaSrdSpecification, NetworkInterfaceAttachmentEnaSrdSpecificationArgs
ENA Express uses AWS Scalable Reliable Datagram (SRD) technology to increase the maximum bandwidth used per stream and minimize tail latency of network traffic between EC2 instances. With ENA Express, you can communicate between two EC2 instances in the same subnet within the same account, or in different accounts. Both sending and receiving instances must have ENA Express enabled.
To improve the reliability of network packet delivery, ENA Express reorders network packets on the receiving end by default. However, some UDP-based applications are designed to handle network packets that are out of order to reduce the overhead for packet delivery at the network layer. When ENA Express is enabled, you can specify whether UDP network traffic uses it.- Ena
Srd boolEnabled - Indicates whether ENA Express is enabled for the network interface.
- Ena
Srd Pulumi.Udp Specification Aws Native. Ec2. Inputs. Network Interface Attachment Ena Srd Specification Ena Srd Udp Specification Properties - Configures ENA Express for UDP network traffic.
- Ena
Srd boolEnabled - Indicates whether ENA Express is enabled for the network interface.
- Ena
Srd NetworkUdp Specification Interface Attachment Ena Srd Specification Ena Srd Udp Specification Properties - Configures ENA Express for UDP network traffic.
- ena
Srd BooleanEnabled - Indicates whether ENA Express is enabled for the network interface.
- ena
Srd NetworkUdp Specification Interface Attachment Ena Srd Specification Ena Srd Udp Specification Properties - Configures ENA Express for UDP network traffic.
- ena
Srd booleanEnabled - Indicates whether ENA Express is enabled for the network interface.
- ena
Srd NetworkUdp Specification Interface Attachment Ena Srd Specification Ena Srd Udp Specification Properties - Configures ENA Express for UDP network traffic.
- ena_
srd_ boolenabled - Indicates whether ENA Express is enabled for the network interface.
- ena_
srd_ Networkudp_ specification Interface Attachment Ena Srd Specification Ena Srd Udp Specification Properties - Configures ENA Express for UDP network traffic.
- ena
Srd BooleanEnabled - Indicates whether ENA Express is enabled for the network interface.
- ena
Srd Property MapUdp Specification - Configures ENA Express for UDP network traffic.
NetworkInterfaceAttachmentEnaSrdSpecificationEnaSrdUdpSpecificationProperties, NetworkInterfaceAttachmentEnaSrdSpecificationEnaSrdUdpSpecificationPropertiesArgs
Configures ENA Express for UDP network traffic.- Ena
Srd boolUdp Enabled
- Ena
Srd boolUdp Enabled
- ena
Srd BooleanUdp Enabled
- ena
Srd booleanUdp Enabled
- ena_
srd_ booludp_ enabled
- ena
Srd BooleanUdp Enabled
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.
