volcenginecc.vpc.Eni

volcenginecc v0.0.32, Apr 23 26

Viewing docs for volcenginecc v0.0.32
published on Thursday, Apr 23, 2026 by Volcengine

Schema (JSON)

volcengine/pulumi-volcenginecc

Viewing docs for volcenginecc v0.0.32
published on Thursday, Apr 23, 2026 by Volcengine

Schema (JSON)

volcengine/pulumi-volcenginecc

A network interface is a virtual network interface. In a private network, it serves as a network interface attached to cloud servers, load balancers, and other cloud resources. Each network interface has a primary private IP address. You can manually assign multiple auxiliary private IP addresses if needed.

Example Usage

Example coming soon!

Example coming soon!

Example coming soon!

Example coming soon!

Example coming soon!

resources:
  eniDemo:
    type: volcenginecc:vpc:Eni
    name: EniDemo
    properties:
      networkInterfaceName: EniDemo
      subnetId: vpc_subnet-xxxx
      securityGroupIds:
        - vpc_security_group-xxxx
      instanceId: i-ye498lwge85i3z3kxxxx
      projectName: default
      primaryIpAddress:
        private_ip_address: 192.168.x.130
        associated_elastic_ip:
          allocationId: eip-2f80zqjduo6ps4f4pzzcxxxxx
      secondaryPrivateIpAddressCount: 2
      tags:
        - key: env
          value: test

Create Eni Resource

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

Constructor syntax

new Eni(name: string, args?: EniArgs, opts?: CustomResourceOptions);

@overload
def Eni(resource_name: str,
        args: Optional[EniArgs] = None,
        opts: Optional[ResourceOptions] = None)

@overload
def Eni(resource_name: str,
        opts: Optional[ResourceOptions] = None,
        delete_on_termination: Optional[bool] = None,
        description: Optional[str] = None,
        instance_id: Optional[str] = None,
        ipv6_address_count: Optional[int] = None,
        ipv6_sets: Optional[Sequence[str]] = None,
        network_interface_name: Optional[str] = None,
        port_security_enabled: Optional[bool] = None,
        primary_ip_address: Optional[EniPrimaryIpAddressArgs] = None,
        private_ip_sets: Optional[Sequence[EniPrivateIpSetArgs]] = None,
        project_name: Optional[str] = None,
        secondary_private_ip_address_count: Optional[int] = None,
        security_group_ids: Optional[Sequence[str]] = None,
        subnet_id: Optional[str] = None,
        tags: Optional[Sequence[EniTagArgs]] = None)

func NewEni(ctx *Context, name string, args *EniArgs, opts ...ResourceOption) (*Eni, error)

public Eni(string name, EniArgs? args = null, CustomResourceOptions? opts = null)

public Eni(String name, EniArgs args)
public Eni(String name, EniArgs args, CustomResourceOptions options)

type: volcenginecc:vpc:Eni
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 EniArgs: 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 EniArgs: 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 EniArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args EniArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args EniArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

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

DeleteOnTermination bool: Enable release with cloud server instance deletion. true to enable, false to disable
Description string: Description for the auxiliary network interface. Length limit: 0–255 characters. Must start with a letter, Chinese character, or number. Allowed characters include English comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (，), and Chinese period (。). If not specified, defaults to an empty string.
InstanceId string: ID of the instance bound to the NIC. If the NIC is not attached or the ServiceManaged parameter is true, InstanceId returns empty
Ipv6AddressCount int: Number of private IPv6 addresses assigned to the network interface. When this parameter is specified, the system automatically assigns the corresponding number of available private IPv6 addresses from the subnet to which the network interface belongs. Cannot be used together with IPv6Sets during creation.
Ipv6Sets List<string>: IPv6 address list of the network interface, for example [2408::153:3921:XX:XX:7b12:1c5f, 2408:4008:2cf:XX:XX:dd1e:2a22:5ddf].
NetworkInterfaceName string: NIC name. Length must be between 1 and 128 characters, starting with a letter, Chinese character, or number. Can include periods (.), underscores (_), and hyphens (-). If not specified, defaults to the ID of the secondary NIC
PortSecurityEnabled bool: Enable source/destination address check for the NIC. When enabled, the system automatically blocks traffic whose source or destination address does not match the current NIC. true to enable, false to disable (default)
PrimaryIpAddress Volcengine.EniPrimaryIpAddress: Primary private IPv4 address of the network interface. Address modification is not supported, but you can modify the public IP. If specified, it must be an available private IPv4 address in the corresponding subnet. If not specified, an available private IPv4 address will be automatically assigned from the corresponding subnet. For example: 192.XX.XX.10.
PrivateIpSets List<Volcengine.EniPrivateIpSet>
ProjectName string: Name of the project to which the NIC belongs
SecondaryPrivateIpAddressCount int: Number of auxiliary private IPv4 addresses automatically assigned to the auxiliary network interface. Value range: 1–49. Cannot be used together with PrivateIpSets during creation.
SecurityGroupIds List<string>: ID of one or more security groups joined by the auxiliary network interface.
SubnetId string: ID of the subnet where the auxiliary network interface resides.
Tags List<Volcengine.EniTag>

DeleteOnTermination bool: Enable release with cloud server instance deletion. true to enable, false to disable
Description string: Description for the auxiliary network interface. Length limit: 0–255 characters. Must start with a letter, Chinese character, or number. Allowed characters include English comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (，), and Chinese period (。). If not specified, defaults to an empty string.
InstanceId string: ID of the instance bound to the NIC. If the NIC is not attached or the ServiceManaged parameter is true, InstanceId returns empty
Ipv6AddressCount int: Number of private IPv6 addresses assigned to the network interface. When this parameter is specified, the system automatically assigns the corresponding number of available private IPv6 addresses from the subnet to which the network interface belongs. Cannot be used together with IPv6Sets during creation.
Ipv6Sets []string: IPv6 address list of the network interface, for example [2408::153:3921:XX:XX:7b12:1c5f, 2408:4008:2cf:XX:XX:dd1e:2a22:5ddf].
NetworkInterfaceName string: NIC name. Length must be between 1 and 128 characters, starting with a letter, Chinese character, or number. Can include periods (.), underscores (_), and hyphens (-). If not specified, defaults to the ID of the secondary NIC
PortSecurityEnabled bool: Enable source/destination address check for the NIC. When enabled, the system automatically blocks traffic whose source or destination address does not match the current NIC. true to enable, false to disable (default)
PrimaryIpAddress EniPrimaryIpAddressArgs: Primary private IPv4 address of the network interface. Address modification is not supported, but you can modify the public IP. If specified, it must be an available private IPv4 address in the corresponding subnet. If not specified, an available private IPv4 address will be automatically assigned from the corresponding subnet. For example: 192.XX.XX.10.
PrivateIpSets []EniPrivateIpSetArgs
ProjectName string: Name of the project to which the NIC belongs
SecondaryPrivateIpAddressCount int: Number of auxiliary private IPv4 addresses automatically assigned to the auxiliary network interface. Value range: 1–49. Cannot be used together with PrivateIpSets during creation.
SecurityGroupIds []string: ID of one or more security groups joined by the auxiliary network interface.
SubnetId string: ID of the subnet where the auxiliary network interface resides.
Tags []EniTagArgs

deleteOnTermination Boolean: Enable release with cloud server instance deletion. true to enable, false to disable
description String: Description for the auxiliary network interface. Length limit: 0–255 characters. Must start with a letter, Chinese character, or number. Allowed characters include English comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (，), and Chinese period (。). If not specified, defaults to an empty string.
instanceId String: ID of the instance bound to the NIC. If the NIC is not attached or the ServiceManaged parameter is true, InstanceId returns empty
ipv6AddressCount Integer: Number of private IPv6 addresses assigned to the network interface. When this parameter is specified, the system automatically assigns the corresponding number of available private IPv6 addresses from the subnet to which the network interface belongs. Cannot be used together with IPv6Sets during creation.
ipv6Sets List<String>: IPv6 address list of the network interface, for example [2408::153:3921:XX:XX:7b12:1c5f, 2408:4008:2cf:XX:XX:dd1e:2a22:5ddf].
networkInterfaceName String: NIC name. Length must be between 1 and 128 characters, starting with a letter, Chinese character, or number. Can include periods (.), underscores (_), and hyphens (-). If not specified, defaults to the ID of the secondary NIC
portSecurityEnabled Boolean: Enable source/destination address check for the NIC. When enabled, the system automatically blocks traffic whose source or destination address does not match the current NIC. true to enable, false to disable (default)
primaryIpAddress EniPrimaryIpAddress: Primary private IPv4 address of the network interface. Address modification is not supported, but you can modify the public IP. If specified, it must be an available private IPv4 address in the corresponding subnet. If not specified, an available private IPv4 address will be automatically assigned from the corresponding subnet. For example: 192.XX.XX.10.
privateIpSets List<EniPrivateIpSet>
projectName String: Name of the project to which the NIC belongs
secondaryPrivateIpAddressCount Integer: Number of auxiliary private IPv4 addresses automatically assigned to the auxiliary network interface. Value range: 1–49. Cannot be used together with PrivateIpSets during creation.
securityGroupIds List<String>: ID of one or more security groups joined by the auxiliary network interface.
subnetId String: ID of the subnet where the auxiliary network interface resides.
tags List<EniTag>

deleteOnTermination boolean: Enable release with cloud server instance deletion. true to enable, false to disable
description string: Description for the auxiliary network interface. Length limit: 0–255 characters. Must start with a letter, Chinese character, or number. Allowed characters include English comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (，), and Chinese period (。). If not specified, defaults to an empty string.
instanceId string: ID of the instance bound to the NIC. If the NIC is not attached or the ServiceManaged parameter is true, InstanceId returns empty
ipv6AddressCount number: Number of private IPv6 addresses assigned to the network interface. When this parameter is specified, the system automatically assigns the corresponding number of available private IPv6 addresses from the subnet to which the network interface belongs. Cannot be used together with IPv6Sets during creation.
ipv6Sets string[]: IPv6 address list of the network interface, for example [2408::153:3921:XX:XX:7b12:1c5f, 2408:4008:2cf:XX:XX:dd1e:2a22:5ddf].
networkInterfaceName string: NIC name. Length must be between 1 and 128 characters, starting with a letter, Chinese character, or number. Can include periods (.), underscores (_), and hyphens (-). If not specified, defaults to the ID of the secondary NIC
portSecurityEnabled boolean: Enable source/destination address check for the NIC. When enabled, the system automatically blocks traffic whose source or destination address does not match the current NIC. true to enable, false to disable (default)
primaryIpAddress EniPrimaryIpAddress: Primary private IPv4 address of the network interface. Address modification is not supported, but you can modify the public IP. If specified, it must be an available private IPv4 address in the corresponding subnet. If not specified, an available private IPv4 address will be automatically assigned from the corresponding subnet. For example: 192.XX.XX.10.
privateIpSets EniPrivateIpSet[]
projectName string: Name of the project to which the NIC belongs
secondaryPrivateIpAddressCount number: Number of auxiliary private IPv4 addresses automatically assigned to the auxiliary network interface. Value range: 1–49. Cannot be used together with PrivateIpSets during creation.
securityGroupIds string[]: ID of one or more security groups joined by the auxiliary network interface.
subnetId string: ID of the subnet where the auxiliary network interface resides.
tags EniTag[]

