1. Packages
  2. Ibm Provider
  3. API Docs
  4. getIsInstanceNetworkInterface
ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud

ibm.getIsInstanceNetworkInterface

Explore with Pulumi AI

ibm logo
ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud

    Retrieve information of an exisitng network interface. For more information, about instance network interface, see managing an network interfaces.

    Note: VPC infrastructure services are a regional specific based endpoint, by default targets to us-south. Please make sure to target right region in the provider block as shown in the provider.tf file, if VPC service is created in region other than us-south.

    provider.tf

    import * as pulumi from "@pulumi/pulumi";
    
    import pulumi
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    
    return await Deployment.RunAsync(() => 
    {
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    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) {
        }
    }
    
    {}
    

    Using getIsInstanceNetworkInterface

    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 getIsInstanceNetworkInterface(args: GetIsInstanceNetworkInterfaceArgs, opts?: InvokeOptions): Promise<GetIsInstanceNetworkInterfaceResult>
    function getIsInstanceNetworkInterfaceOutput(args: GetIsInstanceNetworkInterfaceOutputArgs, opts?: InvokeOptions): Output<GetIsInstanceNetworkInterfaceResult>
    def get_is_instance_network_interface(id: Optional[str] = None,
                                          instance_name: Optional[str] = None,
                                          network_interface_name: Optional[str] = None,
                                          opts: Optional[InvokeOptions] = None) -> GetIsInstanceNetworkInterfaceResult
    def get_is_instance_network_interface_output(id: Optional[pulumi.Input[str]] = None,
                                          instance_name: Optional[pulumi.Input[str]] = None,
                                          network_interface_name: Optional[pulumi.Input[str]] = None,
                                          opts: Optional[InvokeOptions] = None) -> Output[GetIsInstanceNetworkInterfaceResult]
    func LookupIsInstanceNetworkInterface(ctx *Context, args *LookupIsInstanceNetworkInterfaceArgs, opts ...InvokeOption) (*LookupIsInstanceNetworkInterfaceResult, error)
    func LookupIsInstanceNetworkInterfaceOutput(ctx *Context, args *LookupIsInstanceNetworkInterfaceOutputArgs, opts ...InvokeOption) LookupIsInstanceNetworkInterfaceResultOutput

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

    public static class GetIsInstanceNetworkInterface 
    {
        public static Task<GetIsInstanceNetworkInterfaceResult> InvokeAsync(GetIsInstanceNetworkInterfaceArgs args, InvokeOptions? opts = null)
        public static Output<GetIsInstanceNetworkInterfaceResult> Invoke(GetIsInstanceNetworkInterfaceInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetIsInstanceNetworkInterfaceResult> getIsInstanceNetworkInterface(GetIsInstanceNetworkInterfaceArgs args, InvokeOptions options)
    public static Output<GetIsInstanceNetworkInterfaceResult> getIsInstanceNetworkInterface(GetIsInstanceNetworkInterfaceArgs args, InvokeOptions options)
    
    fn::invoke:
      function: ibm:index/getIsInstanceNetworkInterface:getIsInstanceNetworkInterface
      arguments:
        # arguments dictionary

    The following arguments are supported:

    InstanceName string
    The name of the instance.
    NetworkInterfaceName string
    The name of the network interface.
    Id string
    (String) The unique identifier for this subnet.
    InstanceName string
    The name of the instance.
    NetworkInterfaceName string
    The name of the network interface.
    Id string
    (String) The unique identifier for this subnet.
    instanceName String
    The name of the instance.
    networkInterfaceName String
    The name of the network interface.
    id String
    (String) The unique identifier for this subnet.
    instanceName string
    The name of the instance.
    networkInterfaceName string
    The name of the network interface.
    id string
    (String) The unique identifier for this subnet.
    instance_name str
    The name of the instance.
    network_interface_name str
    The name of the network interface.
    id str
    (String) The unique identifier for this subnet.
    instanceName String
    The name of the instance.
    networkInterfaceName String
    The name of the network interface.
    id String
    (String) The unique identifier for this subnet.

    getIsInstanceNetworkInterface Result

    The following output properties are available:

    AllowIpSpoofing bool
    (Boolean) Indicates whether source IP spoofing is allowed on this interface. If false, source IP spoofing is prevented on this interface. If true, source IP spoofing is allowed on this interface.
    CreatedAt string
    (String) The date and time that the network interface was created.
    FloatingIps List<GetIsInstanceNetworkInterfaceFloatingIp>
    (List) The floating IPs associated with this network interface. Nested floating_ips blocks have the following structure:
    Href string
    (String) The URL for this subnet.
    Id string
    (String) The unique identifier for this subnet.
    InstanceName string
    Name string
    (String) The user-defined name for this subnet.
    NetworkInterfaceName string
    PortSpeed double
    (Integer) The network interface port speed in Mbps.
    PrimaryIps List<GetIsInstanceNetworkInterfacePrimaryIp>
    (List) The primary IP address to bind to the network interface. This can be specified using an existing reserved IP, or a prototype object for a new reserved IP.
    PrimaryIpv4Address string
    (String) The primary IPv4 address. Same as primary_ip.0.address
    ResourceType string
    (String) The resource type.
    SecurityGroups List<GetIsInstanceNetworkInterfaceSecurityGroup>
    (List) Collection of security groups. Nested security_groups blocks have the following structure:
    Status string
    (String) The status of the network interface.
    Subnets List<GetIsInstanceNetworkInterfaceSubnet>
    (List) The associated subnet. Nested subnet blocks have the following structure:
    Type string
    (String) The type of this network interface as it relates to an instance.
    AllowIpSpoofing bool
    (Boolean) Indicates whether source IP spoofing is allowed on this interface. If false, source IP spoofing is prevented on this interface. If true, source IP spoofing is allowed on this interface.
    CreatedAt string
    (String) The date and time that the network interface was created.
    FloatingIps []GetIsInstanceNetworkInterfaceFloatingIpType
    (List) The floating IPs associated with this network interface. Nested floating_ips blocks have the following structure:
    Href string
    (String) The URL for this subnet.
    Id string
    (String) The unique identifier for this subnet.
    InstanceName string
    Name string
    (String) The user-defined name for this subnet.
    NetworkInterfaceName string
    PortSpeed float64
    (Integer) The network interface port speed in Mbps.
    PrimaryIps []GetIsInstanceNetworkInterfacePrimaryIp
    (List) The primary IP address to bind to the network interface. This can be specified using an existing reserved IP, or a prototype object for a new reserved IP.
    PrimaryIpv4Address string
    (String) The primary IPv4 address. Same as primary_ip.0.address
    ResourceType string
    (String) The resource type.
    SecurityGroups []GetIsInstanceNetworkInterfaceSecurityGroup
    (List) Collection of security groups. Nested security_groups blocks have the following structure:
    Status string
    (String) The status of the network interface.
    Subnets []GetIsInstanceNetworkInterfaceSubnet
    (List) The associated subnet. Nested subnet blocks have the following structure:
    Type string
    (String) The type of this network interface as it relates to an instance.
    allowIpSpoofing Boolean
    (Boolean) Indicates whether source IP spoofing is allowed on this interface. If false, source IP spoofing is prevented on this interface. If true, source IP spoofing is allowed on this interface.
    createdAt String
    (String) The date and time that the network interface was created.
    floatingIps List<GetIsInstanceNetworkInterfaceFloatingIp>
    (List) The floating IPs associated with this network interface. Nested floating_ips blocks have the following structure:
    href String
    (String) The URL for this subnet.
    id String
    (String) The unique identifier for this subnet.
    instanceName String
    name String
    (String) The user-defined name for this subnet.
    networkInterfaceName String
    portSpeed Double
    (Integer) The network interface port speed in Mbps.
    primaryIps List<GetIsInstanceNetworkInterfacePrimaryIp>
    (List) The primary IP address to bind to the network interface. This can be specified using an existing reserved IP, or a prototype object for a new reserved IP.
    primaryIpv4Address String
    (String) The primary IPv4 address. Same as primary_ip.0.address
    resourceType String
    (String) The resource type.
    securityGroups List<GetIsInstanceNetworkInterfaceSecurityGroup>
    (List) Collection of security groups. Nested security_groups blocks have the following structure:
    status String
    (String) The status of the network interface.
    subnets List<GetIsInstanceNetworkInterfaceSubnet>
    (List) The associated subnet. Nested subnet blocks have the following structure:
    type String
    (String) The type of this network interface as it relates to an instance.
    allowIpSpoofing boolean
    (Boolean) Indicates whether source IP spoofing is allowed on this interface. If false, source IP spoofing is prevented on this interface. If true, source IP spoofing is allowed on this interface.
    createdAt string
    (String) The date and time that the network interface was created.
    floatingIps GetIsInstanceNetworkInterfaceFloatingIp[]
    (List) The floating IPs associated with this network interface. Nested floating_ips blocks have the following structure:
    href string
    (String) The URL for this subnet.
    id string
    (String) The unique identifier for this subnet.
    instanceName string
    name string
    (String) The user-defined name for this subnet.
    networkInterfaceName string
    portSpeed number
    (Integer) The network interface port speed in Mbps.
    primaryIps GetIsInstanceNetworkInterfacePrimaryIp[]
    (List) The primary IP address to bind to the network interface. This can be specified using an existing reserved IP, or a prototype object for a new reserved IP.
    primaryIpv4Address string
    (String) The primary IPv4 address. Same as primary_ip.0.address
    resourceType string
    (String) The resource type.
    securityGroups GetIsInstanceNetworkInterfaceSecurityGroup[]
    (List) Collection of security groups. Nested security_groups blocks have the following structure:
    status string
    (String) The status of the network interface.
    subnets GetIsInstanceNetworkInterfaceSubnet[]
    (List) The associated subnet. Nested subnet blocks have the following structure:
    type string
    (String) The type of this network interface as it relates to an instance.
    allow_ip_spoofing bool
    (Boolean) Indicates whether source IP spoofing is allowed on this interface. If false, source IP spoofing is prevented on this interface. If true, source IP spoofing is allowed on this interface.
    created_at str
    (String) The date and time that the network interface was created.
    floating_ips Sequence[GetIsInstanceNetworkInterfaceFloatingIp]
    (List) The floating IPs associated with this network interface. Nested floating_ips blocks have the following structure:
    href str
    (String) The URL for this subnet.
    id str
    (String) The unique identifier for this subnet.
    instance_name str
    name str
    (String) The user-defined name for this subnet.
    network_interface_name str
    port_speed float
    (Integer) The network interface port speed in Mbps.
    primary_ips Sequence[GetIsInstanceNetworkInterfacePrimaryIp]
    (List) The primary IP address to bind to the network interface. This can be specified using an existing reserved IP, or a prototype object for a new reserved IP.
    primary_ipv4_address str
    (String) The primary IPv4 address. Same as primary_ip.0.address
    resource_type str
    (String) The resource type.
    security_groups Sequence[GetIsInstanceNetworkInterfaceSecurityGroup]
    (List) Collection of security groups. Nested security_groups blocks have the following structure:
    status str
    (String) The status of the network interface.
    subnets Sequence[GetIsInstanceNetworkInterfaceSubnet]
    (List) The associated subnet. Nested subnet blocks have the following structure:
    type str
    (String) The type of this network interface as it relates to an instance.
    allowIpSpoofing Boolean
    (Boolean) Indicates whether source IP spoofing is allowed on this interface. If false, source IP spoofing is prevented on this interface. If true, source IP spoofing is allowed on this interface.
    createdAt String
    (String) The date and time that the network interface was created.
    floatingIps List<Property Map>
    (List) The floating IPs associated with this network interface. Nested floating_ips blocks have the following structure:
    href String
    (String) The URL for this subnet.
    id String
    (String) The unique identifier for this subnet.
    instanceName String
    name String
    (String) The user-defined name for this subnet.
    networkInterfaceName String
    portSpeed Number
    (Integer) The network interface port speed in Mbps.
    primaryIps List<Property Map>
    (List) The primary IP address to bind to the network interface. This can be specified using an existing reserved IP, or a prototype object for a new reserved IP.
    primaryIpv4Address String
    (String) The primary IPv4 address. Same as primary_ip.0.address
    resourceType String
    (String) The resource type.
    securityGroups List<Property Map>
    (List) Collection of security groups. Nested security_groups blocks have the following structure:
    status String
    (String) The status of the network interface.
    subnets List<Property Map>
    (List) The associated subnet. Nested subnet blocks have the following structure:
    type String
    (String) The type of this network interface as it relates to an instance.

    Supporting Types

    GetIsInstanceNetworkInterfaceFloatingIp

    Address string
    (String) The IP address of the reserved IP. Same as primary_ipv4_address
    Crn string
    (String) The CRN for this subnet.
    Deleteds List<GetIsInstanceNetworkInterfaceFloatingIpDeleted>
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    Href string
    (String) The URL for this subnet.
    Id string
    (String) The unique identifier for this subnet.
    Name string
    (String) The user-defined name for this subnet.
    Address string
    (String) The IP address of the reserved IP. Same as primary_ipv4_address
    Crn string
    (String) The CRN for this subnet.
    Deleteds []GetIsInstanceNetworkInterfaceFloatingIpDeleted
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    Href string
    (String) The URL for this subnet.
    Id string
    (String) The unique identifier for this subnet.
    Name string
    (String) The user-defined name for this subnet.
    address String
    (String) The IP address of the reserved IP. Same as primary_ipv4_address
    crn String
    (String) The CRN for this subnet.
    deleteds List<GetIsInstanceNetworkInterfaceFloatingIpDeleted>
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    href String
    (String) The URL for this subnet.
    id String
    (String) The unique identifier for this subnet.
    name String
    (String) The user-defined name for this subnet.
    address string
    (String) The IP address of the reserved IP. Same as primary_ipv4_address
    crn string
    (String) The CRN for this subnet.
    deleteds GetIsInstanceNetworkInterfaceFloatingIpDeleted[]
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    href string
    (String) The URL for this subnet.
    id string
    (String) The unique identifier for this subnet.
    name string
    (String) The user-defined name for this subnet.
    address str
    (String) The IP address of the reserved IP. Same as primary_ipv4_address
    crn str
    (String) The CRN for this subnet.
    deleteds Sequence[GetIsInstanceNetworkInterfaceFloatingIpDeleted]
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    href str
    (String) The URL for this subnet.
    id str
    (String) The unique identifier for this subnet.
    name str
    (String) The user-defined name for this subnet.
    address String
    (String) The IP address of the reserved IP. Same as primary_ipv4_address
    crn String
    (String) The CRN for this subnet.
    deleteds List<Property Map>
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    href String
    (String) The URL for this subnet.
    id String
    (String) The unique identifier for this subnet.
    name String
    (String) The user-defined name for this subnet.

    GetIsInstanceNetworkInterfaceFloatingIpDeleted

    MoreInfo string
    (String) Link to documentation about deleted resources.
    MoreInfo string
    (String) Link to documentation about deleted resources.
    moreInfo String
    (String) Link to documentation about deleted resources.
    moreInfo string
    (String) Link to documentation about deleted resources.
    more_info str
    (String) Link to documentation about deleted resources.
    moreInfo String
    (String) Link to documentation about deleted resources.

    GetIsInstanceNetworkInterfacePrimaryIp

    Address string
    (String) The IP address of the reserved IP. Same as primary_ipv4_address
    Href string
    (String) The URL for this subnet.
    Name string
    (String) The user-defined name for this subnet.
    ReservedIp string
    (String) The unique identifier for this reserved IP
    ResourceType string
    (String) The resource type.
    Address string
    (String) The IP address of the reserved IP. Same as primary_ipv4_address
    Href string
    (String) The URL for this subnet.
    Name string
    (String) The user-defined name for this subnet.
    ReservedIp string
    (String) The unique identifier for this reserved IP
    ResourceType string
    (String) The resource type.
    address String
    (String) The IP address of the reserved IP. Same as primary_ipv4_address
    href String
    (String) The URL for this subnet.
    name String
    (String) The user-defined name for this subnet.
    reservedIp String
    (String) The unique identifier for this reserved IP
    resourceType String
    (String) The resource type.
    address string
    (String) The IP address of the reserved IP. Same as primary_ipv4_address
    href string
    (String) The URL for this subnet.
    name string
    (String) The user-defined name for this subnet.
    reservedIp string
    (String) The unique identifier for this reserved IP
    resourceType string
    (String) The resource type.
    address str
    (String) The IP address of the reserved IP. Same as primary_ipv4_address
    href str
    (String) The URL for this subnet.
    name str
    (String) The user-defined name for this subnet.
    reserved_ip str
    (String) The unique identifier for this reserved IP
    resource_type str
    (String) The resource type.
    address String
    (String) The IP address of the reserved IP. Same as primary_ipv4_address
    href String
    (String) The URL for this subnet.
    name String
    (String) The user-defined name for this subnet.
    reservedIp String
    (String) The unique identifier for this reserved IP
    resourceType String
    (String) The resource type.

    GetIsInstanceNetworkInterfaceSecurityGroup

    Crn string
    (String) The CRN for this subnet.
    Deleteds List<GetIsInstanceNetworkInterfaceSecurityGroupDeleted>
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    Href string
    (String) The URL for this subnet.
    Id string
    (String) The unique identifier for this subnet.
    Name string
    (String) The user-defined name for this subnet.
    Crn string
    (String) The CRN for this subnet.
    Deleteds []GetIsInstanceNetworkInterfaceSecurityGroupDeleted
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    Href string
    (String) The URL for this subnet.
    Id string
    (String) The unique identifier for this subnet.
    Name string
    (String) The user-defined name for this subnet.
    crn String
    (String) The CRN for this subnet.
    deleteds List<GetIsInstanceNetworkInterfaceSecurityGroupDeleted>
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    href String
    (String) The URL for this subnet.
    id String
    (String) The unique identifier for this subnet.
    name String
    (String) The user-defined name for this subnet.
    crn string
    (String) The CRN for this subnet.
    deleteds GetIsInstanceNetworkInterfaceSecurityGroupDeleted[]
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    href string
    (String) The URL for this subnet.
    id string
    (String) The unique identifier for this subnet.
    name string
    (String) The user-defined name for this subnet.
    crn str
    (String) The CRN for this subnet.
    deleteds Sequence[GetIsInstanceNetworkInterfaceSecurityGroupDeleted]
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    href str
    (String) The URL for this subnet.
    id str
    (String) The unique identifier for this subnet.
    name str
    (String) The user-defined name for this subnet.
    crn String
    (String) The CRN for this subnet.
    deleteds List<Property Map>
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    href String
    (String) The URL for this subnet.
    id String
    (String) The unique identifier for this subnet.
    name String
    (String) The user-defined name for this subnet.

    GetIsInstanceNetworkInterfaceSecurityGroupDeleted

    MoreInfo string
    (String) Link to documentation about deleted resources.
    MoreInfo string
    (String) Link to documentation about deleted resources.
    moreInfo String
    (String) Link to documentation about deleted resources.
    moreInfo string
    (String) Link to documentation about deleted resources.
    more_info str
    (String) Link to documentation about deleted resources.
    moreInfo String
    (String) Link to documentation about deleted resources.

    GetIsInstanceNetworkInterfaceSubnet

    Crn string
    (String) The CRN for this subnet.
    Deleteds List<GetIsInstanceNetworkInterfaceSubnetDeleted>
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    Href string
    (String) The URL for this subnet.
    Id string
    (String) The unique identifier for this subnet.
    Name string
    (String) The user-defined name for this subnet.
    Crn string
    (String) The CRN for this subnet.
    Deleteds []GetIsInstanceNetworkInterfaceSubnetDeleted
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    Href string
    (String) The URL for this subnet.
    Id string
    (String) The unique identifier for this subnet.
    Name string
    (String) The user-defined name for this subnet.
    crn String
    (String) The CRN for this subnet.
    deleteds List<GetIsInstanceNetworkInterfaceSubnetDeleted>
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    href String
    (String) The URL for this subnet.
    id String
    (String) The unique identifier for this subnet.
    name String
    (String) The user-defined name for this subnet.
    crn string
    (String) The CRN for this subnet.
    deleteds GetIsInstanceNetworkInterfaceSubnetDeleted[]
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    href string
    (String) The URL for this subnet.
    id string
    (String) The unique identifier for this subnet.
    name string
    (String) The user-defined name for this subnet.
    crn str
    (String) The CRN for this subnet.
    deleteds Sequence[GetIsInstanceNetworkInterfaceSubnetDeleted]
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    href str
    (String) The URL for this subnet.
    id str
    (String) The unique identifier for this subnet.
    name str
    (String) The user-defined name for this subnet.
    crn String
    (String) The CRN for this subnet.
    deleteds List<Property Map>
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested deleted blocks have the following structure:
    href String
    (String) The URL for this subnet.
    id String
    (String) The unique identifier for this subnet.
    name String
    (String) The user-defined name for this subnet.

    GetIsInstanceNetworkInterfaceSubnetDeleted

    MoreInfo string
    (String) Link to documentation about deleted resources.
    MoreInfo string
    (String) Link to documentation about deleted resources.
    moreInfo String
    (String) Link to documentation about deleted resources.
    moreInfo string
    (String) Link to documentation about deleted resources.
    more_info str
    (String) Link to documentation about deleted resources.
    moreInfo String
    (String) Link to documentation about deleted resources.

    Package Details

    Repository
    ibm ibm-cloud/terraform-provider-ibm
    License
    Notes
    This Pulumi package is based on the ibm Terraform Provider.
    ibm logo
    ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud