outscale 1.1.0, Apr 3 25

outscale 1.1.0 published on Thursday, Apr 3, 2025 by outscale

outscale.Nic

Explore with Pulumi AI

outscale 1.1.0 published on Thursday, Apr 3, 2025 by outscale

Example Usage

Required resources

TypeScript
Python
Go
C#
Java
YAML

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

TypeScript
Python
Go
C#
Java
YAML

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

TypeScript
Python
Go
C#
Java
YAML

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.

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.

TypeScript
Python
Go
C#
Java
YAML

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",
        Read = "string",
        Update = "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"),
Read: pulumi.String("string"),
Update: 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")
        .read("string")
        .update("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",
        "read": "string",
        "update": "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",
        read: "string",
        update: "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
        read: string
        update: 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.

TypeScript
Python
Go
C#
Java
YAML

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
Read string
Update string

Create string
Delete string
Read string
Update string

create String
delete String
read String
update String

create string
delete string
read string
update string

create str
delete str
read str
update str

create String
delete String
read String
update 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 1.1.0 published on Thursday, Apr 3, 2025 by outscale

outscale/terraform-provider-outscale

outscale.Nic

On this page

On this page

Example Usage

Required resources

Create a NIC

Create a NIC with private IP addresses

Create Nic Resource

Constructor syntax

Parameters

Constructor example

Nic Resource Properties

Inputs

Outputs

Look up Existing Nic Resource

Supporting Types

NicLinkNic
, NicLinkNicArgs

NicLinkPublicIp
, NicLinkPublicIpArgs

NicPrivateIp
, NicPrivateIpArgs

NicPrivateIpLinkPublicIp
, NicPrivateIpLinkPublicIpArgs

NicSecurityGroup
, NicSecurityGroupArgs

NicTag
, NicTagArgs

NicTimeouts
, NicTimeoutsArgs

Import

Package Details

On this page

On this page

outscale.Nic

On this page

On this page

Example Usage

Required resources

Create a NIC

Create a NIC with private IP addresses

Create Nic Resource

Constructor syntax

Parameters

Constructor example

Nic Resource Properties

Inputs

Outputs

Look up Existing Nic Resource

Supporting Types

NicLinkNic, NicLinkNicArgs

NicLinkPublicIp, NicLinkPublicIpArgs

NicPrivateIp, NicPrivateIpArgs

NicPrivateIpLinkPublicIp, NicPrivateIpLinkPublicIpArgs

NicSecurityGroup, NicSecurityGroupArgs

NicTag, NicTagArgs

NicTimeouts, NicTimeoutsArgs

Import

Package Details

On this page

On this page

NicLinkNic
, NicLinkNicArgs

NicLinkPublicIp
, NicLinkPublicIpArgs

NicPrivateIp
, NicPrivateIpArgs

NicPrivateIpLinkPublicIp
, NicPrivateIpLinkPublicIpArgs

NicSecurityGroup
, NicSecurityGroupArgs

NicTag
, NicTagArgs

NicTimeouts
, NicTimeoutsArgs