pulumi-alicloud-kotlin/com.pulumi.alicloud.ecs.kotlin/EcsNetworkInterfaceArgs

EcsNetworkInterfaceArgs

data class EcsNetworkInterfaceArgs(val description: Output<String>? = null, val instanceType: Output<String>? = null, val ipv4PrefixCount: Output<Int>? = null, val ipv4Prefixes: Output<List<String>>? = null, val ipv6AddressCount: Output<Int>? = null, val ipv6Addresses: Output<List<String>>? = null, val name: Output<String>? = null, val networkInterfaceName: Output<String>? = null, val networkInterfaceTrafficMode: Output<String>? = null, val primaryIpAddress: Output<String>? = null, val privateIp: Output<String>? = null, val privateIpAddresses: Output<List<String>>? = null, val privateIps: Output<List<String>>? = null, val privateIpsCount: Output<Int>? = null, val queueNumber: Output<Int>? = null, val resourceGroupId: Output<String>? = null, val secondaryPrivateIpAddressCount: Output<Int>? = null, val securityGroupIds: Output<List<String>>? = null, val securityGroups: Output<List<String>>? = null, val tags: Output<Map<String, String>>? = null, val vswitchId: Output<String>? = null) : ConvertibleToJava<EcsNetworkInterfaceArgs>

Provides a ECS Network Interface resource. For information about ECS Network Interface and how to use it, see What is Network Interface.

NOTE: Available since v1.123.1. NOTE Only one of private_ip_addresses or secondary_private_ip_address_count can be specified when assign private IPs.

Example Usage

Basic Usage

import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const config = new pulumi.Config();
const name = config.get("name") || "tf-example";
const defaultNetwork = new alicloud.vpc.Network("default", {
    vpcName: name,
    cidrBlock: "192.168.0.0/24",
});
const _default = alicloud.getZones({
    availableResourceCreation: "VSwitch",
});
const defaultSwitch = new alicloud.vpc.Switch("default", {
    vswitchName: name,
    cidrBlock: "192.168.0.0/24",
    zoneId: _default.then(_default => _default.zones?.[0]?.id),
    vpcId: defaultNetwork.id,
});
const defaultSecurityGroup = new alicloud.ecs.SecurityGroup("default", {
    name: name,
    vpcId: defaultNetwork.id,
});
const defaultGetResourceGroups = alicloud.resourcemanager.getResourceGroups({
    status: "OK",
});
const defaultEcsNetworkInterface = new alicloud.ecs.EcsNetworkInterface("default", {
    networkInterfaceName: name,
    vswitchId: defaultSwitch.id,
    securityGroupIds: [defaultSecurityGroup&#46;id],
    description: "Basic test",
    primaryIpAddress: "192.168.0.2",
    tags: {
        Created: "TF",
        For: "Test",
    },
    resourceGroupId: defaultGetResourceGroups.then(defaultGetResourceGroups => defaultGetResourceGroups.ids?.[0]),
});
Content copied to clipboard
import pulumi
import pulumi_alicloud as alicloud
config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "tf-example"
default_network = alicloud.vpc.Network("default",
    vpc_name=name,
    cidr_block="192.168.0.0/24")
default = alicloud.get_zones(available_resource_creation="VSwitch")
default_switch = alicloud.vpc.Switch("default",
    vswitch_name=name,
    cidr_block="192.168.0.0/24",
    zone_id=default.zones[0].id,
    vpc_id=default_network.id)
default_security_group = alicloud.ecs.SecurityGroup("default",
    name=name,
    vpc_id=default_network.id)
default_get_resource_groups = alicloud.resourcemanager.get_resource_groups(status="OK")
default_ecs_network_interface = alicloud.ecs.EcsNetworkInterface("default",
    network_interface_name=name,
    vswitch_id=default_switch.id,
    security_group_ids=[default_security_group&#46;id],
    description="Basic test",
    primary_ip_address="192.168.0.2",
    tags={
        "Created": "TF",
        "For": "Test",
    },
    resource_group_id=default_get_resource_groups.ids[0])
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
    var config = new Config();
    var name = config.Get("name") ?? "tf-example";
    var defaultNetwork = new AliCloud.Vpc.Network("default", new()
    {
        VpcName = name,
        CidrBlock = "192.168.0.0/24",
    });
    var @default = AliCloud.GetZones.Invoke(new()
    {
        AvailableResourceCreation = "VSwitch",
    });
    var defaultSwitch = new AliCloud.Vpc.Switch("default", new()
    {
        VswitchName = name,
        CidrBlock = "192.168.0.0/24",
        ZoneId = @default.Apply(@default => @default.Apply(getZonesResult => getZonesResult.Zones[0]?.Id)),
        VpcId = defaultNetwork.Id,
    });
    var defaultSecurityGroup = new AliCloud.Ecs.SecurityGroup("default", new()
    {
        Name = name,
        VpcId = defaultNetwork.Id,
    });
    var defaultGetResourceGroups = AliCloud.ResourceManager.GetResourceGroups.Invoke(new()
    {
        Status = "OK",
    });
    var defaultEcsNetworkInterface = new AliCloud.Ecs.EcsNetworkInterface("default", new()
    {
        NetworkInterfaceName = name,
        VswitchId = defaultSwitch.Id,
        SecurityGroupIds = new[]
        {
            defaultSecurityGroup.Id,
        },
        Description = "Basic test",
        PrimaryIpAddress = "192.168.0.2",
        Tags =
        {
            { "Created", "TF" },
            { "For", "Test" },
        },
        ResourceGroupId = defaultGetResourceGroups.Apply(getResourceGroupsResult => getResourceGroupsResult.Ids[0]),
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud"
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/ecs"
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/resourcemanager"
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/vpc"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		cfg := config.New(ctx, "")
		name := "tf-example"
		if param := cfg.Get("name"); param != "" {
			name = param
		}
		defaultNetwork, err := vpc.NewNetwork(ctx, "default", &vpc.NetworkArgs{
			VpcName:   pulumi.String(name),
			CidrBlock: pulumi.String("192.168.0.0/24"),
		})
		if err != nil {
			return err
		}
		_default, err := alicloud.GetZones(ctx, &alicloud.GetZonesArgs{
			AvailableResourceCreation: pulumi.StringRef("VSwitch"),
		}, nil)
		if err != nil {
			return err
		}
		defaultSwitch, err := vpc.NewSwitch(ctx, "default", &vpc.SwitchArgs{
			VswitchName: pulumi.String(name),
			CidrBlock:   pulumi.String("192.168.0.0/24"),
			ZoneId:      pulumi.String(_default.Zones[0].Id),
			VpcId:       defaultNetwork.ID(),
		})
		if err != nil {
			return err
		}
		defaultSecurityGroup, err := ecs.NewSecurityGroup(ctx, "default", &ecs.SecurityGroupArgs{
			Name:  pulumi.String(name),
			VpcId: defaultNetwork.ID(),
		})
		if err != nil {
			return err
		}
		defaultGetResourceGroups, err := resourcemanager.GetResourceGroups(ctx, &resourcemanager.GetResourceGroupsArgs{
			Status: pulumi.StringRef("OK"),
		}, nil)
		if err != nil {
			return err
		}
		_, err = ecs.NewEcsNetworkInterface(ctx, "default", &ecs.EcsNetworkInterfaceArgs{
			NetworkInterfaceName: pulumi.String(name),
			VswitchId:            defaultSwitch.ID(),
			SecurityGroupIds: pulumi.StringArray{
				defaultSecurityGroup.ID(),
			},
			Description:      pulumi.String("Basic test"),
			PrimaryIpAddress: pulumi.String("192.168.0.2"),
			Tags: pulumi.StringMap{
				"Created": pulumi.String("TF"),
				"For":     pulumi.String("Test"),
			},
			ResourceGroupId: pulumi.String(defaultGetResourceGroups.Ids[0]),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.vpc.Network;
import com.pulumi.alicloud.vpc.NetworkArgs;
import com.pulumi.alicloud.AlicloudFunctions;
import com.pulumi.alicloud.inputs.GetZonesArgs;
import com.pulumi.alicloud.vpc.Switch;
import com.pulumi.alicloud.vpc.SwitchArgs;
import com.pulumi.alicloud.ecs.SecurityGroup;
import com.pulumi.alicloud.ecs.SecurityGroupArgs;
import com.pulumi.alicloud.resourcemanager.ResourcemanagerFunctions;
import com.pulumi.alicloud.resourcemanager.inputs.GetResourceGroupsArgs;
import com.pulumi.alicloud.ecs.EcsNetworkInterface;
import com.pulumi.alicloud.ecs.EcsNetworkInterfaceArgs;
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) {
        final var config = ctx.config();
        final var name = config.get("name").orElse("tf-example");
        var defaultNetwork = new Network("defaultNetwork", NetworkArgs.builder()
            .vpcName(name)
            .cidrBlock("192.168.0.0/24")
            .build());
        final var default = AlicloudFunctions.getZones(GetZonesArgs.builder()
            .availableResourceCreation("VSwitch")
            .build());
        var defaultSwitch = new Switch("defaultSwitch", SwitchArgs.builder()
            .vswitchName(name)
            .cidrBlock("192.168.0.0/24")
            .zoneId(default_.zones()[0].id())
            .vpcId(defaultNetwork.id())
            .build());
        var defaultSecurityGroup = new SecurityGroup("defaultSecurityGroup", SecurityGroupArgs.builder()
            .name(name)
            .vpcId(defaultNetwork.id())
            .build());
        final var defaultGetResourceGroups = ResourcemanagerFunctions.getResourceGroups(GetResourceGroupsArgs.builder()
            .status("OK")
            .build());
        var defaultEcsNetworkInterface = new EcsNetworkInterface("defaultEcsNetworkInterface", EcsNetworkInterfaceArgs.builder()
            .networkInterfaceName(name)
            .vswitchId(defaultSwitch.id())
            .securityGroupIds(defaultSecurityGroup.id())
            .description("Basic test")
            .primaryIpAddress("192.168.0.2")
            .tags(Map.ofEntries(
                Map.entry("Created", "TF"),
                Map.entry("For", "Test")
            ))
            .resourceGroupId(defaultGetResourceGroups.ids()[0])
            .build());
    }
}
Content copied to clipboard
configuration:
  name:
    type: string
    default: tf-example
resources:
  defaultNetwork:
    type: alicloud:vpc:Network
    name: default
    properties:
      vpcName: ${name}
      cidrBlock: 192.168.0.0/24
  defaultSwitch:
    type: alicloud:vpc:Switch
    name: default
    properties:
      vswitchName: ${name}
      cidrBlock: 192.168.0.0/24
      zoneId: ${default.zones[0].id}
      vpcId: ${defaultNetwork.id}
  defaultSecurityGroup:
    type: alicloud:ecs:SecurityGroup
    name: default
    properties:
      name: ${name}
      vpcId: ${defaultNetwork.id}
  defaultEcsNetworkInterface:
    type: alicloud:ecs:EcsNetworkInterface
    name: default
    properties:
      networkInterfaceName: ${name}
      vswitchId: ${defaultSwitch.id}
      securityGroupIds:
        - ${defaultSecurityGroup.id}
      description: Basic test
      primaryIpAddress: 192.168.0.2
      tags:
        Created: TF
        For: Test
      resourceGroupId: ${defaultGetResourceGroups.ids[0]}
variables:
  default:
    fn::invoke:
      function: alicloud:getZones
      arguments:
        availableResourceCreation: VSwitch
  defaultGetResourceGroups:
    fn::invoke:
      function: alicloud:resourcemanager:getResourceGroups
      arguments:
        status: OK
Content copied to clipboard

Import

ECS Network Interface can be imported using the id, e.g.

$ pulumi import alicloud:ecs/ecsNetworkInterface:EcsNetworkInterface example eni-abcd12345
Content copied to clipboard

Constructors

Link copied to clipboard
constructor(description: Output<String>? = null, instanceType: Output<String>? = null, ipv4PrefixCount: Output<Int>? = null, ipv4Prefixes: Output<List<String>>? = null, ipv6AddressCount: Output<Int>? = null, ipv6Addresses: Output<List<String>>? = null, name: Output<String>? = null, networkInterfaceName: Output<String>? = null, networkInterfaceTrafficMode: Output<String>? = null, primaryIpAddress: Output<String>? = null, privateIp: Output<String>? = null, privateIpAddresses: Output<List<String>>? = null, privateIps: Output<List<String>>? = null, privateIpsCount: Output<Int>? = null, queueNumber: Output<Int>? = null, resourceGroupId: Output<String>? = null, secondaryPrivateIpAddressCount: Output<Int>? = null, securityGroupIds: Output<List<String>>? = null, securityGroups: Output<List<String>>? = null, tags: Output<Map<String, String>>? = null, vswitchId: Output<String>? = null)

Properties

Link copied to clipboard
val description: Output<String>? = null

The description of the ENI. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

Link copied to clipboard
val instanceType: Output<String>? = null

The type of the ENI. Default value: Secondary. Valid values: Secondary, Trunk.

Link copied to clipboard
val ipv4PrefixCount: Output<Int>? = null

The number of IPv4 prefixes that can be automatically created by ECS. Valid values: 1 to 10. NOTE: You cannot specify both the ipv4_prefixes and ipv4_prefix_count parameters.

Link copied to clipboard
val ipv4Prefixes: Output<List<String>>? = null

A list of IPv4 prefixes to be assigned to the ENI. Support up to 10.

Link copied to clipboard
val ipv6AddressCount: Output<Int>? = null

The number of IPv6 addresses to randomly generate for the primary ENI. Valid values: 1 to 10. NOTE: You cannot specify both the ipv6_addresses and ipv6_address_count parameters.

Link copied to clipboard
val ipv6Addresses: Output<List<String>>? = null

A list of IPv6 address to be assigned to the primary ENI. Support up to 10.

Link copied to clipboard
val name: Output<String>? = null

Field name has been deprecated from provider version 1.123.1. New field network_interface_name instead

Link copied to clipboard
val networkInterfaceName: Output<String>? = null

The name of the ENI. The name must be 2 to 128 characters in length, and can contain letters, digits, colons (:), underscores (_), and hyphens (-). It must start with a letter and cannot start with http:// or https://.

Link copied to clipboard
val networkInterfaceTrafficMode: Output<String>? = null

The communication mode of the ENI. Default value: Standard. Valid values: Standard, HighPerformance.

Link copied to clipboard
val primaryIpAddress: Output<String>? = null

The primary private IP address of the ENI. The specified IP address must be available within the CIDR block of the VSwitch. If this parameter is not specified, an available IP address is assigned from the VSwitch CIDR block at random.

Link copied to clipboard
val privateIp: Output<String>? = null

Field private_ip has been deprecated from provider version 1.123.1. New field primary_ip_address instead

Link copied to clipboard
val privateIpAddresses: Output<List<String>>? = null

Specifies secondary private IP address N of the ENI. This IP address must be an available IP address within the CIDR block of the VSwitch to which the ENI belongs.

Link copied to clipboard
val privateIps: Output<List<String>>? = null

Field private_ips has been deprecated from provider version 1.123.1. New field private_ip_addresses instead

Link copied to clipboard
val privateIpsCount: Output<Int>? = null

Field private_ips_count has been deprecated from provider version 1.123.1. New field secondary_private_ip_address_count instead

Link copied to clipboard
val queueNumber: Output<Int>? = null

The queue number of the ENI.

Link copied to clipboard
val resourceGroupId: Output<String>? = null

The resource group id.

Link copied to clipboard
val secondaryPrivateIpAddressCount: Output<Int>? = null

The number of private IP addresses that can be automatically created by ECS.

Link copied to clipboard
val securityGroupIds: Output<List<String>>? = null

The ID of security group N. The security groups and the ENI must belong to the same VPC. The valid values of N are based on the maximum number of security groups to which an ENI can be added. NOTE: Either security_group_ids or security_groups must be set with valid security group IDs.

Link copied to clipboard
val securityGroups: Output<List<String>>? = null

Field security_groups has been deprecated from provider version 1.123.1. New field security_group_ids instead. NOTE: Either security_group_ids or security_groups must be set with valid security group IDs.

Link copied to clipboard
val tags: Output<Map<String, String>>? = null

A mapping of tags to assign to the resource.

Link copied to clipboard
val vswitchId: Output<String>? = null

The ID of the VSwitch in the specified VPC. The private IP addresses assigned to the ENI must be available IP addresses within the CIDR block of the VSwitch.

Functions

Link copied to clipboard
open override fun toJava(): EcsNetworkInterfaceArgs