delete_on_termination bool: Enable release with cloud server instance deletion. true to enable, false to disable
description str: Description for the auxiliary network interface. Length limit: 0–255 characters. Must start with a letter, Chinese character, or number. Allowed characters include English comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (，), and Chinese period (。). If not specified, defaults to an empty string.
instance_id str: ID of the instance bound to the NIC. If the NIC is not attached or the ServiceManaged parameter is true, InstanceId returns empty
ipv6_address_count int: Number of private IPv6 addresses assigned to the network interface. When this parameter is specified, the system automatically assigns the corresponding number of available private IPv6 addresses from the subnet to which the network interface belongs. Cannot be used together with IPv6Sets during creation.
ipv6_sets Sequence[str]: IPv6 address list of the network interface, for example [2408::153:3921:XX:XX:7b12:1c5f, 2408:4008:2cf:XX:XX:dd1e:2a22:5ddf].
network_interface_name str: NIC name. Length must be between 1 and 128 characters, starting with a letter, Chinese character, or number. Can include periods (.), underscores (_), and hyphens (-). If not specified, defaults to the ID of the secondary NIC
port_security_enabled bool: Enable source/destination address check for the NIC. When enabled, the system automatically blocks traffic whose source or destination address does not match the current NIC. true to enable, false to disable (default)
primary_ip_address EniPrimaryIpAddressArgs: Primary private IPv4 address of the network interface. Address modification is not supported, but you can modify the public IP. If specified, it must be an available private IPv4 address in the corresponding subnet. If not specified, an available private IPv4 address will be automatically assigned from the corresponding subnet. For example: 192.XX.XX.10.
private_ip_sets Sequence[EniPrivateIpSetArgs]
project_name str: Name of the project to which the NIC belongs
secondary_private_ip_address_count int: Number of auxiliary private IPv4 addresses automatically assigned to the auxiliary network interface. Value range: 1–49. Cannot be used together with PrivateIpSets during creation.
security_group_ids Sequence[str]: ID of one or more security groups joined by the auxiliary network interface.
subnet_id str: ID of the subnet where the auxiliary network interface resides.
tags Sequence[EniTagArgs]

deleteOnTermination Boolean: Enable release with cloud server instance deletion. true to enable, false to disable
description String: Description for the auxiliary network interface. Length limit: 0–255 characters. Must start with a letter, Chinese character, or number. Allowed characters include English comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (，), and Chinese period (。). If not specified, defaults to an empty string.
instanceId String: ID of the instance bound to the NIC. If the NIC is not attached or the ServiceManaged parameter is true, InstanceId returns empty
ipv6AddressCount Number: Number of private IPv6 addresses assigned to the network interface. When this parameter is specified, the system automatically assigns the corresponding number of available private IPv6 addresses from the subnet to which the network interface belongs. Cannot be used together with IPv6Sets during creation.
ipv6Sets List<String>: IPv6 address list of the network interface, for example [2408::153:3921:XX:XX:7b12:1c5f, 2408:4008:2cf:XX:XX:dd1e:2a22:5ddf].
networkInterfaceName String: NIC name. Length must be between 1 and 128 characters, starting with a letter, Chinese character, or number. Can include periods (.), underscores (_), and hyphens (-). If not specified, defaults to the ID of the secondary NIC
portSecurityEnabled Boolean: Enable source/destination address check for the NIC. When enabled, the system automatically blocks traffic whose source or destination address does not match the current NIC. true to enable, false to disable (default)
primaryIpAddress Property Map: Primary private IPv4 address of the network interface. Address modification is not supported, but you can modify the public IP. If specified, it must be an available private IPv4 address in the corresponding subnet. If not specified, an available private IPv4 address will be automatically assigned from the corresponding subnet. For example: 192.XX.XX.10.
privateIpSets List<Property Map>
projectName String: Name of the project to which the NIC belongs
secondaryPrivateIpAddressCount Number: Number of auxiliary private IPv4 addresses automatically assigned to the auxiliary network interface. Value range: 1–49. Cannot be used together with PrivateIpSets during creation.
securityGroupIds List<String>: ID of one or more security groups joined by the auxiliary network interface.
subnetId String: ID of the subnet where the auxiliary network interface resides.
tags List<Property Map>

Outputs

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

AccountId string: NIC owner ID
CreatedTime string: NIC creation time
Id string: The provider-assigned unique ID for this managed resource.
MacAddress string: MAC address of the network interface.
NetworkInterfaceId string: Network interface ID.
ServiceManaged bool: Indicates whether this is an official service network interface. true for yes, false for no.
Status string: Binding status of the network interface. Creating: In progress. Available: Not attached. Attaching: In progress. InUse: Attached. Detaching: In progress. Deleting: In progress.
Type string: NIC type. primary: primary NIC, secondary: secondary NIC
UpdatedTime string: NIC update time
VpcId string: ID of the VPC to which the network interface belongs.
VpcName string: Name of the VPC to which the NIC belongs
ZoneId string: ID of the availability zone to which the network interface belongs.

AccountId string: NIC owner ID
CreatedTime string: NIC creation time
Id string: The provider-assigned unique ID for this managed resource.
MacAddress string: MAC address of the network interface.
NetworkInterfaceId string: Network interface ID.
ServiceManaged bool: Indicates whether this is an official service network interface. true for yes, false for no.
Status string: Binding status of the network interface. Creating: In progress. Available: Not attached. Attaching: In progress. InUse: Attached. Detaching: In progress. Deleting: In progress.
Type string: NIC type. primary: primary NIC, secondary: secondary NIC
UpdatedTime string: NIC update time
VpcId string: ID of the VPC to which the network interface belongs.
VpcName string: Name of the VPC to which the NIC belongs
ZoneId string: ID of the availability zone to which the network interface belongs.

accountId String: NIC owner ID
createdTime String: NIC creation time
id String: The provider-assigned unique ID for this managed resource.
macAddress String: MAC address of the network interface.
networkInterfaceId String: Network interface ID.
serviceManaged Boolean: Indicates whether this is an official service network interface. true for yes, false for no.
status String: Binding status of the network interface. Creating: In progress. Available: Not attached. Attaching: In progress. InUse: Attached. Detaching: In progress. Deleting: In progress.
type String: NIC type. primary: primary NIC, secondary: secondary NIC
updatedTime String: NIC update time
vpcId String: ID of the VPC to which the network interface belongs.
vpcName String: Name of the VPC to which the NIC belongs
zoneId String: ID of the availability zone to which the network interface belongs.

accountId string: NIC owner ID
createdTime string: NIC creation time
id string: The provider-assigned unique ID for this managed resource.
macAddress string: MAC address of the network interface.
networkInterfaceId string: Network interface ID.
serviceManaged boolean: Indicates whether this is an official service network interface. true for yes, false for no.
status string: Binding status of the network interface. Creating: In progress. Available: Not attached. Attaching: In progress. InUse: Attached. Detaching: In progress. Deleting: In progress.
type string: NIC type. primary: primary NIC, secondary: secondary NIC
updatedTime string: NIC update time
vpcId string: ID of the VPC to which the network interface belongs.
vpcName string: Name of the VPC to which the NIC belongs
zoneId string: ID of the availability zone to which the network interface belongs.

account_id str: NIC owner ID
created_time str: NIC creation time
id str: The provider-assigned unique ID for this managed resource.
mac_address str: MAC address of the network interface.
network_interface_id str: Network interface ID.
service_managed bool: Indicates whether this is an official service network interface. true for yes, false for no.
status str: Binding status of the network interface. Creating: In progress. Available: Not attached. Attaching: In progress. InUse: Attached. Detaching: In progress. Deleting: In progress.
type str: NIC type. primary: primary NIC, secondary: secondary NIC
updated_time str: NIC update time
vpc_id str: ID of the VPC to which the network interface belongs.
vpc_name str: Name of the VPC to which the NIC belongs
zone_id str: ID of the availability zone to which the network interface belongs.

accountId String: NIC owner ID
createdTime String: NIC creation time
id String: The provider-assigned unique ID for this managed resource.
macAddress String: MAC address of the network interface.
networkInterfaceId String: Network interface ID.
serviceManaged Boolean: Indicates whether this is an official service network interface. true for yes, false for no.
status String: Binding status of the network interface. Creating: In progress. Available: Not attached. Attaching: In progress. InUse: Attached. Detaching: In progress. Deleting: In progress.
type String: NIC type. primary: primary NIC, secondary: secondary NIC
updatedTime String: NIC update time
vpcId String: ID of the VPC to which the network interface belongs.
vpcName String: Name of the VPC to which the NIC belongs
zoneId String: ID of the availability zone to which the network interface belongs.

Look up Existing Eni Resource

Get an existing Eni 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?: EniState, opts?: CustomResourceOptions): Eni

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        account_id: Optional[str] = None,
        created_time: Optional[str] = None,
        delete_on_termination: Optional[bool] = None,
        description: Optional[str] = None,
        instance_id: Optional[str] = None,
        ipv6_address_count: Optional[int] = None,
        ipv6_sets: Optional[Sequence[str]] = None,
        mac_address: Optional[str] = None,
        network_interface_id: Optional[str] = None,
        network_interface_name: Optional[str] = None,
        port_security_enabled: Optional[bool] = None,
        primary_ip_address: Optional[EniPrimaryIpAddressArgs] = None,
        private_ip_sets: Optional[Sequence[EniPrivateIpSetArgs]] = None,
        project_name: Optional[str] = None,
        secondary_private_ip_address_count: Optional[int] = None,
        security_group_ids: Optional[Sequence[str]] = None,
        service_managed: Optional[bool] = None,
        status: Optional[str] = None,
        subnet_id: Optional[str] = None,
        tags: Optional[Sequence[EniTagArgs]] = None,
        type: Optional[str] = None,
        updated_time: Optional[str] = None,
        vpc_id: Optional[str] = None,
        vpc_name: Optional[str] = None,
        zone_id: Optional[str] = None) -> Eni

func GetEni(ctx *Context, name string, id IDInput, state *EniState, opts ...ResourceOption) (*Eni, error)

public static Eni Get(string name, Input<string> id, EniState? state, CustomResourceOptions? opts = null)

public static Eni get(String name, Output<String> id, EniState state, CustomResourceOptions options)

resources:  _:    type: volcenginecc:vpc:Eni    get:      id: ${id}

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:

AccountId string: NIC owner ID
CreatedTime string: NIC creation time
DeleteOnTermination bool: Enable release with cloud server instance deletion. true to enable, false to disable
Description string: Description for the auxiliary network interface. Length limit: 0–255 characters. Must start with a letter, Chinese character, or number. Allowed characters include English comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (，), and Chinese period (。). If not specified, defaults to an empty string.
InstanceId string: ID of the instance bound to the NIC. If the NIC is not attached or the ServiceManaged parameter is true, InstanceId returns empty
Ipv6AddressCount int: Number of private IPv6 addresses assigned to the network interface. When this parameter is specified, the system automatically assigns the corresponding number of available private IPv6 addresses from the subnet to which the network interface belongs. Cannot be used together with IPv6Sets during creation.
Ipv6Sets List<string>: IPv6 address list of the network interface, for example [2408::153:3921:XX:XX:7b12:1c5f, 2408:4008:2cf:XX:XX:dd1e:2a22:5ddf].
MacAddress string: MAC address of the network interface.
NetworkInterfaceId string: Network interface ID.
NetworkInterfaceName string: NIC name. Length must be between 1 and 128 characters, starting with a letter, Chinese character, or number. Can include periods (.), underscores (_), and hyphens (-). If not specified, defaults to the ID of the secondary NIC
PortSecurityEnabled bool: Enable source/destination address check for the NIC. When enabled, the system automatically blocks traffic whose source or destination address does not match the current NIC. true to enable, false to disable (default)
PrimaryIpAddress Volcengine.EniPrimaryIpAddress: Primary private IPv4 address of the network interface. Address modification is not supported, but you can modify the public IP. If specified, it must be an available private IPv4 address in the corresponding subnet. If not specified, an available private IPv4 address will be automatically assigned from the corresponding subnet. For example: 192.XX.XX.10.
PrivateIpSets List<Volcengine.EniPrivateIpSet>
ProjectName string: Name of the project to which the NIC belongs
SecondaryPrivateIpAddressCount int: Number of auxiliary private IPv4 addresses automatically assigned to the auxiliary network interface. Value range: 1–49. Cannot be used together with PrivateIpSets during creation.
SecurityGroupIds List<string>: ID of one or more security groups joined by the auxiliary network interface.
ServiceManaged bool: Indicates whether this is an official service network interface. true for yes, false for no.
Status string: Binding status of the network interface. Creating: In progress. Available: Not attached. Attaching: In progress. InUse: Attached. Detaching: In progress. Deleting: In progress.
SubnetId string: ID of the subnet where the auxiliary network interface resides.
Tags List<Volcengine.EniTag>
Type string: NIC type. primary: primary NIC, secondary: secondary NIC
UpdatedTime string: NIC update time
VpcId string: ID of the VPC to which the network interface belongs.
VpcName string: Name of the VPC to which the NIC belongs
ZoneId string: ID of the availability zone to which the network interface belongs.

AccountId string: NIC owner ID
CreatedTime string: NIC creation time
DeleteOnTermination bool: Enable release with cloud server instance deletion. true to enable, false to disable
Description string: Description for the auxiliary network interface. Length limit: 0–255 characters. Must start with a letter, Chinese character, or number. Allowed characters include English comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (，), and Chinese period (。). If not specified, defaults to an empty string.
InstanceId string: ID of the instance bound to the NIC. If the NIC is not attached or the ServiceManaged parameter is true, InstanceId returns empty
Ipv6AddressCount int: Number of private IPv6 addresses assigned to the network interface. When this parameter is specified, the system automatically assigns the corresponding number of available private IPv6 addresses from the subnet to which the network interface belongs. Cannot be used together with IPv6Sets during creation.
Ipv6Sets []string: IPv6 address list of the network interface, for example [2408::153:3921:XX:XX:7b12:1c5f, 2408:4008:2cf:XX:XX:dd1e:2a22:5ddf].
MacAddress string: MAC address of the network interface.
NetworkInterfaceId string: Network interface ID.
NetworkInterfaceName string: NIC name. Length must be between 1 and 128 characters, starting with a letter, Chinese character, or number. Can include periods (.), underscores (_), and hyphens (-). If not specified, defaults to the ID of the secondary NIC
PortSecurityEnabled bool: Enable source/destination address check for the NIC. When enabled, the system automatically blocks traffic whose source or destination address does not match the current NIC. true to enable, false to disable (default)
PrimaryIpAddress EniPrimaryIpAddressArgs: Primary private IPv4 address of the network interface. Address modification is not supported, but you can modify the public IP. If specified, it must be an available private IPv4 address in the corresponding subnet. If not specified, an available private IPv4 address will be automatically assigned from the corresponding subnet. For example: 192.XX.XX.10.
PrivateIpSets []EniPrivateIpSetArgs
ProjectName string: Name of the project to which the NIC belongs
SecondaryPrivateIpAddressCount int: Number of auxiliary private IPv4 addresses automatically assigned to the auxiliary network interface. Value range: 1–49. Cannot be used together with PrivateIpSets during creation.
SecurityGroupIds []string: ID of one or more security groups joined by the auxiliary network interface.
ServiceManaged bool: Indicates whether this is an official service network interface. true for yes, false for no.
Status string: Binding status of the network interface. Creating: In progress. Available: Not attached. Attaching: In progress. InUse: Attached. Detaching: In progress. Deleting: In progress.
SubnetId string: ID of the subnet where the auxiliary network interface resides.
Tags []EniTagArgs
Type string: NIC type. primary: primary NIC, secondary: secondary NIC
UpdatedTime string: NIC update time
VpcId string: ID of the VPC to which the network interface belongs.
VpcName string: Name of the VPC to which the NIC belongs
ZoneId string: ID of the availability zone to which the network interface belongs.

accountId String: NIC owner ID
createdTime String: NIC creation time
deleteOnTermination Boolean: Enable release with cloud server instance deletion. true to enable, false to disable
description String: Description for the auxiliary network interface. Length limit: 0–255 characters. Must start with a letter, Chinese character, or number. Allowed characters include English comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (，), and Chinese period (。). If not specified, defaults to an empty string.
instanceId String: ID of the instance bound to the NIC. If the NIC is not attached or the ServiceManaged parameter is true, InstanceId returns empty
ipv6AddressCount Integer: Number of private IPv6 addresses assigned to the network interface. When this parameter is specified, the system automatically assigns the corresponding number of available private IPv6 addresses from the subnet to which the network interface belongs. Cannot be used together with IPv6Sets during creation.
ipv6Sets List<String>: IPv6 address list of the network interface, for example [2408::153:3921:XX:XX:7b12:1c5f, 2408:4008:2cf:XX:XX:dd1e:2a22:5ddf].
macAddress String: MAC address of the network interface.
networkInterfaceId String: Network interface ID.
networkInterfaceName String: NIC name. Length must be between 1 and 128 characters, starting with a letter, Chinese character, or number. Can include periods (.), underscores (_), and hyphens (-). If not specified, defaults to the ID of the secondary NIC
portSecurityEnabled Boolean: Enable source/destination address check for the NIC. When enabled, the system automatically blocks traffic whose source or destination address does not match the current NIC. true to enable, false to disable (default)
primaryIpAddress EniPrimaryIpAddress: Primary private IPv4 address of the network interface. Address modification is not supported, but you can modify the public IP. If specified, it must be an available private IPv4 address in the corresponding subnet. If not specified, an available private IPv4 address will be automatically assigned from the corresponding subnet. For example: 192.XX.XX.10.
privateIpSets List<EniPrivateIpSet>
projectName String: Name of the project to which the NIC belongs
secondaryPrivateIpAddressCount Integer: Number of auxiliary private IPv4 addresses automatically assigned to the auxiliary network interface. Value range: 1–49. Cannot be used together with PrivateIpSets during creation.
securityGroupIds List<String>: ID of one or more security groups joined by the auxiliary network interface.
serviceManaged Boolean: Indicates whether this is an official service network interface. true for yes, false for no.
status String: Binding status of the network interface. Creating: In progress. Available: Not attached. Attaching: In progress. InUse: Attached. Detaching: In progress. Deleting: In progress.
subnetId String: ID of the subnet where the auxiliary network interface resides.
tags List<EniTag>
type String: NIC type. primary: primary NIC, secondary: secondary NIC
updatedTime String: NIC update time
vpcId String: ID of the VPC to which the network interface belongs.
vpcName String: Name of the VPC to which the NIC belongs
zoneId String: ID of the availability zone to which the network interface belongs.

accountId string: NIC owner ID
createdTime string: NIC creation time
deleteOnTermination boolean: Enable release with cloud server instance deletion. true to enable, false to disable
description string: Description for the auxiliary network interface. Length limit: 0–255 characters. Must start with a letter, Chinese character, or number. Allowed characters include English comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (，), and Chinese period (。). If not specified, defaults to an empty string.
instanceId string: ID of the instance bound to the NIC. If the NIC is not attached or the ServiceManaged parameter is true, InstanceId returns empty
ipv6AddressCount number: Number of private IPv6 addresses assigned to the network interface. When this parameter is specified, the system automatically assigns the corresponding number of available private IPv6 addresses from the subnet to which the network interface belongs. Cannot be used together with IPv6Sets during creation.
ipv6Sets string[]: IPv6 address list of the network interface, for example [2408::153:3921:XX:XX:7b12:1c5f, 2408:4008:2cf:XX:XX:dd1e:2a22:5ddf].
macAddress string: MAC address of the network interface.
networkInterfaceId string: Network interface ID.
networkInterfaceName string: NIC name. Length must be between 1 and 128 characters, starting with a letter, Chinese character, or number. Can include periods (.), underscores (_), and hyphens (-). If not specified, defaults to the ID of the secondary NIC
portSecurityEnabled boolean: Enable source/destination address check for the NIC. When enabled, the system automatically blocks traffic whose source or destination address does not match the current NIC. true to enable, false to disable (default)
primaryIpAddress EniPrimaryIpAddress: Primary private IPv4 address of the network interface. Address modification is not supported, but you can modify the public IP. If specified, it must be an available private IPv4 address in the corresponding subnet. If not specified, an available private IPv4 address will be automatically assigned from the corresponding subnet. For example: 192.XX.XX.10.
privateIpSets EniPrivateIpSet[]
projectName string: Name of the project to which the NIC belongs
secondaryPrivateIpAddressCount number: Number of auxiliary private IPv4 addresses automatically assigned to the auxiliary network interface. Value range: 1–49. Cannot be used together with PrivateIpSets during creation.
securityGroupIds string[]: ID of one or more security groups joined by the auxiliary network interface.
serviceManaged boolean: Indicates whether this is an official service network interface. true for yes, false for no.
status string: Binding status of the network interface. Creating: In progress. Available: Not attached. Attaching: In progress. InUse: Attached. Detaching: In progress. Deleting: In progress.
subnetId string: ID of the subnet where the auxiliary network interface resides.
tags EniTag[]
type string: NIC type. primary: primary NIC, secondary: secondary NIC
updatedTime string: NIC update time
vpcId string: ID of the VPC to which the network interface belongs.
vpcName string: Name of the VPC to which the NIC belongs
zoneId string: ID of the availability zone to which the network interface belongs.

account_id str: NIC owner ID
created_time str: NIC creation time
delete_on_termination bool: Enable release with cloud server instance deletion. true to enable, false to disable
description str: Description for the auxiliary network interface. Length limit: 0–255 characters. Must start with a letter, Chinese character, or number. Allowed characters include English comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (，), and Chinese period (。). If not specified, defaults to an empty string.
instance_id str: ID of the instance bound to the NIC. If the NIC is not attached or the ServiceManaged parameter is true, InstanceId returns empty
ipv6_address_count int: Number of private IPv6 addresses assigned to the network interface. When this parameter is specified, the system automatically assigns the corresponding number of available private IPv6 addresses from the subnet to which the network interface belongs. Cannot be used together with IPv6Sets during creation.
ipv6_sets Sequence[str]: IPv6 address list of the network interface, for example [2408::153:3921:XX:XX:7b12:1c5f, 2408:4008:2cf:XX:XX:dd1e:2a22:5ddf].
mac_address str: MAC address of the network interface.
network_interface_id str: Network interface ID.
network_interface_name str: NIC name. Length must be between 1 and 128 characters, starting with a letter, Chinese character, or number. Can include periods (.), underscores (_), and hyphens (-). If not specified, defaults to the ID of the secondary NIC
port_security_enabled bool: Enable source/destination address check for the NIC. When enabled, the system automatically blocks traffic whose source or destination address does not match the current NIC. true to enable, false to disable (default)
primary_ip_address EniPrimaryIpAddressArgs: Primary private IPv4 address of the network interface. Address modification is not supported, but you can modify the public IP. If specified, it must be an available private IPv4 address in the corresponding subnet. If not specified, an available private IPv4 address will be automatically assigned from the corresponding subnet. For example: 192.XX.XX.10.
private_ip_sets Sequence[EniPrivateIpSetArgs]
project_name str: Name of the project to which the NIC belongs
secondary_private_ip_address_count int: Number of auxiliary private IPv4 addresses automatically assigned to the auxiliary network interface. Value range: 1–49. Cannot be used together with PrivateIpSets during creation.
security_group_ids Sequence[str]: ID of one or more security groups joined by the auxiliary network interface.
service_managed bool: Indicates whether this is an official service network interface. true for yes, false for no.
status str: Binding status of the network interface. Creating: In progress. Available: Not attached. Attaching: In progress. InUse: Attached. Detaching: In progress. Deleting: In progress.
subnet_id str: ID of the subnet where the auxiliary network interface resides.
tags Sequence[EniTagArgs]
type str: NIC type. primary: primary NIC, secondary: secondary NIC
updated_time str: NIC update time
vpc_id str: ID of the VPC to which the network interface belongs.
vpc_name str: Name of the VPC to which the NIC belongs
zone_id str: ID of the availability zone to which the network interface belongs.

