Docs Home Pulumi IaC Pulumi ESC Pulumi Cloud Packages Tutorials
  1. Packages
  2. Outscale Provider
  3. API Docs
  4. Nic
outscale 1.0.1 published on Thursday, Mar 13, 2025 by outscale
outscale/terraform-provider-outscale

outscale.Nic

Explore with Pulumi AI

outscale logo
outscale 1.0.1 published on Thursday, Mar 13, 2025 by outscale
outscale/terraform-provider-outscale

    Manages a network interface card (NIC).

    For more information on this resource, see the User Guide.
    For more information on this resource actions, see the API documentation.

    Example Usage

    Required resources

    import * as pulumi from "@pulumi/pulumi";
import * as outscale from "@pulumi/outscale";

const net01 = new outscale.Net("net01", {ipRange: "10.0.0.0/16"});
const subnet01 = new outscale.Subnet("subnet01", {
    subregionName: "eu-west-2a",
    ipRange: "10.0.0.0/18",
    netId: net01.netId,
});
const securityGroup01 = new outscale.SecurityGroup("securityGroup01", {
    description: "Terraform security group for nic with private IPs",
    securityGroupName: "terraform-security-group-nic-ips",
    netId: net01.netId,
});

    import pulumi
import pulumi_outscale as outscale

net01 = outscale.Net("net01", ip_range="10.0.0.0/16")
subnet01 = outscale.Subnet("subnet01",
    subregion_name="eu-west-2a",
    ip_range="10.0.0.0/18",
    net_id=net01.net_id)
security_group01 = outscale.SecurityGroup("securityGroup01",
    description="Terraform security group for nic with private IPs",
    security_group_name="terraform-security-group-nic-ips",
    net_id=net01.net_id)

    package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/outscale/outscale"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		net01, err := outscale.NewNet(ctx, "net01", &outscale.NetArgs{
			IpRange: pulumi.String("10.0.0.0/16"),
		})
		if err != nil {
			return err
		}
		_, err = outscale.NewSubnet(ctx, "subnet01", &outscale.SubnetArgs{
			SubregionName: pulumi.String("eu-west-2a"),
			IpRange:       pulumi.String("10.0.0.0/18"),
			NetId:         net01.NetId,
		})
		if err != nil {
			return err
		}
		_, err = outscale.NewSecurityGroup(ctx, "securityGroup01", &outscale.SecurityGroupArgs{
			Description:       pulumi.String("Terraform security group for nic with private IPs"),
			SecurityGroupName: pulumi.String("terraform-security-group-nic-ips"),
			NetId:             net01.NetId,
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Outscale = Pulumi.Outscale;

return await Deployment.RunAsync(() => 
{
    var net01 = new Outscale.Net("net01", new()
    {
        IpRange = "10.0.0.0/16",
    });

    var subnet01 = new Outscale.Subnet("subnet01", new()
    {
        SubregionName = "eu-west-2a",
        IpRange = "10.0.0.0/18",
        NetId = net01.NetId,
    });

    var securityGroup01 = new Outscale.SecurityGroup("securityGroup01", new()
    {
        Description = "Terraform security group for nic with private IPs",
        SecurityGroupName = "terraform-security-group-nic-ips",
        NetId = net01.NetId,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.outscale.Net;
import com.pulumi.outscale.NetArgs;
import com.pulumi.outscale.Subnet;
import com.pulumi.outscale.SubnetArgs;
import com.pulumi.outscale.SecurityGroup;
import com.pulumi.outscale.SecurityGroupArgs;
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 net01 = new Net("net01", NetArgs.builder()
            .ipRange("10.0.0.0/16")
            .build());

        var subnet01 = new Subnet("subnet01", SubnetArgs.builder()
            .subregionName("eu-west-2a")
            .ipRange("10.0.0.0/18")
            .netId(net01.netId())
            .build());

        var securityGroup01 = new SecurityGroup("securityGroup01", SecurityGroupArgs.builder()
            .description("Terraform security group for nic with private IPs")
            .securityGroupName("terraform-security-group-nic-ips")
            .netId(net01.netId())
            .build());

    }
}

    resources:
  net01:
    type: outscale:Net
    properties:
      ipRange: 10.0.0.0/16
  subnet01:
    type: outscale:Subnet
    properties:
      subregionName: eu-west-2a
      ipRange: 10.0.0.0/18
      netId: ${net01.netId}
  securityGroup01:
    type: outscale:SecurityGroup
    properties:
      description: Terraform security group for nic with private IPs
      securityGroupName: terraform-security-group-nic-ips
      netId: ${net01.netId}

    Create a NIC

    import * as pulumi from "@pulumi/pulumi";
import * as outscale from "@pulumi/outscale";

const nic01 = new outscale.Nic("nic01", {
    subnetId: outscale_subnet.subnet01.subnet_id,
    securityGroupIds: [outscale_security_group.security_group01.security_group_id],
});

    import pulumi
import pulumi_outscale as outscale

nic01 = outscale.Nic("nic01",
    subnet_id=outscale_subnet["subnet01"]["subnet_id"],
    security_group_ids=[outscale_security_group["security_group01"]["security_group_id"]])

    package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/outscale/outscale"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := outscale.NewNic(ctx, "nic01", &outscale.NicArgs{
			SubnetId: pulumi.Any(outscale_subnet.Subnet01.Subnet_id),
			SecurityGroupIds: pulumi.StringArray{
				outscale_security_group.Security_group01.Security_group_id,
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Outscale = Pulumi.Outscale;

return await Deployment.RunAsync(() => 
{
    var nic01 = new Outscale.Nic("nic01", new()
    {
        SubnetId = outscale_subnet.Subnet01.Subnet_id,
        SecurityGroupIds = new[]
        {
            outscale_security_group.Security_group01.Security_group_id,
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.outscale.Nic;
import com.pulumi.outscale.NicArgs;
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 nic01 = new Nic("nic01", NicArgs.builder()
            .subnetId(outscale_subnet.subnet01().subnet_id())
            .securityGroupIds(outscale_security_group.security_group01().security_group_id())
            .build());

    }
}

    resources:
  nic01:
    type: outscale:Nic
    properties:
      subnetId: ${outscale_subnet.subnet01.subnet_id}
      securityGroupIds:
        - ${outscale_security_group.security_group01.security_group_id}

    Create a NIC with private IP addresses

    import * as pulumi from "@pulumi/pulumi";
import * as outscale from "@pulumi/outscale";

const nic02 = new outscale.Nic("nic02", {
    description: "Terraform nic with private IPs",
    subnetId: outscale_subnet.subnet01.subnet_id,
    securityGroupIds: [outscale_security_group.security_group01.security_group_id],
    privateIps: [
        {
            isPrimary: true,
            privateIp: "10.0.0.1",
        },
        {
            isPrimary: false,
            privateIp: "10.0.0.2",
        },
    ],
});

    import pulumi
import pulumi_outscale as outscale

nic02 = outscale.Nic("nic02",
    description="Terraform nic with private IPs",
    subnet_id=outscale_subnet["subnet01"]["subnet_id"],
    security_group_ids=[outscale_security_group["security_group01"]["security_group_id"]],
    private_ips=[
        {
            "is_primary": True,
            "private_ip": "10.0.0.1",
        },
        {
            "is_primary": False,
            "private_ip": "10.0.0.2",
        },
    ])

    package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/outscale/outscale"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := outscale.NewNic(ctx, "nic02", &outscale.NicArgs{
			Description: pulumi.String("Terraform nic with private IPs"),
			SubnetId:    pulumi.Any(outscale_subnet.Subnet01.Subnet_id),
			SecurityGroupIds: pulumi.StringArray{
				outscale_security_group.Security_group01.Security_group_id,
			},
			PrivateIps: outscale.NicPrivateIpTypeArray{
				&outscale.NicPrivateIpTypeArgs{
					IsPrimary: pulumi.Bool(true),
					PrivateIp: pulumi.String("10.0.0.1"),
				},
				&outscale.NicPrivateIpTypeArgs{
					IsPrimary: pulumi.Bool(false),
					PrivateIp: pulumi.String("10.0.0.2"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Outscale = Pulumi.Outscale;

return await Deployment.RunAsync(() => 
{
    var nic02 = new Outscale.Nic("nic02", new()
    {
        Description = "Terraform nic with private IPs",
        SubnetId = outscale_subnet.Subnet01.Subnet_id,
        SecurityGroupIds = new[]
        {
            outscale_security_group.Security_group01.Security_group_id,
        },
        PrivateIps = new[]
        {
            new Outscale.Inputs.NicPrivateIpArgs
            {
                IsPrimary = true,
                PrivateIp = "10.0.0.1",
            },
            new Outscale.Inputs.NicPrivateIpArgs
            {
                IsPrimary = false,
                PrivateIp = "10.0.0.2",
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.outscale.Nic;
import com.pulumi.outscale.NicArgs;
import com.pulumi.outscale.inputs.NicPrivateIpArgs;
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 nic02 = new Nic("nic02", NicArgs.builder()
            .description("Terraform nic with private IPs")
            .subnetId(outscale_subnet.subnet01().subnet_id())
            .securityGroupIds(outscale_security_group.security_group01().security_group_id())
            .privateIps(            
                NicPrivateIpArgs.builder()
                    .isPrimary(true)
                    .privateIp("10.0.0.1")
                    .build(),
                NicPrivateIpArgs.builder()
                    .isPrimary(false)
                    .privateIp("10.0.0.2")
                    .build())
            .build());

    }
}

    resources:
  nic02:
    type: outscale:Nic
    properties:
      description: Terraform nic with private IPs
      subnetId: ${outscale_subnet.subnet01.subnet_id}
      securityGroupIds:
        - ${outscale_security_group.security_group01.security_group_id}
      privateIps:
        - isPrimary: true
          privateIp: 10.0.0.1
        - isPrimary: false
          privateIp: 10.0.0.2

    Create Nic Resource

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

    Constructor syntax

    new Nic(name: string, args: NicArgs, opts?: CustomResourceOptions);
    @overload
def Nic(resource_name: str,
        args: NicArgs,
        opts: Optional[ResourceOptions] = None)

@overload
def Nic(resource_name: str,
        opts: Optional[ResourceOptions] = None,
        subnet_id: Optional[str] = None,
        description: Optional[str] = None,
        outscale_nic_id: Optional[str] = None,
        private_ip: Optional[str] = None,
        private_ips: Optional[Sequence[NicPrivateIpArgs]] = None,
        security_group_ids: Optional[Sequence[str]] = None,
        tags: Optional[Sequence[NicTagArgs]] = None,
        timeouts: Optional[NicTimeoutsArgs] = None)
    func NewNic(ctx *Context, name string, args NicArgs, opts ...ResourceOption) (*Nic, error)
    public Nic(string name, NicArgs args, CustomResourceOptions? opts = null)
    public Nic(String name, NicArgs args)
public Nic(String name, NicArgs args, CustomResourceOptions options)

    type: outscale:Nic
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 NicArgs
    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 NicArgs
    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 NicArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args NicArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args NicArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var nicResource = new Outscale.Nic("nicResource", new()
{
    SubnetId = "string",
    Description = "string",
    OutscaleNicId = "string",
    PrivateIp = "string",
    PrivateIps = new[]
    {
        new Outscale.Inputs.NicPrivateIpArgs
        {
            IsPrimary = false,
            LinkPublicIps = new[]
            {
                new Outscale.Inputs.NicPrivateIpLinkPublicIpArgs
                {
                    LinkPublicIpId = "string",
                    PublicDnsName = "string",
                    PublicIp = "string",
                    PublicIpAccountId = "string",
                    PublicIpId = "string",
                },
            },
            PrivateDnsName = "string",
            PrivateIp = "string",
        },
    },
    SecurityGroupIds = new[]
    {
        "string",
    },
    Tags = new[]
    {
        new Outscale.Inputs.NicTagArgs
        {
            Key = "string",
            Value = "string",
        },
    },
    Timeouts = new Outscale.Inputs.NicTimeoutsArgs
    {
        Create = "string",
        Delete = "string",
    },
});

    example, err := outscale.NewNic(ctx, "nicResource", &outscale.NicArgs{
SubnetId: pulumi.String("string"),
Description: pulumi.String("string"),
OutscaleNicId: pulumi.String("string"),
PrivateIp: pulumi.String("string"),
PrivateIps: .NicPrivateIpTypeArray{
&.NicPrivateIpTypeArgs{
IsPrimary: pulumi.Bool(false),
LinkPublicIps: .NicPrivateIpLinkPublicIpArray{
&.NicPrivateIpLinkPublicIpArgs{
LinkPublicIpId: pulumi.String("string"),
PublicDnsName: pulumi.String("string"),
PublicIp: pulumi.String("string"),
PublicIpAccountId: pulumi.String("string"),
PublicIpId: pulumi.String("string"),
},
},
PrivateDnsName: pulumi.String("string"),
PrivateIp: pulumi.String("string"),
},
},
SecurityGroupIds: pulumi.StringArray{
pulumi.String("string"),
},
Tags: .NicTagArray{
&.NicTagArgs{
Key: pulumi.String("string"),
Value: pulumi.String("string"),
},
},
Timeouts: &.NicTimeoutsArgs{
Create: pulumi.String("string"),
Delete: pulumi.String("string"),
},
})

    var nicResource = new Nic("nicResource", NicArgs.builder()
    .subnetId("string")
    .description("string")
    .outscaleNicId("string")
    .privateIp("string")
    .privateIps(NicPrivateIpArgs.builder()
        .isPrimary(false)
        .linkPublicIps(NicPrivateIpLinkPublicIpArgs.builder()
            .linkPublicIpId("string")
            .publicDnsName("string")
            .publicIp("string")
            .publicIpAccountId("string")
            .publicIpId("string")
            .build())
        .privateDnsName("string")
        .privateIp("string")
        .build())
    .securityGroupIds("string")
    .tags(NicTagArgs.builder()
        .key("string")
        .value("string")
        .build())
    .timeouts(NicTimeoutsArgs.builder()
        .create("string")
        .delete("string")
        .build())
    .build());

    nic_resource = outscale.Nic("nicResource",
    subnet_id="string",
    description="string",
    outscale_nic_id="string",
    private_ip="string",
    private_ips=[{
        "is_primary": False,
        "link_public_ips": [{
            "link_public_ip_id": "string",
            "public_dns_name": "string",
            "public_ip": "string",
            "public_ip_account_id": "string",
            "public_ip_id": "string",
        }],
        "private_dns_name": "string",
        "private_ip": "string",
    }],
    security_group_ids=["string"],
    tags=[{
        "key": "string",
        "value": "string",
    }],
    timeouts={
        "create": "string",
        "delete": "string",
    })

    const nicResource = new outscale.Nic("nicResource", {
    subnetId: "string",
    description: "string",
    outscaleNicId: "string",
    privateIp: "string",
    privateIps: [{
        isPrimary: false,
        linkPublicIps: [{
            linkPublicIpId: "string",
            publicDnsName: "string",
            publicIp: "string",
            publicIpAccountId: "string",
            publicIpId: "string",
        }],
        privateDnsName: "string",
        privateIp: "string",
    }],
    securityGroupIds: ["string"],
    tags: [{
        key: "string",
        value: "string",
    }],
    timeouts: {
        create: "string",
        "delete": "string",
    },
});

    type: outscale:Nic
properties:
    description: string
    outscaleNicId: string
    privateIp: string
    privateIps:
        - isPrimary: false
          linkPublicIps:
            - linkPublicIpId: string
              publicDnsName: string
              publicIp: string
              publicIpAccountId: string
              publicIpId: string
          privateDnsName: string
          privateIp: string
    securityGroupIds:
        - string
    subnetId: string
    tags:
        - key: string
          value: string
    timeouts:
        create: string
        delete: string

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

    SubnetId string
    The ID of the Subnet in which you want to create the NIC.
    Description string
    A description for the NIC.
    OutscaleNicId string
    PrivateIp string
    The private IP of the NIC.
    PrivateIps List<NicPrivateIp>
    The primary private IP for the NIC. This IP must be within the IP range of the Subnet that you specify with the subnet_id attribute. If you do not specify this attribute, a random private IP is selected within the IP range of the Subnet.
    SecurityGroupIds List<string>
    One or more IDs of security groups for the NIC.
    Tags List<NicTag>
    A tag to add to this resource. You can specify this argument several times.
    Timeouts NicTimeouts
    SubnetId string
    The ID of the Subnet in which you want to create the NIC.
    Description string
    A description for the NIC.
    OutscaleNicId string
    PrivateIp string
    The private IP of the NIC.
    PrivateIps []NicPrivateIpTypeArgs
    The primary private IP for the NIC. This IP must be within the IP range of the Subnet that you specify with the subnet_id attribute. If you do not specify this attribute, a random private IP is selected within the IP range of the Subnet.
    SecurityGroupIds []string
    One or more IDs of security groups for the NIC.
    Tags []NicTagArgs
    A tag to add to this resource. You can specify this argument several times.
    Timeouts NicTimeoutsArgs
    subnetId String
    The ID of the Subnet in which you want to create the NIC.
    description String
    A description for the NIC.
    outscaleNicId String
    privateIp String
    The private IP of the NIC.
    privateIps List<NicPrivateIp>
    The primary private IP for the NIC. This IP must be within the IP range of the Subnet that you specify with the subnet_id attribute. If you do not specify this attribute, a random private IP is selected within the IP range of the Subnet.
    securityGroupIds List<String>
    One or more IDs of security groups for the NIC.
    tags List<NicTag>
    A tag to add to this resource. You can specify this argument several times.
    timeouts NicTimeouts
    subnetId string
    The ID of the Subnet in which you want to create the NIC.
    description string
    A description for the NIC.
    outscaleNicId string
    privateIp string
    The private IP of the NIC.
    privateIps NicPrivateIp[]
    The primary private IP for the NIC. This IP must be within the IP range of the Subnet that you specify with the subnet_id attribute. If you do not specify this attribute, a random private IP is selected within the IP range of the Subnet.
    securityGroupIds string[]
    One or more IDs of security groups for the NIC.
    tags NicTag[]
    A tag to add to this resource. You can specify this argument several times.
    timeouts NicTimeouts
    subnet_id str
    The ID of the Subnet in which you want to create the NIC.
    description str
    A description for the NIC.
    outscale_nic_id str
    private_ip str
    The private IP of the NIC.
    private_ips Sequence[NicPrivateIpArgs]
    The primary private IP for the NIC. This IP must be within the IP range of the Subnet that you specify with the subnet_id attribute. If you do not specify this attribute, a random private IP is selected within the IP range of the Subnet.
    security_group_ids Sequence[str]
    One or more IDs of security groups for the NIC.
    tags Sequence[NicTagArgs]
    A tag to add to this resource. You can specify this argument several times.
    timeouts NicTimeoutsArgs
    subnetId String
    The ID of the Subnet in which you want to create the NIC.
    description String
    A description for the NIC.
    outscaleNicId String
    privateIp String
    The private IP of the NIC.
    privateIps List<Property Map>
    The primary private IP for the NIC. This IP must be within the IP range of the Subnet that you specify with the subnet_id attribute. If you do not specify this attribute, a random private IP is selected within the IP range of the Subnet.
    securityGroupIds List<String>
    One or more IDs of security groups for the NIC.
    tags List<Property Map>
    A tag to add to this resource. You can specify this argument several times.
    timeouts Property Map

    Outputs

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

    AccountId string
    The account ID of the owner of the NIC.
    Id string
    The provider-assigned unique ID for this managed resource.
    IsSourceDestChecked bool
    (Net only) If true, the source/destination check is enabled. If false, it is disabled.
    LinkNics List<NicLinkNic>
    Information about the NIC attachment.
    LinkPublicIps List<NicLinkPublicIp>
    Information about the public IP association.
    MacAddress string
    The Media Access Control (MAC) address of the NIC.
    NetId string
    The ID of the Net for the NIC.
    NicId string
    The ID of the NIC.
    PrivateDnsName string
    The name of the private DNS.
    RequestId string
    RequesterManaged bool
    SecurityGroups List<NicSecurityGroup>
    One or more IDs of security groups for the NIC.
    State string
    The state of the NIC (available | attaching | in-use | detaching).
    SubregionName string
    The Subregion in which the NIC is located.
    AccountId string
    The account ID of the owner of the NIC.
    Id string
    The provider-assigned unique ID for this managed resource.
    IsSourceDestChecked bool
    (Net only) If true, the source/destination check is enabled. If false, it is disabled.
    LinkNics []NicLinkNic
    Information about the NIC attachment.
    LinkPublicIps []NicLinkPublicIp
    Information about the public IP association.
    MacAddress string
    The Media Access Control (MAC) address of the NIC.
    NetId string
    The ID of the Net for the NIC.
    NicId string
    The ID of the NIC.
    PrivateDnsName string
    The name of the private DNS.
    RequestId string
    RequesterManaged bool
    SecurityGroups []NicSecurityGroup
    One or more IDs of security groups for the NIC.
    State string
    The state of the NIC (available | attaching | in-use | detaching).
    SubregionName string
    The Subregion in which the NIC is located.
    accountId String
    The account ID of the owner of the NIC.
    id String
    The provider-assigned unique ID for this managed resource.
    isSourceDestChecked Boolean
    (Net only) If true, the source/destination check is enabled. If false, it is disabled.
    linkNics List<NicLinkNic>
    Information about the NIC attachment.
    linkPublicIps List<NicLinkPublicIp>
    Information about the public IP association.
    macAddress String
    The Media Access Control (MAC) address of the NIC.
    netId String
    The ID of the Net for the NIC.
    nicId String
    The ID of the NIC.
    privateDnsName String
    The name of the private DNS.
    requestId String
    requesterManaged Boolean
    securityGroups List<NicSecurityGroup>
    One or more IDs of security groups for the NIC.
    state String
    The state of the NIC (available | attaching | in-use | detaching).
    subregionName String
    The Subregion in which the NIC is located.
    accountId string
    The account ID of the owner of the NIC.
    id string
    The provider-assigned unique ID for this managed resource.
    isSourceDestChecked boolean
    (Net only) If true, the source/destination check is enabled. If false, it is disabled.
    linkNics NicLinkNic[]
    Information about the NIC attachment.
    linkPublicIps NicLinkPublicIp[]
    Information about the public IP association.
    macAddress string
    The Media Access Control (MAC) address of the NIC.
    netId string
    The ID of the Net for the NIC.
    nicId string
    The ID of the NIC.
    privateDnsName string
    The name of the private DNS.
    requestId string
    requesterManaged boolean
    securityGroups NicSecurityGroup[]
    One or more IDs of security groups for the NIC.
    state string
    The state of the NIC (available | attaching | in-use | detaching).
    subregionName string
    The Subregion in which the NIC is located.
    account_id str
    The account ID of the owner of the NIC.
    id str
    The provider-assigned unique ID for this managed resource.
    is_source_dest_checked bool
    (Net only) If true, the source/destination check is enabled. If false, it is disabled.
    link_nics Sequence[NicLinkNic]
    Information about the NIC attachment.
    link_public_ips Sequence[NicLinkPublicIp]
    Information about the public IP association.
    mac_address str
    The Media Access Control (MAC) address of the NIC.
    net_id str
    The ID of the Net for the NIC.
    nic_id str
    The ID of the NIC.
    private_dns_name str
    The name of the private DNS.
    request_id str
    requester_managed bool
    security_groups Sequence[NicSecurityGroup]
    One or more IDs of security groups for the NIC.
    state str
    The state of the NIC (available | attaching | in-use | detaching).
    subregion_name str
    The Subregion in which the NIC is located.
    accountId String
    The account ID of the owner of the NIC.
    id String
    The provider-assigned unique ID for this managed resource.
    isSourceDestChecked Boolean
    (Net only) If true, the source/destination check is enabled. If false, it is disabled.
    linkNics List<Property Map>
    Information about the NIC attachment.
    linkPublicIps List<Property Map>
    Information about the public IP association.
    macAddress String
    The Media Access Control (MAC) address of the NIC.
    netId String
    The ID of the Net for the NIC.
    nicId String
    The ID of the NIC.
    privateDnsName String
    The name of the private DNS.
    requestId String
    requesterManaged Boolean
    securityGroups List<Property Map>
    One or more IDs of security groups for the NIC.
    state String
    The state of the NIC (available | attaching | in-use | detaching).
    subregionName String
    The Subregion in which the NIC is located.

    Look up Existing Nic Resource

    Get an existing Nic 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?: NicState, opts?: CustomResourceOptions): Nic
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        account_id: Optional[str] = None,
        description: Optional[str] = None,
        is_source_dest_checked: Optional[bool] = None,
        link_nics: Optional[Sequence[NicLinkNicArgs]] = None,
        link_public_ips: Optional[Sequence[NicLinkPublicIpArgs]] = None,
        mac_address: Optional[str] = None,
        net_id: Optional[str] = None,
        nic_id: Optional[str] = None,
        outscale_nic_id: Optional[str] = None,
        private_dns_name: Optional[str] = None,
        private_ip: Optional[str] = None,
        private_ips: Optional[Sequence[NicPrivateIpArgs]] = None,
        request_id: Optional[str] = None,
        requester_managed: Optional[bool] = None,
        security_group_ids: Optional[Sequence[str]] = None,
        security_groups: Optional[Sequence[NicSecurityGroupArgs]] = None,
        state: Optional[str] = None,
        subnet_id: Optional[str] = None,
        subregion_name: Optional[str] = None,
        tags: Optional[Sequence[NicTagArgs]] = None,
        timeouts: Optional[NicTimeoutsArgs] = None) -> Nic
    func GetNic(ctx *Context, name string, id IDInput, state *NicState, opts ...ResourceOption) (*Nic, error)
    public static Nic Get(string name, Input<string> id, NicState? state, CustomResourceOptions? opts = null)
    public static Nic get(String name, Output<String> id, NicState state, CustomResourceOptions options)
    resources:  _:    type: outscale:Nic    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
    The account ID of the owner of the NIC.
    Description string
    A description for the NIC.
    IsSourceDestChecked bool
    (Net only) If true, the source/destination check is enabled. If false, it is disabled.
    LinkNics List<NicLinkNic>
    Information about the NIC attachment.
    LinkPublicIps List<NicLinkPublicIp>
    Information about the public IP association.
    MacAddress string
    The Media Access Control (MAC) address of the NIC.
    NetId string
    The ID of the Net for the NIC.
    NicId string
    The ID of the NIC.
    OutscaleNicId string
    PrivateDnsName string
    The name of the private DNS.
    PrivateIp string
    The private IP of the NIC.
    PrivateIps List<NicPrivateIp>
    The primary private IP for the NIC. This IP must be within the IP range of the Subnet that you specify with the subnet_id attribute. If you do not specify this attribute, a random private IP is selected within the IP range of the Subnet.
    RequestId string
    RequesterManaged bool
    SecurityGroupIds List<string>
    One or more IDs of security groups for the NIC.
    SecurityGroups List<NicSecurityGroup>
    One or more IDs of security groups for the NIC.
    State string
    The state of the NIC (available | attaching | in-use | detaching).
    SubnetId string
    The ID of the Subnet in which you want to create the NIC.
    SubregionName string
    The Subregion in which the NIC is located.
    Tags List<NicTag>
    A tag to add to this resource. You can specify this argument several times.
    Timeouts NicTimeouts
    AccountId string
    The account ID of the owner of the NIC.
    Description string
    A description for the NIC.
    IsSourceDestChecked bool
    (Net only) If true, the source/destination check is enabled. If false, it is disabled.
    LinkNics []NicLinkNicArgs
    Information about the NIC attachment.
    LinkPublicIps []NicLinkPublicIpArgs
    Information about the public IP association.
    MacAddress string
    The Media Access Control (MAC) address of the NIC.
    NetId string
    The ID of the Net for the NIC.
    NicId string
    The ID of the NIC.
    OutscaleNicId string
    PrivateDnsName string
    The name of the private DNS.
    PrivateIp string
    The private IP of the NIC.
    PrivateIps []NicPrivateIpTypeArgs
    The primary private IP for the NIC. This IP must be within the IP range of the Subnet that you specify with the subnet_id attribute. If you do not specify this attribute, a random private IP is selected within the IP range of the Subnet.
    RequestId string
    RequesterManaged bool
    SecurityGroupIds []string
    One or more IDs of security groups for the NIC.
    SecurityGroups []NicSecurityGroupArgs
    One or more IDs of security groups for the NIC.
    State string
    The state of the NIC (available | attaching | in-use | detaching).
    SubnetId string
    The ID of the Subnet in which you want to create the NIC.
    SubregionName string
    The Subregion in which the NIC is located.
    Tags []NicTagArgs
    A tag to add to this resource. You can specify this argument several times.
    Timeouts NicTimeoutsArgs
    accountId String
    The account ID of the owner of the NIC.
    description String
    A description for the NIC.
    isSourceDestChecked Boolean
    (Net only) If true, the source/destination check is enabled. If false, it is disabled.
    linkNics List<NicLinkNic>
    Information about the NIC attachment.
    linkPublicIps List<NicLinkPublicIp>
    Information about the public IP association.
    macAddress String
    The Media Access Control (MAC) address of the NIC.
    netId String
    The ID of the Net for the NIC.
    nicId String
    The ID of the NIC.
    outscaleNicId String
    privateDnsName String
    The name of the private DNS.
    privateIp String
    The private IP of the NIC.
    privateIps List<NicPrivateIp>
    The primary private IP for the NIC. This IP must be within the IP range of the Subnet that you specify with the subnet_id attribute. If you do not specify this attribute, a random private IP is selected within the IP range of the Subnet.
    requestId String
    requesterManaged Boolean
    securityGroupIds List<String>
    One or more IDs of security groups for the NIC.
    securityGroups List<NicSecurityGroup>
    One or more IDs of security groups for the NIC.
    state String
    The state of the NIC (available | attaching | in-use | detaching).
    subnetId String
    The ID of the Subnet in which you want to create the NIC.
    subregionName String
    The Subregion in which the NIC is located.
    tags List<NicTag>
    A tag to add to this resource. You can specify this argument several times.
    timeouts NicTimeouts
    accountId string
    The account ID of the owner of the NIC.
    description string
    A description for the NIC.
    isSourceDestChecked boolean
    (Net only) If true, the source/destination check is enabled. If false, it is disabled.
    linkNics NicLinkNic[]
    Information about the NIC attachment.
    linkPublicIps NicLinkPublicIp[]
    Information about the public IP association.
    macAddress string
    The Media Access Control (MAC) address of the NIC.
    netId string
    The ID of the Net for the NIC.
    nicId string
    The ID of the NIC.
    outscaleNicId string
    privateDnsName string
    The name of the private DNS.
    privateIp string
    The private IP of the NIC.
    privateIps NicPrivateIp[]
    The primary private IP for the NIC. This IP must be within the IP range of the Subnet that you specify with the subnet_id attribute. If you do not specify this attribute, a random private IP is selected within the IP range of the Subnet.
    requestId string
    requesterManaged boolean
    securityGroupIds string[]
    One or more IDs of security groups for the NIC.
    securityGroups NicSecurityGroup[]
    One or more IDs of security groups for the NIC.
    state string
    The state of the NIC (available | attaching | in-use | detaching).
    subnetId string
    The ID of the Subnet in which you want to create the NIC.
    subregionName string
    The Subregion in which the NIC is located.
    tags NicTag[]
    A tag to add to this resource. You can specify this argument several times.
    timeouts NicTimeouts
    account_id str
    The account ID of the owner of the NIC.
    description str
    A description for the NIC.
    is_source_dest_checked bool
    (Net only) If true, the source/destination check is enabled. If false, it is disabled.
    link_nics Sequence[NicLinkNicArgs]
    Information about the NIC attachment.
    link_public_ips Sequence[NicLinkPublicIpArgs]
    Information about the public IP association.
    mac_address str
    The Media Access Control (MAC) address of the NIC.
    net_id str
    The ID of the Net for the NIC.
    nic_id str
    The ID of the NIC.
    outscale_nic_id str
    private_dns_name str
    The name of the private DNS.
    private_ip str
    The private IP of the NIC.
    private_ips Sequence[NicPrivateIpArgs]
    The primary private IP for the NIC. This IP must be within the IP range of the Subnet that you specify with the subnet_id attribute. If you do not specify this attribute, a random private IP is selected within the IP range of the Subnet.
    request_id str
    requester_managed bool
    security_group_ids Sequence[str]
    One or more IDs of security groups for the NIC.
    security_groups Sequence[NicSecurityGroupArgs]
    One or more IDs of security groups for the NIC.
    state str
    The state of the NIC (available | attaching | in-use | detaching).
    subnet_id str
    The ID of the Subnet in which you want to create the NIC.
    subregion_name str
    The Subregion in which the NIC is located.
    tags Sequence[NicTagArgs]
    A tag to add to this resource. You can specify this argument several times.
    timeouts NicTimeoutsArgs
    accountId String
    The account ID of the owner of the NIC.
    description String
    A description for the NIC.
    isSourceDestChecked Boolean
    (Net only) If true, the source/destination check is enabled. If false, it is disabled.
    linkNics List<Property Map>
    Information about the NIC attachment.
    linkPublicIps List<Property Map>
    Information about the public IP association.
    macAddress String
    The Media Access Control (MAC) address of the NIC.
    netId String
    The ID of the Net for the NIC.
    nicId String
    The ID of the NIC.
    outscaleNicId String
    privateDnsName String
    The name of the private DNS.
    privateIp String
    The private IP of the NIC.
    privateIps List<Property Map>
    The primary private IP for the NIC. This IP must be within the IP range of the Subnet that you specify with the subnet_id attribute. If you do not specify this attribute, a random private IP is selected within the IP range of the Subnet.
    requestId String
    requesterManaged Boolean
    securityGroupIds List<String>
    One or more IDs of security groups for the NIC.
    securityGroups List<Property Map>
    One or more IDs of security groups for the NIC.
    state String
    The state of the NIC (available | attaching | in-use | detaching).
    subnetId String
    The ID of the Subnet in which you want to create the NIC.
    subregionName String
    The Subregion in which the NIC is located.
    tags List<Property Map>
    A tag to add to this resource. You can specify this argument several times.
    timeouts Property Map

    Supporting Types

    NicLinkNic, NicLinkNicArgs

    DeleteOnVmDeletion string
    If true, the NIC is deleted when the VM is terminated.
    DeviceNumber double
    The device index for the NIC attachment (between 1 and 7, both included).
    LinkNicId string
    The ID of the NIC to attach.
    State string
    The state of the NIC (available | attaching | in-use | detaching).
    VmAccountId string
    The account ID of the owner of the VM.
    VmId string
    The ID of the VM.
    DeleteOnVmDeletion string
    If true, the NIC is deleted when the VM is terminated.
    DeviceNumber float64
    The device index for the NIC attachment (between 1 and 7, both included).
    LinkNicId string
    The ID of the NIC to attach.
    State string
    The state of the NIC (available | attaching | in-use | detaching).
    VmAccountId string
    The account ID of the owner of the VM.
    VmId string
    The ID of the VM.
    deleteOnVmDeletion String
    If true, the NIC is deleted when the VM is terminated.
    deviceNumber Double
    The device index for the NIC attachment (between 1 and 7, both included).
    linkNicId String
    The ID of the NIC to attach.
    state String
    The state of the NIC (available | attaching | in-use | detaching).
    vmAccountId String
    The account ID of the owner of the VM.
    vmId String
    The ID of the VM.
    deleteOnVmDeletion string
    If true, the NIC is deleted when the VM is terminated.
    deviceNumber number
    The device index for the NIC attachment (between 1 and 7, both included).
    linkNicId string
    The ID of the NIC to attach.
    state string
    The state of the NIC (available | attaching | in-use | detaching).
    vmAccountId string
    The account ID of the owner of the VM.
    vmId string
    The ID of the VM.
    delete_on_vm_deletion str
    If true, the NIC is deleted when the VM is terminated.
    device_number float
    The device index for the NIC attachment (between 1 and 7, both included).
    link_nic_id str
    The ID of the NIC to attach.
    state str
    The state of the NIC (available | attaching | in-use | detaching).
    vm_account_id str
    The account ID of the owner of the VM.
    vm_id str
    The ID of the VM.
    deleteOnVmDeletion String
    If true, the NIC is deleted when the VM is terminated.
    deviceNumber Number
    The device index for the NIC attachment (between 1 and 7, both included).
    linkNicId String
    The ID of the NIC to attach.
    state String
    The state of the NIC (available | attaching | in-use | detaching).
    vmAccountId String
    The account ID of the owner of the VM.
    vmId String
    The ID of the VM.

    NicLinkPublicIp, NicLinkPublicIpArgs

    LinkPublicIpId string
    (Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
    PublicDnsName string
    The name of the public DNS.
    PublicIp string
    The public IP associated with the NIC.
    PublicIpAccountId string
    The account ID of the owner of the public IP.
    PublicIpId string
    The allocation ID of the public IP.
    LinkPublicIpId string
    (Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
    PublicDnsName string
    The name of the public DNS.
    PublicIp string
    The public IP associated with the NIC.
    PublicIpAccountId string
    The account ID of the owner of the public IP.
    PublicIpId string
    The allocation ID of the public IP.
    linkPublicIpId String
    (Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
    publicDnsName String
    The name of the public DNS.
    publicIp String
    The public IP associated with the NIC.
    publicIpAccountId String
    The account ID of the owner of the public IP.
    publicIpId String
    The allocation ID of the public IP.
    linkPublicIpId string
    (Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
    publicDnsName string
    The name of the public DNS.
    publicIp string
    The public IP associated with the NIC.
    publicIpAccountId string
    The account ID of the owner of the public IP.
    publicIpId string
    The allocation ID of the public IP.
    link_public_ip_id str
    (Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
    public_dns_name str
    The name of the public DNS.
    public_ip str
    The public IP associated with the NIC.
    public_ip_account_id str
    The account ID of the owner of the public IP.
    public_ip_id str
    The allocation ID of the public IP.
    linkPublicIpId String
    (Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
    publicDnsName String
    The name of the public DNS.
    publicIp String
    The public IP associated with the NIC.
    publicIpAccountId String
    The account ID of the owner of the public IP.
    publicIpId String
    The allocation ID of the public IP.

    NicPrivateIp, NicPrivateIpArgs

    IsPrimary bool
    If true, the IP is the primary private IP of the NIC.
    LinkPublicIps List<NicPrivateIpLinkPublicIp>
    Information about the public IP association.
    PrivateDnsName string
    The name of the private DNS.
    PrivateIp string
    The private IP of the NIC.
    IsPrimary bool
    If true, the IP is the primary private IP of the NIC.
    LinkPublicIps []NicPrivateIpLinkPublicIp
    Information about the public IP association.
    PrivateDnsName string
    The name of the private DNS.
    PrivateIp string
    The private IP of the NIC.
    isPrimary Boolean
    If true, the IP is the primary private IP of the NIC.
    linkPublicIps List<NicPrivateIpLinkPublicIp>
    Information about the public IP association.
    privateDnsName String
    The name of the private DNS.
    privateIp String
    The private IP of the NIC.
    isPrimary boolean
    If true, the IP is the primary private IP of the NIC.
    linkPublicIps NicPrivateIpLinkPublicIp[]
    Information about the public IP association.
    privateDnsName string
    The name of the private DNS.
    privateIp string
    The private IP of the NIC.
    is_primary bool
    If true, the IP is the primary private IP of the NIC.
    link_public_ips Sequence[NicPrivateIpLinkPublicIp]
    Information about the public IP association.
    private_dns_name str
    The name of the private DNS.
    private_ip str
    The private IP of the NIC.
    isPrimary Boolean
    If true, the IP is the primary private IP of the NIC.
    linkPublicIps List<Property Map>
    Information about the public IP association.
    privateDnsName String
    The name of the private DNS.
    privateIp String
    The private IP of the NIC.

    NicPrivateIpLinkPublicIp, NicPrivateIpLinkPublicIpArgs

    LinkPublicIpId string
    (Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
    PublicDnsName string
    The name of the public DNS.
    PublicIp string
    The public IP associated with the NIC.
    PublicIpAccountId string
    The account ID of the owner of the public IP.
    PublicIpId string
    The allocation ID of the public IP.
    LinkPublicIpId string
    (Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
    PublicDnsName string
    The name of the public DNS.
    PublicIp string
    The public IP associated with the NIC.
    PublicIpAccountId string
    The account ID of the owner of the public IP.
    PublicIpId string
    The allocation ID of the public IP.
    linkPublicIpId String
    (Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
    publicDnsName String
    The name of the public DNS.
    publicIp String
    The public IP associated with the NIC.
    publicIpAccountId String
    The account ID of the owner of the public IP.
    publicIpId String
    The allocation ID of the public IP.
    linkPublicIpId string
    (Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
    publicDnsName string
    The name of the public DNS.
    publicIp string
    The public IP associated with the NIC.
    publicIpAccountId string
    The account ID of the owner of the public IP.
    publicIpId string
    The allocation ID of the public IP.
    link_public_ip_id str
    (Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
    public_dns_name str
    The name of the public DNS.
    public_ip str
    The public IP associated with the NIC.
    public_ip_account_id str
    The account ID of the owner of the public IP.
    public_ip_id str
    The allocation ID of the public IP.
    linkPublicIpId String
    (Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
    publicDnsName String
    The name of the public DNS.
    publicIp String
    The public IP associated with the NIC.
    publicIpAccountId String
    The account ID of the owner of the public IP.
    publicIpId String
    The allocation ID of the public IP.

    NicSecurityGroup, NicSecurityGroupArgs

    SecurityGroupId string
    The ID of the security group.
    SecurityGroupName string
    The name of the security group.
    SecurityGroupId string
    The ID of the security group.
    SecurityGroupName string
    The name of the security group.
    securityGroupId String
    The ID of the security group.
    securityGroupName String
    The name of the security group.
    securityGroupId string
    The ID of the security group.
    securityGroupName string
    The name of the security group.
    security_group_id str
    The ID of the security group.
    security_group_name str
    The name of the security group.
    securityGroupId String
    The ID of the security group.
    securityGroupName String
    The name of the security group.

    NicTag, NicTagArgs

    Key string
    The key of the tag, with a minimum of 1 character.
    Value string
    The value of the tag, between 0 and 255 characters.
    Key string
    The key of the tag, with a minimum of 1 character.
    Value string
    The value of the tag, between 0 and 255 characters.
    key String
    The key of the tag, with a minimum of 1 character.
    value String
    The value of the tag, between 0 and 255 characters.
    key string
    The key of the tag, with a minimum of 1 character.
    value string
    The value of the tag, between 0 and 255 characters.
    key str
    The key of the tag, with a minimum of 1 character.
    value str
    The value of the tag, between 0 and 255 characters.
    key String
    The key of the tag, with a minimum of 1 character.
    value String
    The value of the tag, between 0 and 255 characters.

    NicTimeouts, NicTimeoutsArgs

    Create string
    Delete string
    Create string
    Delete string
    create String
    delete String
    create string
    delete string
    create str
    delete str
    create String
    delete String

    Import

    A NIC can be imported using its ID. For example:

    console

    $ pulumi import outscale:index/nic:Nic ImportedNic eni-12345678

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

    Package Details

    Repository
    outscale outscale/terraform-provider-outscale
    License
    Notes
    This Pulumi package is based on the outscale Terraform Provider.
    outscale logo
    outscale 1.0.1 published on Thursday, Mar 13, 2025 by outscale
    outscale/terraform-provider-outscale