1. Packages
  2. Ibm Provider
  3. API Docs
  4. IsInstanceNetworkAttachment
ibm 1.80.0-beta0 published on Tuesday, Jun 24, 2025 by ibm-cloud

ibm.IsInstanceNetworkAttachment

Explore with Pulumi AI

ibm logo
ibm 1.80.0-beta0 published on Tuesday, Jun 24, 2025 by ibm-cloud

    Create, update, and delete Instance Network Attachment with this resource. Instance network attachments allow you to create and manage additional virtual network interfaces to your compute instances using virtual service instance network attachment.

    Example Usage

    Basic usage with existing virtual network interface

    import * as pulumi from "@pulumi/pulumi";
    import * as ibm from "@pulumi/ibm";
    
    const example = new ibm.IsInstanceNetworkAttachment("example", {
        instance: ibm_is_instance.example.id,
        virtualNetworkInterface: {
            id: ibm_is_virtual_network_interface.example.id,
        },
    });
    
    import pulumi
    import pulumi_ibm as ibm
    
    example = ibm.IsInstanceNetworkAttachment("example",
        instance=ibm_is_instance["example"]["id"],
        virtual_network_interface={
            "id": ibm_is_virtual_network_interface["example"]["id"],
        })
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ibm.NewIsInstanceNetworkAttachment(ctx, "example", &ibm.IsInstanceNetworkAttachmentArgs{
    			Instance: pulumi.Any(ibm_is_instance.Example.Id),
    			VirtualNetworkInterface: &ibm.IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs{
    				Id: pulumi.Any(ibm_is_virtual_network_interface.Example.Id),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ibm = Pulumi.Ibm;
    
    return await Deployment.RunAsync(() => 
    {
        var example = new Ibm.IsInstanceNetworkAttachment("example", new()
        {
            Instance = ibm_is_instance.Example.Id,
            VirtualNetworkInterface = new Ibm.Inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs
            {
                Id = ibm_is_virtual_network_interface.Example.Id,
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ibm.IsInstanceNetworkAttachment;
    import com.pulumi.ibm.IsInstanceNetworkAttachmentArgs;
    import com.pulumi.ibm.inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs;
    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 example = new IsInstanceNetworkAttachment("example", IsInstanceNetworkAttachmentArgs.builder()
                .instance(ibm_is_instance.example().id())
                .virtualNetworkInterface(IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs.builder()
                    .id(ibm_is_virtual_network_interface.example().id())
                    .build())
                .build());
    
        }
    }
    
    resources:
      example:
        type: ibm:IsInstanceNetworkAttachment
        properties:
          instance: ${ibm_is_instance.example.id}
          virtualNetworkInterface:
            id: ${ibm_is_virtual_network_interface.example.id}
    

    Inline virtual network interface with auto-assigned IP

    import * as pulumi from "@pulumi/pulumi";
    import * as ibm from "@pulumi/ibm";
    
    const example2 = new ibm.IsInstanceNetworkAttachment("example2", {
        instance: ibm_is_instance.example.id,
        virtualNetworkInterface: {
            name: "example-vni-2",
            subnet: ibm_is_subnet.example.id,
            autoDelete: true,
            allowIpSpoofing: false,
            enableInfrastructureNat: true,
            securityGroups: [ibm_is_security_group.example.id],
        },
    });
    
    import pulumi
    import pulumi_ibm as ibm
    
    example2 = ibm.IsInstanceNetworkAttachment("example2",
        instance=ibm_is_instance["example"]["id"],
        virtual_network_interface={
            "name": "example-vni-2",
            "subnet": ibm_is_subnet["example"]["id"],
            "auto_delete": True,
            "allow_ip_spoofing": False,
            "enable_infrastructure_nat": True,
            "security_groups": [ibm_is_security_group["example"]["id"]],
        })
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ibm.NewIsInstanceNetworkAttachment(ctx, "example2", &ibm.IsInstanceNetworkAttachmentArgs{
    			Instance: pulumi.Any(ibm_is_instance.Example.Id),
    			VirtualNetworkInterface: &ibm.IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs{
    				Name:                    pulumi.String("example-vni-2"),
    				Subnet:                  pulumi.Any(ibm_is_subnet.Example.Id),
    				AutoDelete:              pulumi.Bool(true),
    				AllowIpSpoofing:         pulumi.Bool(false),
    				EnableInfrastructureNat: pulumi.Bool(true),
    				SecurityGroups: pulumi.StringArray{
    					ibm_is_security_group.Example.Id,
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ibm = Pulumi.Ibm;
    
    return await Deployment.RunAsync(() => 
    {
        var example2 = new Ibm.IsInstanceNetworkAttachment("example2", new()
        {
            Instance = ibm_is_instance.Example.Id,
            VirtualNetworkInterface = new Ibm.Inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs
            {
                Name = "example-vni-2",
                Subnet = ibm_is_subnet.Example.Id,
                AutoDelete = true,
                AllowIpSpoofing = false,
                EnableInfrastructureNat = true,
                SecurityGroups = new[]
                {
                    ibm_is_security_group.Example.Id,
                },
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ibm.IsInstanceNetworkAttachment;
    import com.pulumi.ibm.IsInstanceNetworkAttachmentArgs;
    import com.pulumi.ibm.inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs;
    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 example2 = new IsInstanceNetworkAttachment("example2", IsInstanceNetworkAttachmentArgs.builder()
                .instance(ibm_is_instance.example().id())
                .virtualNetworkInterface(IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs.builder()
                    .name("example-vni-2")
                    .subnet(ibm_is_subnet.example().id())
                    .autoDelete(true)
                    .allowIpSpoofing(false)
                    .enableInfrastructureNat(true)
                    .securityGroups(ibm_is_security_group.example().id())
                    .build())
                .build());
    
        }
    }
    
    resources:
      example2:
        type: ibm:IsInstanceNetworkAttachment
        properties:
          instance: ${ibm_is_instance.example.id}
          virtualNetworkInterface:
            name: example-vni-2
            subnet: ${ibm_is_subnet.example.id}
            autoDelete: true
            allowIpSpoofing: false
            enableInfrastructureNat: true
            securityGroups:
              - ${ibm_is_security_group.example.id}
    

    Inline virtual network interface with specific primary IP address

    import * as pulumi from "@pulumi/pulumi";
    import * as ibm from "@pulumi/ibm";
    
    const example3 = new ibm.IsInstanceNetworkAttachment("example3", {
        instance: ibm_is_instance.example.id,
        virtualNetworkInterface: {
            name: "example-vni-3",
            subnet: ibm_is_subnet.example.id,
            autoDelete: true,
            allowIpSpoofing: false,
            enableInfrastructureNat: true,
            primaryIp: {
                address: "10.240.64.100",
                autoDelete: true,
                name: "example-primary-ip-1",
            },
        },
    });
    
    import pulumi
    import pulumi_ibm as ibm
    
    example3 = ibm.IsInstanceNetworkAttachment("example3",
        instance=ibm_is_instance["example"]["id"],
        virtual_network_interface={
            "name": "example-vni-3",
            "subnet": ibm_is_subnet["example"]["id"],
            "auto_delete": True,
            "allow_ip_spoofing": False,
            "enable_infrastructure_nat": True,
            "primary_ip": {
                "address": "10.240.64.100",
                "auto_delete": True,
                "name": "example-primary-ip-1",
            },
        })
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ibm.NewIsInstanceNetworkAttachment(ctx, "example3", &ibm.IsInstanceNetworkAttachmentArgs{
    			Instance: pulumi.Any(ibm_is_instance.Example.Id),
    			VirtualNetworkInterface: &ibm.IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs{
    				Name:                    pulumi.String("example-vni-3"),
    				Subnet:                  pulumi.Any(ibm_is_subnet.Example.Id),
    				AutoDelete:              pulumi.Bool(true),
    				AllowIpSpoofing:         pulumi.Bool(false),
    				EnableInfrastructureNat: pulumi.Bool(true),
    				PrimaryIp: &ibm.IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpArgs{
    					Address:    pulumi.String("10.240.64.100"),
    					AutoDelete: pulumi.Bool(true),
    					Name:       pulumi.String("example-primary-ip-1"),
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ibm = Pulumi.Ibm;
    
    return await Deployment.RunAsync(() => 
    {
        var example3 = new Ibm.IsInstanceNetworkAttachment("example3", new()
        {
            Instance = ibm_is_instance.Example.Id,
            VirtualNetworkInterface = new Ibm.Inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs
            {
                Name = "example-vni-3",
                Subnet = ibm_is_subnet.Example.Id,
                AutoDelete = true,
                AllowIpSpoofing = false,
                EnableInfrastructureNat = true,
                PrimaryIp = new Ibm.Inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpArgs
                {
                    Address = "10.240.64.100",
                    AutoDelete = true,
                    Name = "example-primary-ip-1",
                },
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ibm.IsInstanceNetworkAttachment;
    import com.pulumi.ibm.IsInstanceNetworkAttachmentArgs;
    import com.pulumi.ibm.inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs;
    import com.pulumi.ibm.inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpArgs;
    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 example3 = new IsInstanceNetworkAttachment("example3", IsInstanceNetworkAttachmentArgs.builder()
                .instance(ibm_is_instance.example().id())
                .virtualNetworkInterface(IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs.builder()
                    .name("example-vni-3")
                    .subnet(ibm_is_subnet.example().id())
                    .autoDelete(true)
                    .allowIpSpoofing(false)
                    .enableInfrastructureNat(true)
                    .primaryIp(IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpArgs.builder()
                        .address("10.240.64.100")
                        .autoDelete(true)
                        .name("example-primary-ip-1")
                        .build())
                    .build())
                .build());
    
        }
    }
    
    resources:
      example3:
        type: ibm:IsInstanceNetworkAttachment
        properties:
          instance: ${ibm_is_instance.example.id}
          virtualNetworkInterface:
            name: example-vni-3
            subnet: ${ibm_is_subnet.example.id}
            autoDelete: true
            allowIpSpoofing: false
            enableInfrastructureNat: true
            primaryIp:
              address: 10.240.64.100
              autoDelete: true
              name: example-primary-ip-1
    

    Advanced configuration with reserved IPs

    import * as pulumi from "@pulumi/pulumi";
    import * as ibm from "@pulumi/ibm";
    
    const examplePrimary = new ibm.IsSubnetReservedIp("examplePrimary", {
        subnet: ibm_is_subnet.example.id,
        address: "10.240.65.50",
    });
    const exampleAdditional = new ibm.IsSubnetReservedIp("exampleAdditional", {
        subnet: ibm_is_subnet.example.id,
        address: "10.240.65.51",
    });
    const example4 = new ibm.IsInstanceNetworkAttachment("example4", {
        instance: ibm_is_instance.example.id,
        virtualNetworkInterface: {
            name: "example-vni-5",
            subnet: ibm_is_subnet.example.id,
            autoDelete: true,
            allowIpSpoofing: false,
            enableInfrastructureNat: true,
            primaryIp: {
                reservedIp: examplePrimary.reservedIp,
            },
            ips: [{
                reservedIp: exampleAdditional.reservedIp,
            }],
        },
    });
    
    import pulumi
    import pulumi_ibm as ibm
    
    example_primary = ibm.IsSubnetReservedIp("examplePrimary",
        subnet=ibm_is_subnet["example"]["id"],
        address="10.240.65.50")
    example_additional = ibm.IsSubnetReservedIp("exampleAdditional",
        subnet=ibm_is_subnet["example"]["id"],
        address="10.240.65.51")
    example4 = ibm.IsInstanceNetworkAttachment("example4",
        instance=ibm_is_instance["example"]["id"],
        virtual_network_interface={
            "name": "example-vni-5",
            "subnet": ibm_is_subnet["example"]["id"],
            "auto_delete": True,
            "allow_ip_spoofing": False,
            "enable_infrastructure_nat": True,
            "primary_ip": {
                "reserved_ip": example_primary.reserved_ip,
            },
            "ips": [{
                "reserved_ip": example_additional.reserved_ip,
            }],
        })
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		examplePrimary, err := ibm.NewIsSubnetReservedIp(ctx, "examplePrimary", &ibm.IsSubnetReservedIpArgs{
    			Subnet:  pulumi.Any(ibm_is_subnet.Example.Id),
    			Address: pulumi.String("10.240.65.50"),
    		})
    		if err != nil {
    			return err
    		}
    		exampleAdditional, err := ibm.NewIsSubnetReservedIp(ctx, "exampleAdditional", &ibm.IsSubnetReservedIpArgs{
    			Subnet:  pulumi.Any(ibm_is_subnet.Example.Id),
    			Address: pulumi.String("10.240.65.51"),
    		})
    		if err != nil {
    			return err
    		}
    		_, err = ibm.NewIsInstanceNetworkAttachment(ctx, "example4", &ibm.IsInstanceNetworkAttachmentArgs{
    			Instance: pulumi.Any(ibm_is_instance.Example.Id),
    			VirtualNetworkInterface: &ibm.IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs{
    				Name:                    pulumi.String("example-vni-5"),
    				Subnet:                  pulumi.Any(ibm_is_subnet.Example.Id),
    				AutoDelete:              pulumi.Bool(true),
    				AllowIpSpoofing:         pulumi.Bool(false),
    				EnableInfrastructureNat: pulumi.Bool(true),
    				PrimaryIp: &ibm.IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpArgs{
    					ReservedIp: examplePrimary.ReservedIp,
    				},
    				Ips: ibm.IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpArray{
    					&ibm.IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpArgs{
    						ReservedIp: exampleAdditional.ReservedIp,
    					},
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ibm = Pulumi.Ibm;
    
    return await Deployment.RunAsync(() => 
    {
        var examplePrimary = new Ibm.IsSubnetReservedIp("examplePrimary", new()
        {
            Subnet = ibm_is_subnet.Example.Id,
            Address = "10.240.65.50",
        });
    
        var exampleAdditional = new Ibm.IsSubnetReservedIp("exampleAdditional", new()
        {
            Subnet = ibm_is_subnet.Example.Id,
            Address = "10.240.65.51",
        });
    
        var example4 = new Ibm.IsInstanceNetworkAttachment("example4", new()
        {
            Instance = ibm_is_instance.Example.Id,
            VirtualNetworkInterface = new Ibm.Inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs
            {
                Name = "example-vni-5",
                Subnet = ibm_is_subnet.Example.Id,
                AutoDelete = true,
                AllowIpSpoofing = false,
                EnableInfrastructureNat = true,
                PrimaryIp = new Ibm.Inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpArgs
                {
                    ReservedIp = examplePrimary.ReservedIp,
                },
                Ips = new[]
                {
                    new Ibm.Inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpArgs
                    {
                        ReservedIp = exampleAdditional.ReservedIp,
                    },
                },
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ibm.IsSubnetReservedIp;
    import com.pulumi.ibm.IsSubnetReservedIpArgs;
    import com.pulumi.ibm.IsInstanceNetworkAttachment;
    import com.pulumi.ibm.IsInstanceNetworkAttachmentArgs;
    import com.pulumi.ibm.inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs;
    import com.pulumi.ibm.inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpArgs;
    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 examplePrimary = new IsSubnetReservedIp("examplePrimary", IsSubnetReservedIpArgs.builder()
                .subnet(ibm_is_subnet.example().id())
                .address("10.240.65.50")
                .build());
    
            var exampleAdditional = new IsSubnetReservedIp("exampleAdditional", IsSubnetReservedIpArgs.builder()
                .subnet(ibm_is_subnet.example().id())
                .address("10.240.65.51")
                .build());
    
            var example4 = new IsInstanceNetworkAttachment("example4", IsInstanceNetworkAttachmentArgs.builder()
                .instance(ibm_is_instance.example().id())
                .virtualNetworkInterface(IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs.builder()
                    .name("example-vni-5")
                    .subnet(ibm_is_subnet.example().id())
                    .autoDelete(true)
                    .allowIpSpoofing(false)
                    .enableInfrastructureNat(true)
                    .primaryIp(IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpArgs.builder()
                        .reservedIp(examplePrimary.reservedIp())
                        .build())
                    .ips(IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpArgs.builder()
                        .reservedIp(exampleAdditional.reservedIp())
                        .build())
                    .build())
                .build());
    
        }
    }
    
    resources:
      examplePrimary:
        type: ibm:IsSubnetReservedIp
        properties:
          subnet: ${ibm_is_subnet.example.id}
          address: 10.240.65.50
      exampleAdditional:
        type: ibm:IsSubnetReservedIp
        properties:
          subnet: ${ibm_is_subnet.example.id}
          address: 10.240.65.51
      example4:
        type: ibm:IsInstanceNetworkAttachment
        properties:
          instance: ${ibm_is_instance.example.id}
          virtualNetworkInterface:
            name: example-vni-5
            subnet: ${ibm_is_subnet.example.id}
            autoDelete: true
            allowIpSpoofing: false
            enableInfrastructureNat: true
            primaryIp:
              reservedIp: ${examplePrimary.reservedIp}
            ips:
              - reservedIp: ${exampleAdditional.reservedIp}
    

    Create IsInstanceNetworkAttachment Resource

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

    Constructor syntax

    new IsInstanceNetworkAttachment(name: string, args: IsInstanceNetworkAttachmentArgs, opts?: CustomResourceOptions);
    @overload
    def IsInstanceNetworkAttachment(resource_name: str,
                                    args: IsInstanceNetworkAttachmentInitArgs,
                                    opts: Optional[ResourceOptions] = None)
    
    @overload
    def IsInstanceNetworkAttachment(resource_name: str,
                                    opts: Optional[ResourceOptions] = None,
                                    instance: Optional[str] = None,
                                    is_instance_network_attachment_id: Optional[str] = None,
                                    name: Optional[str] = None,
                                    virtual_network_interface: Optional[IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs] = None)
    func NewIsInstanceNetworkAttachment(ctx *Context, name string, args IsInstanceNetworkAttachmentArgs, opts ...ResourceOption) (*IsInstanceNetworkAttachment, error)
    public IsInstanceNetworkAttachment(string name, IsInstanceNetworkAttachmentArgs args, CustomResourceOptions? opts = null)
    public IsInstanceNetworkAttachment(String name, IsInstanceNetworkAttachmentArgs args)
    public IsInstanceNetworkAttachment(String name, IsInstanceNetworkAttachmentArgs args, CustomResourceOptions options)
    
    type: ibm:IsInstanceNetworkAttachment
    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 IsInstanceNetworkAttachmentArgs
    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 IsInstanceNetworkAttachmentInitArgs
    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 IsInstanceNetworkAttachmentArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args IsInstanceNetworkAttachmentArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args IsInstanceNetworkAttachmentArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

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

    var isInstanceNetworkAttachmentResource = new Ibm.IsInstanceNetworkAttachment("isInstanceNetworkAttachmentResource", new()
    {
        Instance = "string",
        IsInstanceNetworkAttachmentId = "string",
        Name = "string",
        VirtualNetworkInterface = new Ibm.Inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs
        {
            AllowIpSpoofing = false,
            AutoDelete = false,
            EnableInfrastructureNat = false,
            Id = "string",
            Ips = new[]
            {
                new Ibm.Inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpArgs
                {
                    ReservedIp = "string",
                    Address = "string",
                    AutoDelete = false,
                    Deleteds = new[]
                    {
                        new Ibm.Inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpDeletedArgs
                        {
                            MoreInfo = "string",
                        },
                    },
                    Href = "string",
                    Name = "string",
                    ResourceType = "string",
                },
            },
            Name = "string",
            PrimaryIp = new Ibm.Inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpArgs
            {
                Address = "string",
                AutoDelete = false,
                Deleteds = new[]
                {
                    new Ibm.Inputs.IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpDeletedArgs
                    {
                        MoreInfo = "string",
                    },
                },
                Href = "string",
                Name = "string",
                ReservedIp = "string",
                ResourceType = "string",
            },
            ProtocolStateFilteringMode = "string",
            ResourceGroup = "string",
            ResourceType = "string",
            SecurityGroups = new[]
            {
                "string",
            },
            Subnet = "string",
        },
    });
    
    example, err := ibm.NewIsInstanceNetworkAttachment(ctx, "isInstanceNetworkAttachmentResource", &ibm.IsInstanceNetworkAttachmentArgs{
    	Instance:                      pulumi.String("string"),
    	IsInstanceNetworkAttachmentId: pulumi.String("string"),
    	Name:                          pulumi.String("string"),
    	VirtualNetworkInterface: &ibm.IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs{
    		AllowIpSpoofing:         pulumi.Bool(false),
    		AutoDelete:              pulumi.Bool(false),
    		EnableInfrastructureNat: pulumi.Bool(false),
    		Id:                      pulumi.String("string"),
    		Ips: ibm.IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpArray{
    			&ibm.IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpArgs{
    				ReservedIp: pulumi.String("string"),
    				Address:    pulumi.String("string"),
    				AutoDelete: pulumi.Bool(false),
    				Deleteds: ibm.IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpDeletedArray{
    					&ibm.IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpDeletedArgs{
    						MoreInfo: pulumi.String("string"),
    					},
    				},
    				Href:         pulumi.String("string"),
    				Name:         pulumi.String("string"),
    				ResourceType: pulumi.String("string"),
    			},
    		},
    		Name: pulumi.String("string"),
    		PrimaryIp: &ibm.IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpArgs{
    			Address:    pulumi.String("string"),
    			AutoDelete: pulumi.Bool(false),
    			Deleteds: ibm.IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpDeletedArray{
    				&ibm.IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpDeletedArgs{
    					MoreInfo: pulumi.String("string"),
    				},
    			},
    			Href:         pulumi.String("string"),
    			Name:         pulumi.String("string"),
    			ReservedIp:   pulumi.String("string"),
    			ResourceType: pulumi.String("string"),
    		},
    		ProtocolStateFilteringMode: pulumi.String("string"),
    		ResourceGroup:              pulumi.String("string"),
    		ResourceType:               pulumi.String("string"),
    		SecurityGroups: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    		Subnet: pulumi.String("string"),
    	},
    })
    
    var isInstanceNetworkAttachmentResource = new IsInstanceNetworkAttachment("isInstanceNetworkAttachmentResource", IsInstanceNetworkAttachmentArgs.builder()
        .instance("string")
        .isInstanceNetworkAttachmentId("string")
        .name("string")
        .virtualNetworkInterface(IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs.builder()
            .allowIpSpoofing(false)
            .autoDelete(false)
            .enableInfrastructureNat(false)
            .id("string")
            .ips(IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpArgs.builder()
                .reservedIp("string")
                .address("string")
                .autoDelete(false)
                .deleteds(IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpDeletedArgs.builder()
                    .moreInfo("string")
                    .build())
                .href("string")
                .name("string")
                .resourceType("string")
                .build())
            .name("string")
            .primaryIp(IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpArgs.builder()
                .address("string")
                .autoDelete(false)
                .deleteds(IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpDeletedArgs.builder()
                    .moreInfo("string")
                    .build())
                .href("string")
                .name("string")
                .reservedIp("string")
                .resourceType("string")
                .build())
            .protocolStateFilteringMode("string")
            .resourceGroup("string")
            .resourceType("string")
            .securityGroups("string")
            .subnet("string")
            .build())
        .build());
    
    is_instance_network_attachment_resource = ibm.IsInstanceNetworkAttachment("isInstanceNetworkAttachmentResource",
        instance="string",
        is_instance_network_attachment_id="string",
        name="string",
        virtual_network_interface={
            "allow_ip_spoofing": False,
            "auto_delete": False,
            "enable_infrastructure_nat": False,
            "id": "string",
            "ips": [{
                "reserved_ip": "string",
                "address": "string",
                "auto_delete": False,
                "deleteds": [{
                    "more_info": "string",
                }],
                "href": "string",
                "name": "string",
                "resource_type": "string",
            }],
            "name": "string",
            "primary_ip": {
                "address": "string",
                "auto_delete": False,
                "deleteds": [{
                    "more_info": "string",
                }],
                "href": "string",
                "name": "string",
                "reserved_ip": "string",
                "resource_type": "string",
            },
            "protocol_state_filtering_mode": "string",
            "resource_group": "string",
            "resource_type": "string",
            "security_groups": ["string"],
            "subnet": "string",
        })
    
    const isInstanceNetworkAttachmentResource = new ibm.IsInstanceNetworkAttachment("isInstanceNetworkAttachmentResource", {
        instance: "string",
        isInstanceNetworkAttachmentId: "string",
        name: "string",
        virtualNetworkInterface: {
            allowIpSpoofing: false,
            autoDelete: false,
            enableInfrastructureNat: false,
            id: "string",
            ips: [{
                reservedIp: "string",
                address: "string",
                autoDelete: false,
                deleteds: [{
                    moreInfo: "string",
                }],
                href: "string",
                name: "string",
                resourceType: "string",
            }],
            name: "string",
            primaryIp: {
                address: "string",
                autoDelete: false,
                deleteds: [{
                    moreInfo: "string",
                }],
                href: "string",
                name: "string",
                reservedIp: "string",
                resourceType: "string",
            },
            protocolStateFilteringMode: "string",
            resourceGroup: "string",
            resourceType: "string",
            securityGroups: ["string"],
            subnet: "string",
        },
    });
    
    type: ibm:IsInstanceNetworkAttachment
    properties:
        instance: string
        isInstanceNetworkAttachmentId: string
        name: string
        virtualNetworkInterface:
            allowIpSpoofing: false
            autoDelete: false
            enableInfrastructureNat: false
            id: string
            ips:
                - address: string
                  autoDelete: false
                  deleteds:
                    - moreInfo: string
                  href: string
                  name: string
                  reservedIp: string
                  resourceType: string
            name: string
            primaryIp:
                address: string
                autoDelete: false
                deleteds:
                    - moreInfo: string
                href: string
                name: string
                reservedIp: string
                resourceType: string
            protocolStateFilteringMode: string
            resourceGroup: string
            resourceType: string
            securityGroups:
                - string
            subnet: string
    

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

    Instance string
    The virtual server instance identifier.
    IsInstanceNetworkAttachmentId string
    (String) The unique identifier for this subnet.
    Name string
    The name for this instance network attachment. The name is unique across all network attachments for the instance.
    VirtualNetworkInterface IsInstanceNetworkAttachmentVirtualNetworkInterface

    The virtual network interface for this instance network attachment. This can be specified using an existing virtual network interface ID, or a prototype object for a new virtual network interface.

    Nested schema for virtual_network_interface:

    Instance string
    The virtual server instance identifier.
    IsInstanceNetworkAttachmentId string
    (String) The unique identifier for this subnet.
    Name string
    The name for this instance network attachment. The name is unique across all network attachments for the instance.
    VirtualNetworkInterface IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs

    The virtual network interface for this instance network attachment. This can be specified using an existing virtual network interface ID, or a prototype object for a new virtual network interface.

    Nested schema for virtual_network_interface:

    instance String
    The virtual server instance identifier.
    isInstanceNetworkAttachmentId String
    (String) The unique identifier for this subnet.
    name String
    The name for this instance network attachment. The name is unique across all network attachments for the instance.
    virtualNetworkInterface IsInstanceNetworkAttachmentVirtualNetworkInterface

    The virtual network interface for this instance network attachment. This can be specified using an existing virtual network interface ID, or a prototype object for a new virtual network interface.

    Nested schema for virtual_network_interface:

    instance string
    The virtual server instance identifier.
    isInstanceNetworkAttachmentId string
    (String) The unique identifier for this subnet.
    name string
    The name for this instance network attachment. The name is unique across all network attachments for the instance.
    virtualNetworkInterface IsInstanceNetworkAttachmentVirtualNetworkInterface

    The virtual network interface for this instance network attachment. This can be specified using an existing virtual network interface ID, or a prototype object for a new virtual network interface.

    Nested schema for virtual_network_interface:

    instance str
    The virtual server instance identifier.
    is_instance_network_attachment_id str
    (String) The unique identifier for this subnet.
    name str
    The name for this instance network attachment. The name is unique across all network attachments for the instance.
    virtual_network_interface IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs

    The virtual network interface for this instance network attachment. This can be specified using an existing virtual network interface ID, or a prototype object for a new virtual network interface.

    Nested schema for virtual_network_interface:

    instance String
    The virtual server instance identifier.
    isInstanceNetworkAttachmentId String
    (String) The unique identifier for this subnet.
    name String
    The name for this instance network attachment. The name is unique across all network attachments for the instance.
    virtualNetworkInterface Property Map

    The virtual network interface for this instance network attachment. This can be specified using an existing virtual network interface ID, or a prototype object for a new virtual network interface.

    Nested schema for virtual_network_interface:

    Outputs

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

    CreatedAt string
    (String) The date and time that the instance network attachment was created.
    Href string
    (String) The URL for this subnet.
    Id string
    The provider-assigned unique ID for this managed resource.
    LifecycleState string
    (String) The lifecycle state of the instance network attachment.

    • Allowable values are: deleting, failed, pending, stable, suspended, updating, waiting.
    NetworkAttachment string
    (String) The id of the network attachment.
    PortSpeed double
    (Integer) The port speed for this instance network attachment in Mbps.
    ResourceType string
    (String) The resource type.
    Type string
    (String) The instance network attachment type.
    CreatedAt string
    (String) The date and time that the instance network attachment was created.
    Href string
    (String) The URL for this subnet.
    Id string
    The provider-assigned unique ID for this managed resource.
    LifecycleState string
    (String) The lifecycle state of the instance network attachment.

    • Allowable values are: deleting, failed, pending, stable, suspended, updating, waiting.
    NetworkAttachment string
    (String) The id of the network attachment.
    PortSpeed float64
    (Integer) The port speed for this instance network attachment in Mbps.
    ResourceType string
    (String) The resource type.
    Type string
    (String) The instance network attachment type.
    createdAt String
    (String) The date and time that the instance network attachment was created.
    href String
    (String) The URL for this subnet.
    id String
    The provider-assigned unique ID for this managed resource.
    lifecycleState String
    (String) The lifecycle state of the instance network attachment.

    • Allowable values are: deleting, failed, pending, stable, suspended, updating, waiting.
    networkAttachment String
    (String) The id of the network attachment.
    portSpeed Double
    (Integer) The port speed for this instance network attachment in Mbps.
    resourceType String
    (String) The resource type.
    type String
    (String) The instance network attachment type.
    createdAt string
    (String) The date and time that the instance network attachment was created.
    href string
    (String) The URL for this subnet.
    id string
    The provider-assigned unique ID for this managed resource.
    lifecycleState string
    (String) The lifecycle state of the instance network attachment.

    • Allowable values are: deleting, failed, pending, stable, suspended, updating, waiting.
    networkAttachment string
    (String) The id of the network attachment.
    portSpeed number
    (Integer) The port speed for this instance network attachment in Mbps.
    resourceType string
    (String) The resource type.
    type string
    (String) The instance network attachment type.
    created_at str
    (String) The date and time that the instance network attachment was created.
    href str
    (String) The URL for this subnet.
    id str
    The provider-assigned unique ID for this managed resource.
    lifecycle_state str
    (String) The lifecycle state of the instance network attachment.

    • Allowable values are: deleting, failed, pending, stable, suspended, updating, waiting.
    network_attachment str
    (String) The id of the network attachment.
    port_speed float
    (Integer) The port speed for this instance network attachment in Mbps.
    resource_type str
    (String) The resource type.
    type str
    (String) The instance network attachment type.
    createdAt String
    (String) The date and time that the instance network attachment was created.
    href String
    (String) The URL for this subnet.
    id String
    The provider-assigned unique ID for this managed resource.
    lifecycleState String
    (String) The lifecycle state of the instance network attachment.

    • Allowable values are: deleting, failed, pending, stable, suspended, updating, waiting.
    networkAttachment String
    (String) The id of the network attachment.
    portSpeed Number
    (Integer) The port speed for this instance network attachment in Mbps.
    resourceType String
    (String) The resource type.
    type String
    (String) The instance network attachment type.

    Look up Existing IsInstanceNetworkAttachment Resource

    Get an existing IsInstanceNetworkAttachment resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: IsInstanceNetworkAttachmentState, opts?: CustomResourceOptions): IsInstanceNetworkAttachment
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            created_at: Optional[str] = None,
            href: Optional[str] = None,
            instance: Optional[str] = None,
            is_instance_network_attachment_id: Optional[str] = None,
            lifecycle_state: Optional[str] = None,
            name: Optional[str] = None,
            network_attachment: Optional[str] = None,
            port_speed: Optional[float] = None,
            resource_type: Optional[str] = None,
            type: Optional[str] = None,
            virtual_network_interface: Optional[IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs] = None) -> IsInstanceNetworkAttachment
    func GetIsInstanceNetworkAttachment(ctx *Context, name string, id IDInput, state *IsInstanceNetworkAttachmentState, opts ...ResourceOption) (*IsInstanceNetworkAttachment, error)
    public static IsInstanceNetworkAttachment Get(string name, Input<string> id, IsInstanceNetworkAttachmentState? state, CustomResourceOptions? opts = null)
    public static IsInstanceNetworkAttachment get(String name, Output<String> id, IsInstanceNetworkAttachmentState state, CustomResourceOptions options)
    resources:  _:    type: ibm:IsInstanceNetworkAttachment    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:
    CreatedAt string
    (String) The date and time that the instance network attachment was created.
    Href string
    (String) The URL for this subnet.
    Instance string
    The virtual server instance identifier.
    IsInstanceNetworkAttachmentId string
    (String) The unique identifier for this subnet.
    LifecycleState string
    (String) The lifecycle state of the instance network attachment.

    • Allowable values are: deleting, failed, pending, stable, suspended, updating, waiting.
    Name string
    The name for this instance network attachment. The name is unique across all network attachments for the instance.
    NetworkAttachment string
    (String) The id of the network attachment.
    PortSpeed double
    (Integer) The port speed for this instance network attachment in Mbps.
    ResourceType string
    (String) The resource type.
    Type string
    (String) The instance network attachment type.
    VirtualNetworkInterface IsInstanceNetworkAttachmentVirtualNetworkInterface

    The virtual network interface for this instance network attachment. This can be specified using an existing virtual network interface ID, or a prototype object for a new virtual network interface.

    Nested schema for virtual_network_interface:

    CreatedAt string
    (String) The date and time that the instance network attachment was created.
    Href string
    (String) The URL for this subnet.
    Instance string
    The virtual server instance identifier.
    IsInstanceNetworkAttachmentId string
    (String) The unique identifier for this subnet.
    LifecycleState string
    (String) The lifecycle state of the instance network attachment.

    • Allowable values are: deleting, failed, pending, stable, suspended, updating, waiting.
    Name string
    The name for this instance network attachment. The name is unique across all network attachments for the instance.
    NetworkAttachment string
    (String) The id of the network attachment.
    PortSpeed float64
    (Integer) The port speed for this instance network attachment in Mbps.
    ResourceType string
    (String) The resource type.
    Type string
    (String) The instance network attachment type.
    VirtualNetworkInterface IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs

    The virtual network interface for this instance network attachment. This can be specified using an existing virtual network interface ID, or a prototype object for a new virtual network interface.

    Nested schema for virtual_network_interface:

    createdAt String
    (String) The date and time that the instance network attachment was created.
    href String
    (String) The URL for this subnet.
    instance String
    The virtual server instance identifier.
    isInstanceNetworkAttachmentId String
    (String) The unique identifier for this subnet.
    lifecycleState String
    (String) The lifecycle state of the instance network attachment.

    • Allowable values are: deleting, failed, pending, stable, suspended, updating, waiting.
    name String
    The name for this instance network attachment. The name is unique across all network attachments for the instance.
    networkAttachment String
    (String) The id of the network attachment.
    portSpeed Double
    (Integer) The port speed for this instance network attachment in Mbps.
    resourceType String
    (String) The resource type.
    type String
    (String) The instance network attachment type.
    virtualNetworkInterface IsInstanceNetworkAttachmentVirtualNetworkInterface

    The virtual network interface for this instance network attachment. This can be specified using an existing virtual network interface ID, or a prototype object for a new virtual network interface.

    Nested schema for virtual_network_interface:

    createdAt string
    (String) The date and time that the instance network attachment was created.
    href string
    (String) The URL for this subnet.
    instance string
    The virtual server instance identifier.
    isInstanceNetworkAttachmentId string
    (String) The unique identifier for this subnet.
    lifecycleState string
    (String) The lifecycle state of the instance network attachment.

    • Allowable values are: deleting, failed, pending, stable, suspended, updating, waiting.
    name string
    The name for this instance network attachment. The name is unique across all network attachments for the instance.
    networkAttachment string
    (String) The id of the network attachment.
    portSpeed number
    (Integer) The port speed for this instance network attachment in Mbps.
    resourceType string
    (String) The resource type.
    type string
    (String) The instance network attachment type.
    virtualNetworkInterface IsInstanceNetworkAttachmentVirtualNetworkInterface

    The virtual network interface for this instance network attachment. This can be specified using an existing virtual network interface ID, or a prototype object for a new virtual network interface.

    Nested schema for virtual_network_interface:

    created_at str
    (String) The date and time that the instance network attachment was created.
    href str
    (String) The URL for this subnet.
    instance str
    The virtual server instance identifier.
    is_instance_network_attachment_id str
    (String) The unique identifier for this subnet.
    lifecycle_state str
    (String) The lifecycle state of the instance network attachment.

    • Allowable values are: deleting, failed, pending, stable, suspended, updating, waiting.
    name str
    The name for this instance network attachment. The name is unique across all network attachments for the instance.
    network_attachment str
    (String) The id of the network attachment.
    port_speed float
    (Integer) The port speed for this instance network attachment in Mbps.
    resource_type str
    (String) The resource type.
    type str
    (String) The instance network attachment type.
    virtual_network_interface IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs

    The virtual network interface for this instance network attachment. This can be specified using an existing virtual network interface ID, or a prototype object for a new virtual network interface.

    Nested schema for virtual_network_interface:

    createdAt String
    (String) The date and time that the instance network attachment was created.
    href String
    (String) The URL for this subnet.
    instance String
    The virtual server instance identifier.
    isInstanceNetworkAttachmentId String
    (String) The unique identifier for this subnet.
    lifecycleState String
    (String) The lifecycle state of the instance network attachment.

    • Allowable values are: deleting, failed, pending, stable, suspended, updating, waiting.
    name String
    The name for this instance network attachment. The name is unique across all network attachments for the instance.
    networkAttachment String
    (String) The id of the network attachment.
    portSpeed Number
    (Integer) The port speed for this instance network attachment in Mbps.
    resourceType String
    (String) The resource type.
    type String
    (String) The instance network attachment type.
    virtualNetworkInterface Property Map

    The virtual network interface for this instance network attachment. This can be specified using an existing virtual network interface ID, or a prototype object for a new virtual network interface.

    Nested schema for virtual_network_interface:

    Supporting Types

    IsInstanceNetworkAttachmentVirtualNetworkInterface, IsInstanceNetworkAttachmentVirtualNetworkInterfaceArgs

    AllowIpSpoofing bool
    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. Conflicts with id.
    AutoDelete bool
    Indicates whether this virtual network interface will be automatically deleted when target is deleted. Conflicts with id.
    EnableInfrastructureNat bool
    If true: The VPC infrastructure performs any needed NAT operations. floating_ips must not have more than one floating IP. If false: Packets are passed unchanged to/from the network interface, allowing the workload to perform any needed NAT operations. allow_ip_spoofing must be false. If the virtual network interface is attached: The target resource_type must be bare_metal_server_network_attachment. The target interface_type must not be hipersocket. Conflicts with id.
    Id string
    The unique identifier for an existing virtual network interface. When specified, all other nested arguments are ignored and will conflict if provided.
    Ips List<IsInstanceNetworkAttachmentVirtualNetworkInterfaceIp>

    The reserved IPs bound to this virtual network interface. May be empty when lifecycle_state is pending. Conflicts with id.

    NOTE to add ips only existing reserved_ip is supported, new reserved_ip creation is not supported as it leads to unmanaged(dangling) reserved ips. Use ibm.IsSubnetReservedIp to create a reserved_ip

    Nested schema for ips:

    Name string
    The name for this virtual network interface. The name is unique across all virtual network interfaces in the VPC. Conflicts with id.
    PrimaryIp IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIp
    The primary IP address of the virtual network interface for the instance network attachment. Conflicts with id. Nested schema for primary_ip:
    ProtocolStateFilteringMode string
    The protocol state filtering mode used for this virtual network interface.
    ResourceGroup string
    The resource group id for this virtual network interface. Conflicts with id.
    ResourceType string
    The resource type.
    SecurityGroups List<string>
    The security groups for this virtual network interface. Conflicts with id.
    Subnet string
    The associated subnet id. Conflicts with id.
    AllowIpSpoofing bool
    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. Conflicts with id.
    AutoDelete bool
    Indicates whether this virtual network interface will be automatically deleted when target is deleted. Conflicts with id.
    EnableInfrastructureNat bool
    If true: The VPC infrastructure performs any needed NAT operations. floating_ips must not have more than one floating IP. If false: Packets are passed unchanged to/from the network interface, allowing the workload to perform any needed NAT operations. allow_ip_spoofing must be false. If the virtual network interface is attached: The target resource_type must be bare_metal_server_network_attachment. The target interface_type must not be hipersocket. Conflicts with id.
    Id string
    The unique identifier for an existing virtual network interface. When specified, all other nested arguments are ignored and will conflict if provided.
    Ips []IsInstanceNetworkAttachmentVirtualNetworkInterfaceIp

    The reserved IPs bound to this virtual network interface. May be empty when lifecycle_state is pending. Conflicts with id.

    NOTE to add ips only existing reserved_ip is supported, new reserved_ip creation is not supported as it leads to unmanaged(dangling) reserved ips. Use ibm.IsSubnetReservedIp to create a reserved_ip

    Nested schema for ips:

    Name string
    The name for this virtual network interface. The name is unique across all virtual network interfaces in the VPC. Conflicts with id.
    PrimaryIp IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIp
    The primary IP address of the virtual network interface for the instance network attachment. Conflicts with id. Nested schema for primary_ip:
    ProtocolStateFilteringMode string
    The protocol state filtering mode used for this virtual network interface.
    ResourceGroup string
    The resource group id for this virtual network interface. Conflicts with id.
    ResourceType string
    The resource type.
    SecurityGroups []string
    The security groups for this virtual network interface. Conflicts with id.
    Subnet string
    The associated subnet id. Conflicts with id.
    allowIpSpoofing 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. Conflicts with id.
    autoDelete Boolean
    Indicates whether this virtual network interface will be automatically deleted when target is deleted. Conflicts with id.
    enableInfrastructureNat Boolean
    If true: The VPC infrastructure performs any needed NAT operations. floating_ips must not have more than one floating IP. If false: Packets are passed unchanged to/from the network interface, allowing the workload to perform any needed NAT operations. allow_ip_spoofing must be false. If the virtual network interface is attached: The target resource_type must be bare_metal_server_network_attachment. The target interface_type must not be hipersocket. Conflicts with id.
    id String
    The unique identifier for an existing virtual network interface. When specified, all other nested arguments are ignored and will conflict if provided.
    ips List<IsInstanceNetworkAttachmentVirtualNetworkInterfaceIp>

    The reserved IPs bound to this virtual network interface. May be empty when lifecycle_state is pending. Conflicts with id.

    NOTE to add ips only existing reserved_ip is supported, new reserved_ip creation is not supported as it leads to unmanaged(dangling) reserved ips. Use ibm.IsSubnetReservedIp to create a reserved_ip

    Nested schema for ips:

    name String
    The name for this virtual network interface. The name is unique across all virtual network interfaces in the VPC. Conflicts with id.
    primaryIp IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIp
    The primary IP address of the virtual network interface for the instance network attachment. Conflicts with id. Nested schema for primary_ip:
    protocolStateFilteringMode String
    The protocol state filtering mode used for this virtual network interface.
    resourceGroup String
    The resource group id for this virtual network interface. Conflicts with id.
    resourceType String
    The resource type.
    securityGroups List<String>
    The security groups for this virtual network interface. Conflicts with id.
    subnet String
    The associated subnet id. Conflicts with id.
    allowIpSpoofing 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. Conflicts with id.
    autoDelete boolean
    Indicates whether this virtual network interface will be automatically deleted when target is deleted. Conflicts with id.
    enableInfrastructureNat boolean
    If true: The VPC infrastructure performs any needed NAT operations. floating_ips must not have more than one floating IP. If false: Packets are passed unchanged to/from the network interface, allowing the workload to perform any needed NAT operations. allow_ip_spoofing must be false. If the virtual network interface is attached: The target resource_type must be bare_metal_server_network_attachment. The target interface_type must not be hipersocket. Conflicts with id.
    id string
    The unique identifier for an existing virtual network interface. When specified, all other nested arguments are ignored and will conflict if provided.
    ips IsInstanceNetworkAttachmentVirtualNetworkInterfaceIp[]

    The reserved IPs bound to this virtual network interface. May be empty when lifecycle_state is pending. Conflicts with id.

    NOTE to add ips only existing reserved_ip is supported, new reserved_ip creation is not supported as it leads to unmanaged(dangling) reserved ips. Use ibm.IsSubnetReservedIp to create a reserved_ip

    Nested schema for ips:

    name string
    The name for this virtual network interface. The name is unique across all virtual network interfaces in the VPC. Conflicts with id.
    primaryIp IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIp
    The primary IP address of the virtual network interface for the instance network attachment. Conflicts with id. Nested schema for primary_ip:
    protocolStateFilteringMode string
    The protocol state filtering mode used for this virtual network interface.
    resourceGroup string
    The resource group id for this virtual network interface. Conflicts with id.
    resourceType string
    The resource type.
    securityGroups string[]
    The security groups for this virtual network interface. Conflicts with id.
    subnet string
    The associated subnet id. Conflicts with id.
    allow_ip_spoofing bool
    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. Conflicts with id.
    auto_delete bool
    Indicates whether this virtual network interface will be automatically deleted when target is deleted. Conflicts with id.
    enable_infrastructure_nat bool
    If true: The VPC infrastructure performs any needed NAT operations. floating_ips must not have more than one floating IP. If false: Packets are passed unchanged to/from the network interface, allowing the workload to perform any needed NAT operations. allow_ip_spoofing must be false. If the virtual network interface is attached: The target resource_type must be bare_metal_server_network_attachment. The target interface_type must not be hipersocket. Conflicts with id.
    id str
    The unique identifier for an existing virtual network interface. When specified, all other nested arguments are ignored and will conflict if provided.
    ips Sequence[IsInstanceNetworkAttachmentVirtualNetworkInterfaceIp]

    The reserved IPs bound to this virtual network interface. May be empty when lifecycle_state is pending. Conflicts with id.

    NOTE to add ips only existing reserved_ip is supported, new reserved_ip creation is not supported as it leads to unmanaged(dangling) reserved ips. Use ibm.IsSubnetReservedIp to create a reserved_ip

    Nested schema for ips:

    name str
    The name for this virtual network interface. The name is unique across all virtual network interfaces in the VPC. Conflicts with id.
    primary_ip IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIp
    The primary IP address of the virtual network interface for the instance network attachment. Conflicts with id. Nested schema for primary_ip:
    protocol_state_filtering_mode str
    The protocol state filtering mode used for this virtual network interface.
    resource_group str
    The resource group id for this virtual network interface. Conflicts with id.
    resource_type str
    The resource type.
    security_groups Sequence[str]
    The security groups for this virtual network interface. Conflicts with id.
    subnet str
    The associated subnet id. Conflicts with id.
    allowIpSpoofing 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. Conflicts with id.
    autoDelete Boolean
    Indicates whether this virtual network interface will be automatically deleted when target is deleted. Conflicts with id.
    enableInfrastructureNat Boolean
    If true: The VPC infrastructure performs any needed NAT operations. floating_ips must not have more than one floating IP. If false: Packets are passed unchanged to/from the network interface, allowing the workload to perform any needed NAT operations. allow_ip_spoofing must be false. If the virtual network interface is attached: The target resource_type must be bare_metal_server_network_attachment. The target interface_type must not be hipersocket. Conflicts with id.
    id String
    The unique identifier for an existing virtual network interface. When specified, all other nested arguments are ignored and will conflict if provided.
    ips List<Property Map>

    The reserved IPs bound to this virtual network interface. May be empty when lifecycle_state is pending. Conflicts with id.

    NOTE to add ips only existing reserved_ip is supported, new reserved_ip creation is not supported as it leads to unmanaged(dangling) reserved ips. Use ibm.IsSubnetReservedIp to create a reserved_ip

    Nested schema for ips:

    name String
    The name for this virtual network interface. The name is unique across all virtual network interfaces in the VPC. Conflicts with id.
    primaryIp Property Map
    The primary IP address of the virtual network interface for the instance network attachment. Conflicts with id. Nested schema for primary_ip:
    protocolStateFilteringMode String
    The protocol state filtering mode used for this virtual network interface.
    resourceGroup String
    The resource group id for this virtual network interface. Conflicts with id.
    resourceType String
    The resource type.
    securityGroups List<String>
    The security groups for this virtual network interface. Conflicts with id.
    subnet String
    The associated subnet id. Conflicts with id.

    IsInstanceNetworkAttachmentVirtualNetworkInterfaceIp, IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpArgs

    ReservedIp string
    The unique identifier for this reserved IP.
    Address string
    The IP address. If the address has not yet been selected, the value will be 0.0.0.0. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    AutoDelete bool
    Indicates whether this reserved IP member will be automatically deleted when either target is deleted, or the reserved IP is unbound.
    Deleteds List<IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpDeleted>
    If present, this property indicates the referenced resource has been deleted, and provides some supplementary information. Nested schema for deleted:
    Href string
    The URL for this reserved IP.
    Name string
    The name for this reserved IP. The name is unique across all reserved IPs in a subnet.
    ResourceType string
    The resource type.
    ReservedIp string
    The unique identifier for this reserved IP.
    Address string
    The IP address. If the address has not yet been selected, the value will be 0.0.0.0. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    AutoDelete bool
    Indicates whether this reserved IP member will be automatically deleted when either target is deleted, or the reserved IP is unbound.
    Deleteds []IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpDeleted
    If present, this property indicates the referenced resource has been deleted, and provides some supplementary information. Nested schema for deleted:
    Href string
    The URL for this reserved IP.
    Name string
    The name for this reserved IP. The name is unique across all reserved IPs in a subnet.
    ResourceType string
    The resource type.
    reservedIp String
    The unique identifier for this reserved IP.
    address String
    The IP address. If the address has not yet been selected, the value will be 0.0.0.0. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    autoDelete Boolean
    Indicates whether this reserved IP member will be automatically deleted when either target is deleted, or the reserved IP is unbound.
    deleteds List<IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpDeleted>
    If present, this property indicates the referenced resource has been deleted, and provides some supplementary information. Nested schema for deleted:
    href String
    The URL for this reserved IP.
    name String
    The name for this reserved IP. The name is unique across all reserved IPs in a subnet.
    resourceType String
    The resource type.
    reservedIp string
    The unique identifier for this reserved IP.
    address string
    The IP address. If the address has not yet been selected, the value will be 0.0.0.0. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    autoDelete boolean
    Indicates whether this reserved IP member will be automatically deleted when either target is deleted, or the reserved IP is unbound.
    deleteds IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpDeleted[]
    If present, this property indicates the referenced resource has been deleted, and provides some supplementary information. Nested schema for deleted:
    href string
    The URL for this reserved IP.
    name string
    The name for this reserved IP. The name is unique across all reserved IPs in a subnet.
    resourceType string
    The resource type.
    reserved_ip str
    The unique identifier for this reserved IP.
    address str
    The IP address. If the address has not yet been selected, the value will be 0.0.0.0. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    auto_delete bool
    Indicates whether this reserved IP member will be automatically deleted when either target is deleted, or the reserved IP is unbound.
    deleteds Sequence[IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpDeleted]
    If present, this property indicates the referenced resource has been deleted, and provides some supplementary information. Nested schema for deleted:
    href str
    The URL for this reserved IP.
    name str
    The name for this reserved IP. The name is unique across all reserved IPs in a subnet.
    resource_type str
    The resource type.
    reservedIp String
    The unique identifier for this reserved IP.
    address String
    The IP address. If the address has not yet been selected, the value will be 0.0.0.0. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    autoDelete Boolean
    Indicates whether this reserved IP member will be automatically deleted when either target is deleted, or the reserved IP is unbound.
    deleteds List<Property Map>
    If present, this property indicates the referenced resource has been deleted, and provides some supplementary information. Nested schema for deleted:
    href String
    The URL for this reserved IP.
    name String
    The name for this reserved IP. The name is unique across all reserved IPs in a subnet.
    resourceType String
    The resource type.

    IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpDeleted, IsInstanceNetworkAttachmentVirtualNetworkInterfaceIpDeletedArgs

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

    IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIp, IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpArgs

    Address string
    The IP address. If the address has not yet been selected, the value will be 0.0.0.0. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    AutoDelete bool
    Indicates whether this primary_ip will be automatically deleted when vni is deleted. Default value: true.
    Deleteds List<IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpDeleted>
    If present, this property indicates the referenced resource has been deleted, and provides some supplementary information. Nested schema for deleted:
    Href string
    The URL for this reserved IP.
    Name string
    The name for this reserved IP. The name is unique across all reserved IPs in a subnet.
    ReservedIp string
    The unique identifier for this reserved IP.
    ResourceType string
    The resource type.
    Address string
    The IP address. If the address has not yet been selected, the value will be 0.0.0.0. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    AutoDelete bool
    Indicates whether this primary_ip will be automatically deleted when vni is deleted. Default value: true.
    Deleteds []IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpDeleted
    If present, this property indicates the referenced resource has been deleted, and provides some supplementary information. Nested schema for deleted:
    Href string
    The URL for this reserved IP.
    Name string
    The name for this reserved IP. The name is unique across all reserved IPs in a subnet.
    ReservedIp string
    The unique identifier for this reserved IP.
    ResourceType string
    The resource type.
    address String
    The IP address. If the address has not yet been selected, the value will be 0.0.0.0. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    autoDelete Boolean
    Indicates whether this primary_ip will be automatically deleted when vni is deleted. Default value: true.
    deleteds List<IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpDeleted>
    If present, this property indicates the referenced resource has been deleted, and provides some supplementary information. Nested schema for deleted:
    href String
    The URL for this reserved IP.
    name String
    The name for this reserved IP. The name is unique across all reserved IPs in a subnet.
    reservedIp String
    The unique identifier for this reserved IP.
    resourceType String
    The resource type.
    address string
    The IP address. If the address has not yet been selected, the value will be 0.0.0.0. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    autoDelete boolean
    Indicates whether this primary_ip will be automatically deleted when vni is deleted. Default value: true.
    deleteds IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpDeleted[]
    If present, this property indicates the referenced resource has been deleted, and provides some supplementary information. Nested schema for deleted:
    href string
    The URL for this reserved IP.
    name string
    The name for this reserved IP. The name is unique across all reserved IPs in a subnet.
    reservedIp string
    The unique identifier for this reserved IP.
    resourceType string
    The resource type.
    address str
    The IP address. If the address has not yet been selected, the value will be 0.0.0.0. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    auto_delete bool
    Indicates whether this primary_ip will be automatically deleted when vni is deleted. Default value: true.
    deleteds Sequence[IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpDeleted]
    If present, this property indicates the referenced resource has been deleted, and provides some supplementary information. Nested schema for deleted:
    href str
    The URL for this reserved IP.
    name str
    The name for this reserved IP. The name is unique across all reserved IPs in a subnet.
    reserved_ip str
    The unique identifier for this reserved IP.
    resource_type str
    The resource type.
    address String
    The IP address. If the address has not yet been selected, the value will be 0.0.0.0. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    autoDelete Boolean
    Indicates whether this primary_ip will be automatically deleted when vni is deleted. Default value: true.
    deleteds List<Property Map>
    If present, this property indicates the referenced resource has been deleted, and provides some supplementary information. Nested schema for deleted:
    href String
    The URL for this reserved IP.
    name String
    The name for this reserved IP. The name is unique across all reserved IPs in a subnet.
    reservedIp String
    The unique identifier for this reserved IP.
    resourceType String
    The resource type.

    IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpDeleted, IsInstanceNetworkAttachmentVirtualNetworkInterfacePrimaryIpDeletedArgs

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

    Import

    You can import the ibm_is_instance_network_attachment resource by using id.

    The id property can be formed from instance, and id in the following format:

    /

    • instance: A string. The virtual server instance identifier.

    • id: A string. The instance network attachment identifier.

    Syntax

    $ pulumi import ibm:index/isInstanceNetworkAttachment:IsInstanceNetworkAttachment is_instance_network_attachment <instance>/<id>
    

    Example

    $ pulumi import ibm:index/isInstanceNetworkAttachment:IsInstanceNetworkAttachment is_instance_network_attachment 0716-a4c2c0c6-65c2-4b6a-8293-3f3bded0a5c6/0716-f92b-456a-a162-7a8c26dd5c6
    

    To learn more about importing existing cloud resources, see Importing 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.80.0-beta0 published on Tuesday, Jun 24, 2025 by ibm-cloud