accountId String: NIC owner ID
createdTime String: NIC creation time
deleteOnTermination Boolean: Enable release with cloud server instance deletion. true to enable, false to disable
description String: Description for the auxiliary network interface. Length limit: 0–255 characters. Must start with a letter, Chinese character, or number. Allowed characters include English comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (，), and Chinese period (。). If not specified, defaults to an empty string.
instanceId String: ID of the instance bound to the NIC. If the NIC is not attached or the ServiceManaged parameter is true, InstanceId returns empty
ipv6AddressCount Number: Number of private IPv6 addresses assigned to the network interface. When this parameter is specified, the system automatically assigns the corresponding number of available private IPv6 addresses from the subnet to which the network interface belongs. Cannot be used together with IPv6Sets during creation.
ipv6Sets List<String>: IPv6 address list of the network interface, for example [2408::153:3921:XX:XX:7b12:1c5f, 2408:4008:2cf:XX:XX:dd1e:2a22:5ddf].
macAddress String: MAC address of the network interface.
networkInterfaceId String: Network interface ID.
networkInterfaceName String: NIC name. Length must be between 1 and 128 characters, starting with a letter, Chinese character, or number. Can include periods (.), underscores (_), and hyphens (-). If not specified, defaults to the ID of the secondary NIC
portSecurityEnabled Boolean: Enable source/destination address check for the NIC. When enabled, the system automatically blocks traffic whose source or destination address does not match the current NIC. true to enable, false to disable (default)
primaryIpAddress Property Map: Primary private IPv4 address of the network interface. Address modification is not supported, but you can modify the public IP. If specified, it must be an available private IPv4 address in the corresponding subnet. If not specified, an available private IPv4 address will be automatically assigned from the corresponding subnet. For example: 192.XX.XX.10.
privateIpSets List<Property Map>
projectName String: Name of the project to which the NIC belongs
secondaryPrivateIpAddressCount Number: Number of auxiliary private IPv4 addresses automatically assigned to the auxiliary network interface. Value range: 1–49. Cannot be used together with PrivateIpSets during creation.
securityGroupIds List<String>: ID of one or more security groups joined by the auxiliary network interface.
serviceManaged Boolean: Indicates whether this is an official service network interface. true for yes, false for no.
status String: Binding status of the network interface. Creating: In progress. Available: Not attached. Attaching: In progress. InUse: Attached. Detaching: In progress. Deleting: In progress.
subnetId String: ID of the subnet where the auxiliary network interface resides.
tags List<Property Map>
type String: NIC type. primary: primary NIC, secondary: secondary NIC
updatedTime String: NIC update time
vpcId String: ID of the VPC to which the network interface belongs.
vpcName String: Name of the VPC to which the NIC belongs
zoneId String: ID of the availability zone to which the network interface belongs.

Supporting Types

EniPrimaryIpAddress, EniPrimaryIpAddressArgs

AssociatedElasticIp Volcengine.EniPrimaryIpAddressAssociatedElasticIp: Information about the public IP associated with the primary private IPv4 address of the network interface.
Primary bool: Indicates whether this is the primary private IPv4 address.
PrivateIpAddress string: Private IP address of the network interface.

AssociatedElasticIp EniPrimaryIpAddressAssociatedElasticIp: Information about the public IP associated with the primary private IPv4 address of the network interface.
Primary bool: Indicates whether this is the primary private IPv4 address.
PrivateIpAddress string: Private IP address of the network interface.

associatedElasticIp EniPrimaryIpAddressAssociatedElasticIp: Information about the public IP associated with the primary private IPv4 address of the network interface.
primary Boolean: Indicates whether this is the primary private IPv4 address.
privateIpAddress String: Private IP address of the network interface.

associatedElasticIp EniPrimaryIpAddressAssociatedElasticIp: Information about the public IP associated with the primary private IPv4 address of the network interface.
primary boolean: Indicates whether this is the primary private IPv4 address.
privateIpAddress string: Private IP address of the network interface.

associated_elastic_ip EniPrimaryIpAddressAssociatedElasticIp: Information about the public IP associated with the primary private IPv4 address of the network interface.
primary bool: Indicates whether this is the primary private IPv4 address.
private_ip_address str: Private IP address of the network interface.

associatedElasticIp Property Map: Information about the public IP associated with the primary private IPv4 address of the network interface.
primary Boolean: Indicates whether this is the primary private IPv4 address.
privateIpAddress String: Private IP address of the network interface.

EniPrimaryIpAddressAssociatedElasticIp, EniPrimaryIpAddressAssociatedElasticIpArgs

