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

outscale.getNics

Explore with Pulumi AI

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

    Provides information about network interface cards (NICs).

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

    Example Usage

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

const nics01 = outscale.getNics({
    filters: [
        {
            name: "nic_ids",
            values: [
                "eni-12345678",
                "eni-87654321",
            ],
        },
        {
            name: "link_nic_vm_ids",
            values: ["i-12345678"],
        },
    ],
});

    import pulumi
import pulumi_outscale as outscale

nics01 = outscale.get_nics(filters=[
    {
        "name": "nic_ids",
        "values": [
            "eni-12345678",
            "eni-87654321",
        ],
    },
    {
        "name": "link_nic_vm_ids",
        "values": ["i-12345678"],
    },
])

    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.GetNics(ctx, &outscale.GetNicsArgs{
			Filters: []outscale.GetNicsFilter{
				{
					Name: "nic_ids",
					Values: []string{
						"eni-12345678",
						"eni-87654321",
					},
				},
				{
					Name: "link_nic_vm_ids",
					Values: []string{
						"i-12345678",
					},
				},
			},
		}, nil)
		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 nics01 = Outscale.GetNics.Invoke(new()
    {
        Filters = new[]
        {
            new Outscale.Inputs.GetNicsFilterInputArgs
            {
                Name = "nic_ids",
                Values = new[]
                {
                    "eni-12345678",
                    "eni-87654321",
                },
            },
            new Outscale.Inputs.GetNicsFilterInputArgs
            {
                Name = "link_nic_vm_ids",
                Values = new[]
                {
                    "i-12345678",
                },
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.outscale.OutscaleFunctions;
import com.pulumi.outscale.inputs.GetNicsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var nics01 = OutscaleFunctions.getNics(GetNicsArgs.builder()
            .filters(            
                GetNicsFilterArgs.builder()
                    .name("nic_ids")
                    .values(                    
                        "eni-12345678",
                        "eni-87654321")
                    .build(),
                GetNicsFilterArgs.builder()
                    .name("link_nic_vm_ids")
                    .values("i-12345678")
                    .build())
            .build());

    }
}

    variables:
  nics01:
    fn::invoke:
      function: outscale:getNics
      arguments:
        filters:
          - name: nic_ids
            values:
              - eni-12345678
              - eni-87654321
          - name: link_nic_vm_ids
            values:
              - i-12345678

    Using getNics

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getNics(args: GetNicsArgs, opts?: InvokeOptions): Promise<GetNicsResult>
function getNicsOutput(args: GetNicsOutputArgs, opts?: InvokeOptions): Output<GetNicsResult>
    def get_nics(filters: Optional[Sequence[GetNicsFilter]] = None,
             id: Optional[str] = None,
             opts: Optional[InvokeOptions] = None) -> GetNicsResult
def get_nics_output(filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetNicsFilterArgs]]]] = None,
             id: Optional[pulumi.Input[str]] = None,
             opts: Optional[InvokeOptions] = None) -> Output[GetNicsResult]
    func GetNics(ctx *Context, args *GetNicsArgs, opts ...InvokeOption) (*GetNicsResult, error)
func GetNicsOutput(ctx *Context, args *GetNicsOutputArgs, opts ...InvokeOption) GetNicsResultOutput

    > Note: This function is named GetNics in the Go SDK.

    public static class GetNics 
{
    public static Task<GetNicsResult> InvokeAsync(GetNicsArgs args, InvokeOptions? opts = null)
    public static Output<GetNicsResult> Invoke(GetNicsInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetNicsResult> getNics(GetNicsArgs args, InvokeOptions options)
public static Output<GetNicsResult> getNics(GetNicsArgs args, InvokeOptions options)

    fn::invoke:
  function: outscale:index/getNics:getNics
  arguments:
    # arguments dictionary

    The following arguments are supported:

    Filters List<GetNicsFilter>
    A combination of a filter name and one or more filter values. You can specify this argument for as many filter names as you need. The filter name can be any of the following:
    Id string
    Filters []GetNicsFilter
    A combination of a filter name and one or more filter values. You can specify this argument for as many filter names as you need. The filter name can be any of the following:
    Id string
    filters List<GetNicsFilter>
    A combination of a filter name and one or more filter values. You can specify this argument for as many filter names as you need. The filter name can be any of the following:
    id String
    filters GetNicsFilter[]
    A combination of a filter name and one or more filter values. You can specify this argument for as many filter names as you need. The filter name can be any of the following:
    id string
    filters Sequence[GetNicsFilter]
    A combination of a filter name and one or more filter values. You can specify this argument for as many filter names as you need. The filter name can be any of the following:
    id str
    filters List<Property Map>
    A combination of a filter name and one or more filter values. You can specify this argument for as many filter names as you need. The filter name can be any of the following:
    id String

    getNics Result

    The following output properties are available:

    Id string
    Nics List<GetNicsNic>
    Information about one or more NICs.
    RequestId string
    Filters List<GetNicsFilter>
    Id string
    Nics []GetNicsNic
    Information about one or more NICs.
    RequestId string
    Filters []GetNicsFilter
    id String
    nics List<GetNicsNic>
    Information about one or more NICs.
    requestId String
    filters List<GetNicsFilter>
    id string
    nics GetNicsNic[]
    Information about one or more NICs.
    requestId string
    filters GetNicsFilter[]
    id str
    nics Sequence[GetNicsNic]
    Information about one or more NICs.
    request_id str
    filters Sequence[GetNicsFilter]
    id String
    nics List<Property Map>
    Information about one or more NICs.
    requestId String
    filters List<Property Map>

    Supporting Types

    GetNicsFilter

    Name string
    Values List<string>
    Name string
    Values []string
    name String
    values List<String>
    name string
    values string[]
    name str
    values Sequence[str]
    name String
    values List<String>

    GetNicsNic

    AccountId string
    The account ID of the owner of the NIC.
    Description string
    The description of the NIC.
    IsSourceDestChecked bool
    (Net only) If true, the source/destination check is enabled. If false, it is disabled.
    LinkNics List<GetNicsNicLinkNic>
    Information about the NIC attachment.
    LinkPublicIps List<GetNicsNicLinkPublicIp>
    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.
    PrivateIps List<GetNicsNicPrivateIp>
    The private IPs of the NIC.
    SecurityGroups List<GetNicsNicSecurityGroup>
    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.
    SubregionName string
    The Subregion in which the NIC is located.
    Tags List<GetNicsNicTag>
    One or more tags associated with the NIC.
    AccountId string
    The account ID of the owner of the NIC.
    Description string
    The description of the NIC.
    IsSourceDestChecked bool
    (Net only) If true, the source/destination check is enabled. If false, it is disabled.
    LinkNics []GetNicsNicLinkNic
    Information about the NIC attachment.
    LinkPublicIps []GetNicsNicLinkPublicIp
    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.
    PrivateIps []GetNicsNicPrivateIp
    The private IPs of the NIC.
    SecurityGroups []GetNicsNicSecurityGroup
    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.
    SubregionName string
    The Subregion in which the NIC is located.
    Tags []GetNicsNicTag
    One or more tags associated with the NIC.
    accountId String
    The account ID of the owner of the NIC.
    description String
    The description of the NIC.
    isSourceDestChecked Boolean
    (Net only) If true, the source/destination check is enabled. If false, it is disabled.
    linkNics List<GetNicsNicLinkNic>
    Information about the NIC attachment.
    linkPublicIps List<GetNicsNicLinkPublicIp>
    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.
    privateIps List<GetNicsNicPrivateIp>
    The private IPs of the NIC.
    securityGroups List<GetNicsNicSecurityGroup>
    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.
    subregionName String
    The Subregion in which the NIC is located.
    tags List<GetNicsNicTag>
    One or more tags associated with the NIC.
    accountId string
    The account ID of the owner of the NIC.
    description string
    The description of the NIC.
    isSourceDestChecked boolean
    (Net only) If true, the source/destination check is enabled. If false, it is disabled.
    linkNics GetNicsNicLinkNic[]
    Information about the NIC attachment.
    linkPublicIps GetNicsNicLinkPublicIp[]
    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.
    privateIps GetNicsNicPrivateIp[]
    The private IPs of the NIC.
    securityGroups GetNicsNicSecurityGroup[]
    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.
    subregionName string
    The Subregion in which the NIC is located.
    tags GetNicsNicTag[]
    One or more tags associated with the NIC.
    account_id str
    The account ID of the owner of the NIC.
    description str
    The description of 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[GetNicsNicLinkNic]
    Information about the NIC attachment.
    link_public_ips Sequence[GetNicsNicLinkPublicIp]
    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.
    private_ips Sequence[GetNicsNicPrivateIp]
    The private IPs of the NIC.
    security_groups Sequence[GetNicsNicSecurityGroup]
    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.
    subregion_name str
    The Subregion in which the NIC is located.
    tags Sequence[GetNicsNicTag]
    One or more tags associated with the NIC.
    accountId String
    The account ID of the owner of the NIC.
    description String
    The description of 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.
    privateDnsName String
    The name of the private DNS.
    privateIps List<Property Map>
    The private IPs of 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.
    subregionName String
    The Subregion in which the NIC is located.
    tags List<Property Map>
    One or more tags associated with the NIC.

    GetNicsNicLinkNic

    DeleteOnVmDeletion bool
    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 bool
    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 Boolean
    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 boolean
    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 bool
    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 Boolean
    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.

    GetNicsNicLinkPublicIp

    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.

    GetNicsNicPrivateIp

    IsPrimary bool
    If true, the IP is the primary private IP of the NIC.
    LinkPublicIps List<GetNicsNicPrivateIpLinkPublicIp>
    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 []GetNicsNicPrivateIpLinkPublicIp
    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<GetNicsNicPrivateIpLinkPublicIp>
    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 GetNicsNicPrivateIpLinkPublicIp[]
    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[GetNicsNicPrivateIpLinkPublicIp]
    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.

    GetNicsNicPrivateIpLinkPublicIp

    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.

    GetNicsNicSecurityGroup

    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.

    GetNicsNicTag

    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.

    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