AllocationId string: Public IP ID
EipAddress string: Public IP address
ReleaseWithInstance bool: Whether the public IP is released when the cloud server instance is deleted. Only pay-as-you-go public IPs bound to the primary NIC's primary private IP are valid. When enabled, if the cloud server instance is automatically reclaimed by the system (24 hours after unsubscription, upon expiration, or due to overdue payment) or deleted via the DeleteInstances API, the public IP is released along with the instance. true: yes, false: no

AllocationId string: Public IP ID
EipAddress string: Public IP address
ReleaseWithInstance bool: Whether the public IP is released when the cloud server instance is deleted. Only pay-as-you-go public IPs bound to the primary NIC's primary private IP are valid. When enabled, if the cloud server instance is automatically reclaimed by the system (24 hours after unsubscription, upon expiration, or due to overdue payment) or deleted via the DeleteInstances API, the public IP is released along with the instance. true: yes, false: no

allocationId String: Public IP ID
eipAddress String: Public IP address
releaseWithInstance Boolean: Whether the public IP is released when the cloud server instance is deleted. Only pay-as-you-go public IPs bound to the primary NIC's primary private IP are valid. When enabled, if the cloud server instance is automatically reclaimed by the system (24 hours after unsubscription, upon expiration, or due to overdue payment) or deleted via the DeleteInstances API, the public IP is released along with the instance. true: yes, false: no

allocationId string: Public IP ID
eipAddress string: Public IP address
releaseWithInstance boolean: Whether the public IP is released when the cloud server instance is deleted. Only pay-as-you-go public IPs bound to the primary NIC's primary private IP are valid. When enabled, if the cloud server instance is automatically reclaimed by the system (24 hours after unsubscription, upon expiration, or due to overdue payment) or deleted via the DeleteInstances API, the public IP is released along with the instance. true: yes, false: no

allocation_id str: Public IP ID
eip_address str: Public IP address
release_with_instance bool: Whether the public IP is released when the cloud server instance is deleted. Only pay-as-you-go public IPs bound to the primary NIC's primary private IP are valid. When enabled, if the cloud server instance is automatically reclaimed by the system (24 hours after unsubscription, upon expiration, or due to overdue payment) or deleted via the DeleteInstances API, the public IP is released along with the instance. true: yes, false: no

allocationId String: Public IP ID
eipAddress String: Public IP address
releaseWithInstance Boolean: Whether the public IP is released when the cloud server instance is deleted. Only pay-as-you-go public IPs bound to the primary NIC's primary private IP are valid. When enabled, if the cloud server instance is automatically reclaimed by the system (24 hours after unsubscription, upon expiration, or due to overdue payment) or deleted via the DeleteInstances API, the public IP is released along with the instance. true: yes, false: no

EniPrivateIpSet, EniPrivateIpSetArgs

AssociatedElasticIp Volcengine.EniPrivateIpSetAssociatedElasticIp: Information about the public IP associated with the primary private IPv4 address of the network interface.
PrivateIpAddress string: Private IP address of the network interface.

AssociatedElasticIp EniPrivateIpSetAssociatedElasticIp: Information about the public IP associated with the primary private IPv4 address of the network interface.
PrivateIpAddress string: Private IP address of the network interface.

associatedElasticIp EniPrivateIpSetAssociatedElasticIp: Information about the public IP associated with the primary private IPv4 address of the network interface.
privateIpAddress String: Private IP address of the network interface.

associatedElasticIp EniPrivateIpSetAssociatedElasticIp: Information about the public IP associated with the primary private IPv4 address of the network interface.
privateIpAddress string: Private IP address of the network interface.

associated_elastic_ip EniPrivateIpSetAssociatedElasticIp: Information about the public IP associated with the primary private IPv4 address of the network interface.
private_ip_address str: Private IP address of the network interface.

associatedElasticIp Property Map: Information about the public IP associated with the primary private IPv4 address of the network interface.
privateIpAddress String: Private IP address of the network interface.

EniPrivateIpSetAssociatedElasticIp, EniPrivateIpSetAssociatedElasticIpArgs

AllocationId string: Public IP ID

AllocationId string: Public IP ID

allocationId String: Public IP ID

allocationId string: Public IP ID

allocation_id str: Public IP ID

allocationId String: Public IP ID

EniTag, EniTagArgs

Key string: Tag key for the user tag.
Value string: Tag value for the user tag.

Key string: Tag key for the user tag.
Value string: Tag value for the user tag.

key String: Tag key for the user tag.
value String: Tag value for the user tag.

key string: Tag key for the user tag.
value string: Tag value for the user tag.

key str: Tag key for the user tag.
value str: Tag value for the user tag.

key String: Tag key for the user tag.
value String: Tag value for the user tag.

Import

$ pulumi import volcenginecc:vpc/eni:Eni example "network_interface_id"

To learn more about importing existing cloud resources, see Importing resources.

Package Details

Repository: volcenginecc volcengine/pulumi-volcenginecc
License: MPL-2.0
Notes: This Pulumi package is based on the volcenginecc Terraform Provider.

Viewing docs for volcenginecc v0.0.32
published on Thursday, Apr 23, 2026 by Volcengine

Schema (JSON)

volcengine/pulumi-volcenginecc

On this page

On this page

Example Usage

Create Eni Resource

Constructor syntax

Parameters

Eni Resource Properties

Inputs

Outputs

Look up Existing Eni Resource

Supporting Types

EniPrimaryIpAddress, EniPrimaryIpAddressArgs

EniPrimaryIpAddressAssociatedElasticIp, EniPrimaryIpAddressAssociatedElasticIpArgs

EniPrivateIpSet, EniPrivateIpSetArgs

EniPrivateIpSetAssociatedElasticIp, EniPrivateIpSetAssociatedElasticIpArgs

EniTag, EniTagArgs

Import

Package Details

On this page

On this page