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

ibm.IsVpc

Explore with Pulumi AI

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

    Create, update, or delete a Virtual Private Cloud (VPC). VPCs allow you to create your own space in IBM Cloud to run an isolated environment within the public cloud. VPC gives you the security of a private cloud, with the agility and ease of a public cloud. For more information, about VPC, see getting started with Virtual Private Cloud.

    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) {
        }
    }
    
    {}
    

    Example Usage

    The following example to create a VPC:

    import * as pulumi from "@pulumi/pulumi";
    import * as ibm from "@pulumi/ibm";
    
    const example = new ibm.IsVpc("example", {});
    
    import pulumi
    import pulumi_ibm as ibm
    
    example = ibm.IsVpc("example")
    
    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.NewIsVpc(ctx, "example", nil)
    		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.IsVpc("example");
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ibm.IsVpc;
    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 IsVpc("example");
    
        }
    }
    
    resources:
      example:
        type: ibm:IsVpc
    

    Additional Examples

    The following example to create a VPC with dns:

    Coming soon!
    
    Coming soon!
    
    Coming soon!
    
    Coming soon!
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ibm.IsVpc;
    import com.pulumi.ibm.IsVpcArgs;
    import com.pulumi.ibm.inputs.IsVpcDnsArgs;
    import com.pulumi.ibm.inputs.IsVpcDnsResolverArgs;
    import com.pulumi.resources.CustomResourceOptions;
    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) {
            // manual type resolver
            var example = new IsVpc("example", IsVpcArgs.builder()
                .dns(IsVpcDnsArgs.builder()
                    .enableHub(true)
                    .resolver(IsVpcDnsResolverArgs.builder()
                        .manualServers(IsVpcDnsResolverManualServerArgs.builder()
                            .address("192.168.3.4")
                            .build())
                        .build())
                    .build())
                .build());
    
            var exampleVpcManual = new IsVpc("exampleVpcManual", IsVpcArgs.builder()
                .dns(IsVpcDnsArgs.builder()
                    .enableHub(true)
                    .resolver(IsVpcDnsResolverArgs.builder()
                        .manualServers(                    
                            IsVpcDnsResolverManualServerArgs.builder()
                                .address("192.168.0.4")
                                .zoneAffinity("au-syd-1")
                                .build(),
                            IsVpcDnsResolverManualServerArgs.builder()
                                .address("192.168.64.4")
                                .zoneAffinity("au-syd-2")
                                .build(),
                            IsVpcDnsResolverManualServerArgs.builder()
                                .address("192.168.128.4")
                                .zoneAffinity("au-syd-3")
                                .build())
                        .build())
                    .build())
                .build());
    
            // system type resolver
            var example_system = new IsVpc("example-system", IsVpcArgs.builder()
                .dns(IsVpcDnsArgs.builder()
                    .enableHub(false)
                    .type("system")
                    .build())
                .build());
    
            // delegated type resolver
            var example_delegated = new IsVpc("example-delegated", IsVpcArgs.builder()
                .dns(IsVpcDnsArgs.builder()
                    .enableHub(false)
                    .resolver(IsVpcDnsResolverArgs.builder()
                        .type("delegated")
                        .vpcId(example.isVpcId())
                        .dnsBindingName("example-vpc-binding")
                        .build())
                    .build())
                .build(), CustomResourceOptions.builder()
                    .dependsOn(ibm_dns_custom_resolver.example-hub())
                    .build());
    
            // to change from delegated to system (this removes the binding)
            var example_delegated_to_system = new IsVpc("example-delegated-to-system", IsVpcArgs.builder()
                .dns(IsVpcDnsArgs.builder()
                    .enableHub(false)
                    .resolver(IsVpcDnsResolverArgs.builder()
                        .type("system")
                        .vpcId("null")
                        .dnsBindingName("null")
                        .build())
                    .build())
                .build(), CustomResourceOptions.builder()
                    .dependsOn(ibm_dns_custom_resolver.example-hub())
                    .build());
    
        }
    }
    
    resources:
      # manual type resolver
      example:
        type: ibm:IsVpc
        properties:
          dns:
            enableHub: true
            resolver:
              manualServers:
                - address: 192.168.3.4
      exampleVpcManual:
        type: ibm:IsVpc
        properties:
          dns:
            enableHub: true
            resolver:
              manualServers:
                - address: 192.168.0.4
                  zoneAffinity: au-syd-1
                - address: 192.168.64.4
                  zoneAffinity: au-syd-2
                - address: 192.168.128.4
                  zoneAffinity: au-syd-3
      # system type resolver
      example-system: # delegated type resolver
        type: ibm:IsVpc
        properties:
          dns:
            enableHub: false
            type: system
      example-delegated: # to change from delegated to system (this removes the binding)
        type: ibm:IsVpc
        properties:
          dns:
            enableHub: false
            resolver:
              type: delegated
              vpcId: ${example.isVpcId}
              dnsBindingName: example-vpc-binding
        options:
          dependsOn:
            - ${ibm_dns_custom_resolver"example-hub"[%!s(MISSING)]}
      example-delegated-to-system:
        type: ibm:IsVpc
        properties:
          dns:
            enableHub: false
            resolver:
              type: system
              vpcId: null
              dnsBindingName: null
        options:
          dependsOn:
            - ${ibm_dns_custom_resolver"example-hub"[%!s(MISSING)]}
    

    Create IsVpc Resource

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

    Constructor syntax

    new IsVpc(name: string, args?: IsVpcArgs, opts?: CustomResourceOptions);
    @overload
    def IsVpc(resource_name: str,
              args: Optional[IsVpcArgs] = None,
              opts: Optional[ResourceOptions] = None)
    
    @overload
    def IsVpc(resource_name: str,
              opts: Optional[ResourceOptions] = None,
              access_tags: Optional[Sequence[str]] = None,
              address_prefix_management: Optional[str] = None,
              classic_access: Optional[bool] = None,
              default_network_acl_name: Optional[str] = None,
              default_routing_table_name: Optional[str] = None,
              default_security_group_name: Optional[str] = None,
              dns: Optional[IsVpcDnsArgs] = None,
              is_vpc_id: Optional[str] = None,
              name: Optional[str] = None,
              no_sg_acl_rules: Optional[bool] = None,
              resource_group: Optional[str] = None,
              tags: Optional[Sequence[str]] = None,
              timeouts: Optional[IsVpcTimeoutsArgs] = None)
    func NewIsVpc(ctx *Context, name string, args *IsVpcArgs, opts ...ResourceOption) (*IsVpc, error)
    public IsVpc(string name, IsVpcArgs? args = null, CustomResourceOptions? opts = null)
    public IsVpc(String name, IsVpcArgs args)
    public IsVpc(String name, IsVpcArgs args, CustomResourceOptions options)
    
    type: ibm:IsVpc
    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 IsVpcArgs
    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 IsVpcArgs
    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 IsVpcArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args IsVpcArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args IsVpcArgs
    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 isVpcResource = new Ibm.IsVpc("isVpcResource", new()
    {
        AccessTags = new[]
        {
            "string",
        },
        AddressPrefixManagement = "string",
        DefaultNetworkAclName = "string",
        DefaultRoutingTableName = "string",
        DefaultSecurityGroupName = "string",
        Dns = new Ibm.Inputs.IsVpcDnsArgs
        {
            EnableHub = false,
            ResolutionBindingCount = 0,
            Resolver = new Ibm.Inputs.IsVpcDnsResolverArgs
            {
                Configuration = "string",
                DnsBindingId = "string",
                DnsBindingName = "string",
                ManualServers = new[]
                {
                    new Ibm.Inputs.IsVpcDnsResolverManualServerArgs
                    {
                        Address = "string",
                        ZoneAffinity = "string",
                    },
                },
                Servers = new[]
                {
                    new Ibm.Inputs.IsVpcDnsResolverServerArgs
                    {
                        Address = "string",
                        ZoneAffinity = "string",
                    },
                },
                Type = "string",
                VpcCrn = "string",
                VpcId = "string",
                VpcName = "string",
                VpcRemoteAccountId = "string",
                VpcRemoteRegion = "string",
            },
        },
        IsVpcId = "string",
        Name = "string",
        NoSgAclRules = false,
        ResourceGroup = "string",
        Tags = new[]
        {
            "string",
        },
        Timeouts = new Ibm.Inputs.IsVpcTimeoutsArgs
        {
            Create = "string",
            Delete = "string",
        },
    });
    
    example, err := ibm.NewIsVpc(ctx, "isVpcResource", &ibm.IsVpcArgs{
    	AccessTags: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	AddressPrefixManagement:  pulumi.String("string"),
    	DefaultNetworkAclName:    pulumi.String("string"),
    	DefaultRoutingTableName:  pulumi.String("string"),
    	DefaultSecurityGroupName: pulumi.String("string"),
    	Dns: &ibm.IsVpcDnsArgs{
    		EnableHub:              pulumi.Bool(false),
    		ResolutionBindingCount: pulumi.Float64(0),
    		Resolver: &ibm.IsVpcDnsResolverArgs{
    			Configuration:  pulumi.String("string"),
    			DnsBindingId:   pulumi.String("string"),
    			DnsBindingName: pulumi.String("string"),
    			ManualServers: ibm.IsVpcDnsResolverManualServerArray{
    				&ibm.IsVpcDnsResolverManualServerArgs{
    					Address:      pulumi.String("string"),
    					ZoneAffinity: pulumi.String("string"),
    				},
    			},
    			Servers: ibm.IsVpcDnsResolverServerArray{
    				&ibm.IsVpcDnsResolverServerArgs{
    					Address:      pulumi.String("string"),
    					ZoneAffinity: pulumi.String("string"),
    				},
    			},
    			Type:               pulumi.String("string"),
    			VpcCrn:             pulumi.String("string"),
    			VpcId:              pulumi.String("string"),
    			VpcName:            pulumi.String("string"),
    			VpcRemoteAccountId: pulumi.String("string"),
    			VpcRemoteRegion:    pulumi.String("string"),
    		},
    	},
    	IsVpcId:       pulumi.String("string"),
    	Name:          pulumi.String("string"),
    	NoSgAclRules:  pulumi.Bool(false),
    	ResourceGroup: pulumi.String("string"),
    	Tags: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	Timeouts: &ibm.IsVpcTimeoutsArgs{
    		Create: pulumi.String("string"),
    		Delete: pulumi.String("string"),
    	},
    })
    
    var isVpcResource = new IsVpc("isVpcResource", IsVpcArgs.builder()
        .accessTags("string")
        .addressPrefixManagement("string")
        .defaultNetworkAclName("string")
        .defaultRoutingTableName("string")
        .defaultSecurityGroupName("string")
        .dns(IsVpcDnsArgs.builder()
            .enableHub(false)
            .resolutionBindingCount(0)
            .resolver(IsVpcDnsResolverArgs.builder()
                .configuration("string")
                .dnsBindingId("string")
                .dnsBindingName("string")
                .manualServers(IsVpcDnsResolverManualServerArgs.builder()
                    .address("string")
                    .zoneAffinity("string")
                    .build())
                .servers(IsVpcDnsResolverServerArgs.builder()
                    .address("string")
                    .zoneAffinity("string")
                    .build())
                .type("string")
                .vpcCrn("string")
                .vpcId("string")
                .vpcName("string")
                .vpcRemoteAccountId("string")
                .vpcRemoteRegion("string")
                .build())
            .build())
        .isVpcId("string")
        .name("string")
        .noSgAclRules(false)
        .resourceGroup("string")
        .tags("string")
        .timeouts(IsVpcTimeoutsArgs.builder()
            .create("string")
            .delete("string")
            .build())
        .build());
    
    is_vpc_resource = ibm.IsVpc("isVpcResource",
        access_tags=["string"],
        address_prefix_management="string",
        default_network_acl_name="string",
        default_routing_table_name="string",
        default_security_group_name="string",
        dns={
            "enable_hub": False,
            "resolution_binding_count": 0,
            "resolver": {
                "configuration": "string",
                "dns_binding_id": "string",
                "dns_binding_name": "string",
                "manual_servers": [{
                    "address": "string",
                    "zone_affinity": "string",
                }],
                "servers": [{
                    "address": "string",
                    "zone_affinity": "string",
                }],
                "type": "string",
                "vpc_crn": "string",
                "vpc_id": "string",
                "vpc_name": "string",
                "vpc_remote_account_id": "string",
                "vpc_remote_region": "string",
            },
        },
        is_vpc_id="string",
        name="string",
        no_sg_acl_rules=False,
        resource_group="string",
        tags=["string"],
        timeouts={
            "create": "string",
            "delete": "string",
        })
    
    const isVpcResource = new ibm.IsVpc("isVpcResource", {
        accessTags: ["string"],
        addressPrefixManagement: "string",
        defaultNetworkAclName: "string",
        defaultRoutingTableName: "string",
        defaultSecurityGroupName: "string",
        dns: {
            enableHub: false,
            resolutionBindingCount: 0,
            resolver: {
                configuration: "string",
                dnsBindingId: "string",
                dnsBindingName: "string",
                manualServers: [{
                    address: "string",
                    zoneAffinity: "string",
                }],
                servers: [{
                    address: "string",
                    zoneAffinity: "string",
                }],
                type: "string",
                vpcCrn: "string",
                vpcId: "string",
                vpcName: "string",
                vpcRemoteAccountId: "string",
                vpcRemoteRegion: "string",
            },
        },
        isVpcId: "string",
        name: "string",
        noSgAclRules: false,
        resourceGroup: "string",
        tags: ["string"],
        timeouts: {
            create: "string",
            "delete": "string",
        },
    });
    
    type: ibm:IsVpc
    properties:
        accessTags:
            - string
        addressPrefixManagement: string
        defaultNetworkAclName: string
        defaultRoutingTableName: string
        defaultSecurityGroupName: string
        dns:
            enableHub: false
            resolutionBindingCount: 0
            resolver:
                configuration: string
                dnsBindingId: string
                dnsBindingName: string
                manualServers:
                    - address: string
                      zoneAffinity: string
                servers:
                    - address: string
                      zoneAffinity: string
                type: string
                vpcCrn: string
                vpcId: string
                vpcName: string
                vpcRemoteAccountId: string
                vpcRemoteRegion: string
        isVpcId: string
        name: string
        noSgAclRules: false
        resourceGroup: string
        tags:
            - string
        timeouts:
            create: string
            delete: string
    

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

    AccessTags List<string>

    A list of access management tags to attach to the bare metal server.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    AddressPrefixManagement string
    Indicates whether a default address prefix should be created automatically auto or manually manual for each zone in this VPC. Default value is auto.
    ClassicAccess bool

    Specify if you want to create a VPC that can connect to classic infrastructure resources. Enter true to set up private network connectivity from your VPC to classic infrastructure resources that are created in the same IBM Cloud account, and false to disable this access. If you choose to not set up this access, you cannot enable it after the VPC is created. Make sure to review the prerequisites before you create a VPC with classic infrastructure access. Note that you can enable one VPC for classic infrastructure access per IBM Cloud account only.

    Note: classic_access is deprecated. Use Transit Gateway with Classic as a spoke/connection.

    Deprecated: Deprecated

    DefaultNetworkAclName string
    Enter the name of the default network access control list (ACL).
    DefaultRoutingTableName string
    Enter the name of the default routing table.
    DefaultSecurityGroupName string
    Enter the name of the default security group.
    Dns IsVpcDns

    The DNS configuration for this VPC.

    Nested scheme for dns:

    IsVpcId string
    (String) The ID of the subnet.
    Name string
    Enter a name for your VPC. No.
    NoSgAclRules bool
    If set to true, delete all rules attached to default security group and default network ACL for a new VPC. This attribute has no impact on update. default false.
    ResourceGroup string
    Enter the ID of the resource group where you want to create the VPC. To list available resource groups, run ibmcloud resource groups. If you do not specify a resource group, the VPC is created in the default resource group.
    Tags List<string>
    Enter any tags that you want to associate with your VPC. Tags might help you find your VPC more easily after it is created. Separate multiple tags with a comma (,).
    Timeouts IsVpcTimeouts
    AccessTags []string

    A list of access management tags to attach to the bare metal server.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    AddressPrefixManagement string
    Indicates whether a default address prefix should be created automatically auto or manually manual for each zone in this VPC. Default value is auto.
    ClassicAccess bool

    Specify if you want to create a VPC that can connect to classic infrastructure resources. Enter true to set up private network connectivity from your VPC to classic infrastructure resources that are created in the same IBM Cloud account, and false to disable this access. If you choose to not set up this access, you cannot enable it after the VPC is created. Make sure to review the prerequisites before you create a VPC with classic infrastructure access. Note that you can enable one VPC for classic infrastructure access per IBM Cloud account only.

    Note: classic_access is deprecated. Use Transit Gateway with Classic as a spoke/connection.

    Deprecated: Deprecated

    DefaultNetworkAclName string
    Enter the name of the default network access control list (ACL).
    DefaultRoutingTableName string
    Enter the name of the default routing table.
    DefaultSecurityGroupName string
    Enter the name of the default security group.
    Dns IsVpcDnsArgs

    The DNS configuration for this VPC.

    Nested scheme for dns:

    IsVpcId string
    (String) The ID of the subnet.
    Name string
    Enter a name for your VPC. No.
    NoSgAclRules bool
    If set to true, delete all rules attached to default security group and default network ACL for a new VPC. This attribute has no impact on update. default false.
    ResourceGroup string
    Enter the ID of the resource group where you want to create the VPC. To list available resource groups, run ibmcloud resource groups. If you do not specify a resource group, the VPC is created in the default resource group.
    Tags []string
    Enter any tags that you want to associate with your VPC. Tags might help you find your VPC more easily after it is created. Separate multiple tags with a comma (,).
    Timeouts IsVpcTimeoutsArgs
    accessTags List<String>

    A list of access management tags to attach to the bare metal server.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    addressPrefixManagement String
    Indicates whether a default address prefix should be created automatically auto or manually manual for each zone in this VPC. Default value is auto.
    classicAccess Boolean

    Specify if you want to create a VPC that can connect to classic infrastructure resources. Enter true to set up private network connectivity from your VPC to classic infrastructure resources that are created in the same IBM Cloud account, and false to disable this access. If you choose to not set up this access, you cannot enable it after the VPC is created. Make sure to review the prerequisites before you create a VPC with classic infrastructure access. Note that you can enable one VPC for classic infrastructure access per IBM Cloud account only.

    Note: classic_access is deprecated. Use Transit Gateway with Classic as a spoke/connection.

    Deprecated: Deprecated

    defaultNetworkAclName String
    Enter the name of the default network access control list (ACL).
    defaultRoutingTableName String
    Enter the name of the default routing table.
    defaultSecurityGroupName String
    Enter the name of the default security group.
    dns IsVpcDns

    The DNS configuration for this VPC.

    Nested scheme for dns:

    isVpcId String
    (String) The ID of the subnet.
    name String
    Enter a name for your VPC. No.
    noSgAclRules Boolean
    If set to true, delete all rules attached to default security group and default network ACL for a new VPC. This attribute has no impact on update. default false.
    resourceGroup String
    Enter the ID of the resource group where you want to create the VPC. To list available resource groups, run ibmcloud resource groups. If you do not specify a resource group, the VPC is created in the default resource group.
    tags List<String>
    Enter any tags that you want to associate with your VPC. Tags might help you find your VPC more easily after it is created. Separate multiple tags with a comma (,).
    timeouts IsVpcTimeouts
    accessTags string[]

    A list of access management tags to attach to the bare metal server.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    addressPrefixManagement string
    Indicates whether a default address prefix should be created automatically auto or manually manual for each zone in this VPC. Default value is auto.
    classicAccess boolean

    Specify if you want to create a VPC that can connect to classic infrastructure resources. Enter true to set up private network connectivity from your VPC to classic infrastructure resources that are created in the same IBM Cloud account, and false to disable this access. If you choose to not set up this access, you cannot enable it after the VPC is created. Make sure to review the prerequisites before you create a VPC with classic infrastructure access. Note that you can enable one VPC for classic infrastructure access per IBM Cloud account only.

    Note: classic_access is deprecated. Use Transit Gateway with Classic as a spoke/connection.

    Deprecated: Deprecated

    defaultNetworkAclName string
    Enter the name of the default network access control list (ACL).
    defaultRoutingTableName string
    Enter the name of the default routing table.
    defaultSecurityGroupName string
    Enter the name of the default security group.
    dns IsVpcDns

    The DNS configuration for this VPC.

    Nested scheme for dns:

    isVpcId string
    (String) The ID of the subnet.
    name string
    Enter a name for your VPC. No.
    noSgAclRules boolean
    If set to true, delete all rules attached to default security group and default network ACL for a new VPC. This attribute has no impact on update. default false.
    resourceGroup string
    Enter the ID of the resource group where you want to create the VPC. To list available resource groups, run ibmcloud resource groups. If you do not specify a resource group, the VPC is created in the default resource group.
    tags string[]
    Enter any tags that you want to associate with your VPC. Tags might help you find your VPC more easily after it is created. Separate multiple tags with a comma (,).
    timeouts IsVpcTimeouts
    access_tags Sequence[str]

    A list of access management tags to attach to the bare metal server.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    address_prefix_management str
    Indicates whether a default address prefix should be created automatically auto or manually manual for each zone in this VPC. Default value is auto.
    classic_access bool

    Specify if you want to create a VPC that can connect to classic infrastructure resources. Enter true to set up private network connectivity from your VPC to classic infrastructure resources that are created in the same IBM Cloud account, and false to disable this access. If you choose to not set up this access, you cannot enable it after the VPC is created. Make sure to review the prerequisites before you create a VPC with classic infrastructure access. Note that you can enable one VPC for classic infrastructure access per IBM Cloud account only.

    Note: classic_access is deprecated. Use Transit Gateway with Classic as a spoke/connection.

    Deprecated: Deprecated

    default_network_acl_name str
    Enter the name of the default network access control list (ACL).
    default_routing_table_name str
    Enter the name of the default routing table.
    default_security_group_name str
    Enter the name of the default security group.
    dns IsVpcDnsArgs

    The DNS configuration for this VPC.

    Nested scheme for dns:

    is_vpc_id str
    (String) The ID of the subnet.
    name str
    Enter a name for your VPC. No.
    no_sg_acl_rules bool
    If set to true, delete all rules attached to default security group and default network ACL for a new VPC. This attribute has no impact on update. default false.
    resource_group str
    Enter the ID of the resource group where you want to create the VPC. To list available resource groups, run ibmcloud resource groups. If you do not specify a resource group, the VPC is created in the default resource group.
    tags Sequence[str]
    Enter any tags that you want to associate with your VPC. Tags might help you find your VPC more easily after it is created. Separate multiple tags with a comma (,).
    timeouts IsVpcTimeoutsArgs
    accessTags List<String>

    A list of access management tags to attach to the bare metal server.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    addressPrefixManagement String
    Indicates whether a default address prefix should be created automatically auto or manually manual for each zone in this VPC. Default value is auto.
    classicAccess Boolean

    Specify if you want to create a VPC that can connect to classic infrastructure resources. Enter true to set up private network connectivity from your VPC to classic infrastructure resources that are created in the same IBM Cloud account, and false to disable this access. If you choose to not set up this access, you cannot enable it after the VPC is created. Make sure to review the prerequisites before you create a VPC with classic infrastructure access. Note that you can enable one VPC for classic infrastructure access per IBM Cloud account only.

    Note: classic_access is deprecated. Use Transit Gateway with Classic as a spoke/connection.

    Deprecated: Deprecated

    defaultNetworkAclName String
    Enter the name of the default network access control list (ACL).
    defaultRoutingTableName String
    Enter the name of the default routing table.
    defaultSecurityGroupName String
    Enter the name of the default security group.
    dns Property Map

    The DNS configuration for this VPC.

    Nested scheme for dns:

    isVpcId String
    (String) The ID of the subnet.
    name String
    Enter a name for your VPC. No.
    noSgAclRules Boolean
    If set to true, delete all rules attached to default security group and default network ACL for a new VPC. This attribute has no impact on update. default false.
    resourceGroup String
    Enter the ID of the resource group where you want to create the VPC. To list available resource groups, run ibmcloud resource groups. If you do not specify a resource group, the VPC is created in the default resource group.
    tags List<String>
    Enter any tags that you want to associate with your VPC. Tags might help you find your VPC more easily after it is created. Separate multiple tags with a comma (,).
    timeouts Property Map

    Outputs

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

    Crn string
    (String) The CRN of the VPC.
    CseSourceAddresses List<IsVpcCseSourceAddress>
    (List) A list of the cloud service endpoints that are associated with your VPC, including their source IP address and zone.
    DefaultAddressPrefixes Dictionary<string, string>
    (Map) A map of default address prefixes for each zone in the VPC. The keys are the zone names, and the values are the corresponding address prefixes. Example:

    import * as pulumi from "@pulumi/pulumi";
    
    import pulumi
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    

    return await Deployment.RunAsync(() => { });

    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		return nil
    	})
    }
    
    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) {
        }
    }
    
    {}
    
    title=""> <span id="defaultnetworkacl_csharp">

    DefaultNetworkAcl string

    (String) The default network ACL ID created and attached to the VPC.
    DefaultNetworkAclCrn string
    (String) CRN of the default network ACL ID created and attached to the VPC.
    DefaultRoutingTable string
    (String) The unique identifier of the VPC default routing table.
    DefaultRoutingTableCrn string
    (String) CRN of the default routing table.
    DefaultSecurityGroup string
    (String) The default security group ID created and attached to the VPC.
    DefaultSecurityGroupCrn string
    (String) CRN of the default security group created and attached to the VPC.
    HealthReasons List<IsVpcHealthReason>
    (List) The reasons for the current health_state (if any).The enumerated reason code values for this property will expand in the future. When processing this property, check for and log unknown values. Optionally halt processing and surface the error, or bypass the resource on which the unexpected reason code was encountered. Nested schema for health_reasons:
    HealthState string
    (String) The health of this resource.- ok: No abnormal behavior detected- degraded: Experiencing compromised performance, capacity, or connectivity- faulted: Completely unreachable, inoperative, or otherwise entirely incapacitated- inapplicable: The health state does not apply because of the current lifecycle state. A resource with a lifecycle state of failed or deleting will have a health state of inapplicable. A pending resource may also have this state.[degraded, faulted, inapplicable, ok]
    Id string
    The provider-assigned unique ID for this managed resource.
    ResourceControllerUrl string
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    ResourceCrn string
    The crn of the resource
    ResourceGroupName string
    The resource group name in which resource is provisioned
    ResourceName string
    The name of the resource
    ResourceStatus string
    The status of the resource
    SecurityGroups List<IsVpcSecurityGroup>
    (List) A list of security groups attached to VPC.
    Status string
    (String) The provisioning status of your VPC.
    Subnets List<IsVpcSubnet>
    (List of Strings) A list of subnets that are attached to a VPC.

    Crn string
    (String) The CRN of the VPC.
    CseSourceAddresses []IsVpcCseSourceAddress
    (List) A list of the cloud service endpoints that are associated with your VPC, including their source IP address and zone.
    DefaultAddressPrefixes map[string]string
    (Map) A map of default address prefixes for each zone in the VPC. The keys are the zone names, and the values are the corresponding address prefixes. Example:

    import * as pulumi from "@pulumi/pulumi";
    
    import pulumi
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    

    return await Deployment.RunAsync(() => { });

    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		return nil
    	})
    }
    
    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) {
        }
    }
    
    {}
    
    title=""> <span id="defaultnetworkacl_go">

    DefaultNetworkAcl string

    (String) The default network ACL ID created and attached to the VPC.
    DefaultNetworkAclCrn string
    (String) CRN of the default network ACL ID created and attached to the VPC.
    DefaultRoutingTable string
    (String) The unique identifier of the VPC default routing table.
    DefaultRoutingTableCrn string
    (String) CRN of the default routing table.
    DefaultSecurityGroup string
    (String) The default security group ID created and attached to the VPC.
    DefaultSecurityGroupCrn string
    (String) CRN of the default security group created and attached to the VPC.
    HealthReasons []IsVpcHealthReason
    (List) The reasons for the current health_state (if any).The enumerated reason code values for this property will expand in the future. When processing this property, check for and log unknown values. Optionally halt processing and surface the error, or bypass the resource on which the unexpected reason code was encountered. Nested schema for health_reasons:
    HealthState string
    (String) The health of this resource.- ok: No abnormal behavior detected- degraded: Experiencing compromised performance, capacity, or connectivity- faulted: Completely unreachable, inoperative, or otherwise entirely incapacitated- inapplicable: The health state does not apply because of the current lifecycle state. A resource with a lifecycle state of failed or deleting will have a health state of inapplicable. A pending resource may also have this state.[degraded, faulted, inapplicable, ok]
    Id string
    The provider-assigned unique ID for this managed resource.
    ResourceControllerUrl string
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    ResourceCrn string
    The crn of the resource
    ResourceGroupName string
    The resource group name in which resource is provisioned
    ResourceName string
    The name of the resource
    ResourceStatus string
    The status of the resource
    SecurityGroups []IsVpcSecurityGroup
    (List) A list of security groups attached to VPC.
    Status string
    (String) The provisioning status of your VPC.
    Subnets []IsVpcSubnet
    (List of Strings) A list of subnets that are attached to a VPC.

    crn String
    (String) The CRN of the VPC.
    cseSourceAddresses List<IsVpcCseSourceAddress>
    (List) A list of the cloud service endpoints that are associated with your VPC, including their source IP address and zone.
    defaultAddressPrefixes Map<String,String>
    (Map) A map of default address prefixes for each zone in the VPC. The keys are the zone names, and the values are the corresponding address prefixes. Example:

    import * as pulumi from "@pulumi/pulumi";
    
    import pulumi
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    

    return await Deployment.RunAsync(() => { });

    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		return nil
    	})
    }
    
    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) {
        }
    }
    
    {}
    
    title=""> <span id="defaultnetworkacl_java">

    defaultNetworkAcl String

    (String) The default network ACL ID created and attached to the VPC.
    defaultNetworkAclCrn String
    (String) CRN of the default network ACL ID created and attached to the VPC.
    defaultRoutingTable String
    (String) The unique identifier of the VPC default routing table.
    defaultRoutingTableCrn String
    (String) CRN of the default routing table.
    defaultSecurityGroup String
    (String) The default security group ID created and attached to the VPC.
    defaultSecurityGroupCrn String
    (String) CRN of the default security group created and attached to the VPC.
    healthReasons List<IsVpcHealthReason>
    (List) The reasons for the current health_state (if any).The enumerated reason code values for this property will expand in the future. When processing this property, check for and log unknown values. Optionally halt processing and surface the error, or bypass the resource on which the unexpected reason code was encountered. Nested schema for health_reasons:
    healthState String
    (String) The health of this resource.- ok: No abnormal behavior detected- degraded: Experiencing compromised performance, capacity, or connectivity- faulted: Completely unreachable, inoperative, or otherwise entirely incapacitated- inapplicable: The health state does not apply because of the current lifecycle state. A resource with a lifecycle state of failed or deleting will have a health state of inapplicable. A pending resource may also have this state.[degraded, faulted, inapplicable, ok]
    id String
    The provider-assigned unique ID for this managed resource.
    resourceControllerUrl String
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    resourceCrn String
    The crn of the resource
    resourceGroupName String
    The resource group name in which resource is provisioned
    resourceName String
    The name of the resource
    resourceStatus String
    The status of the resource
    securityGroups List<IsVpcSecurityGroup>
    (List) A list of security groups attached to VPC.
    status String
    (String) The provisioning status of your VPC.
    subnets List<IsVpcSubnet>
    (List of Strings) A list of subnets that are attached to a VPC.

    crn string
    (String) The CRN of the VPC.
    cseSourceAddresses IsVpcCseSourceAddress[]
    (List) A list of the cloud service endpoints that are associated with your VPC, including their source IP address and zone.
    defaultAddressPrefixes {[key: string]: string}
    (Map) A map of default address prefixes for each zone in the VPC. The keys are the zone names, and the values are the corresponding address prefixes. Example:

    import * as pulumi from "@pulumi/pulumi";
    
    import pulumi
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    

    return await Deployment.RunAsync(() => { });

    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		return nil
    	})
    }
    
    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) {
        }
    }
    
    {}
    
    title=""> <span id="defaultnetworkacl_nodejs">

    defaultNetworkAcl string

    (String) The default network ACL ID created and attached to the VPC.
    defaultNetworkAclCrn string
    (String) CRN of the default network ACL ID created and attached to the VPC.
    defaultRoutingTable string
    (String) The unique identifier of the VPC default routing table.
    defaultRoutingTableCrn string
    (String) CRN of the default routing table.
    defaultSecurityGroup string
    (String) The default security group ID created and attached to the VPC.
    defaultSecurityGroupCrn string
    (String) CRN of the default security group created and attached to the VPC.
    healthReasons IsVpcHealthReason[]
    (List) The reasons for the current health_state (if any).The enumerated reason code values for this property will expand in the future. When processing this property, check for and log unknown values. Optionally halt processing and surface the error, or bypass the resource on which the unexpected reason code was encountered. Nested schema for health_reasons:
    healthState string
    (String) The health of this resource.- ok: No abnormal behavior detected- degraded: Experiencing compromised performance, capacity, or connectivity- faulted: Completely unreachable, inoperative, or otherwise entirely incapacitated- inapplicable: The health state does not apply because of the current lifecycle state. A resource with a lifecycle state of failed or deleting will have a health state of inapplicable. A pending resource may also have this state.[degraded, faulted, inapplicable, ok]
    id string
    The provider-assigned unique ID for this managed resource.
    resourceControllerUrl string
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    resourceCrn string
    The crn of the resource
    resourceGroupName string
    The resource group name in which resource is provisioned
    resourceName string
    The name of the resource
    resourceStatus string
    The status of the resource
    securityGroups IsVpcSecurityGroup[]
    (List) A list of security groups attached to VPC.
    status string
    (String) The provisioning status of your VPC.
    subnets IsVpcSubnet[]
    (List of Strings) A list of subnets that are attached to a VPC.

    crn str
    (String) The CRN of the VPC.
    cse_source_addresses Sequence[IsVpcCseSourceAddress]
    (List) A list of the cloud service endpoints that are associated with your VPC, including their source IP address and zone.
    default_address_prefixes Mapping[str, str]
    (Map) A map of default address prefixes for each zone in the VPC. The keys are the zone names, and the values are the corresponding address prefixes. Example:

    import * as pulumi from "@pulumi/pulumi";
    
    import pulumi
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    

    return await Deployment.RunAsync(() => { });

    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		return nil
    	})
    }
    
    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) {
        }
    }
    
    {}
    
    title=""> <span id="default_network_acl_python">

    default_network_acl str

    (String) The default network ACL ID created and attached to the VPC.
    default_network_acl_crn str
    (String) CRN of the default network ACL ID created and attached to the VPC.
    default_routing_table str
    (String) The unique identifier of the VPC default routing table.
    default_routing_table_crn str
    (String) CRN of the default routing table.
    default_security_group str
    (String) The default security group ID created and attached to the VPC.
    default_security_group_crn str
    (String) CRN of the default security group created and attached to the VPC.
    health_reasons Sequence[IsVpcHealthReason]
    (List) The reasons for the current health_state (if any).The enumerated reason code values for this property will expand in the future. When processing this property, check for and log unknown values. Optionally halt processing and surface the error, or bypass the resource on which the unexpected reason code was encountered. Nested schema for health_reasons:
    health_state str
    (String) The health of this resource.- ok: No abnormal behavior detected- degraded: Experiencing compromised performance, capacity, or connectivity- faulted: Completely unreachable, inoperative, or otherwise entirely incapacitated- inapplicable: The health state does not apply because of the current lifecycle state. A resource with a lifecycle state of failed or deleting will have a health state of inapplicable. A pending resource may also have this state.[degraded, faulted, inapplicable, ok]
    id str
    The provider-assigned unique ID for this managed resource.
    resource_controller_url str
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    resource_crn str
    The crn of the resource
    resource_group_name str
    The resource group name in which resource is provisioned
    resource_name str
    The name of the resource
    resource_status str
    The status of the resource
    security_groups Sequence[IsVpcSecurityGroup]
    (List) A list of security groups attached to VPC.
    status str
    (String) The provisioning status of your VPC.
    subnets Sequence[IsVpcSubnet]
    (List of Strings) A list of subnets that are attached to a VPC.

    crn String
    (String) The CRN of the VPC.
    cseSourceAddresses List<Property Map>
    (List) A list of the cloud service endpoints that are associated with your VPC, including their source IP address and zone.
    defaultAddressPrefixes Map<String>
    (Map) A map of default address prefixes for each zone in the VPC. The keys are the zone names, and the values are the corresponding address prefixes. Example:

    import * as pulumi from "@pulumi/pulumi";
    
    import pulumi
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    

    return await Deployment.RunAsync(() => { });

    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		return nil
    	})
    }
    
    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) {
        }
    }
    
    {}
    
    title=""> <span id="defaultnetworkacl_yaml">

    defaultNetworkAcl String

    (String) The default network ACL ID created and attached to the VPC.
    defaultNetworkAclCrn String
    (String) CRN of the default network ACL ID created and attached to the VPC.
    defaultRoutingTable String
    (String) The unique identifier of the VPC default routing table.
    defaultRoutingTableCrn String
    (String) CRN of the default routing table.
    defaultSecurityGroup String
    (String) The default security group ID created and attached to the VPC.
    defaultSecurityGroupCrn String
    (String) CRN of the default security group created and attached to the VPC.
    healthReasons List<Property Map>
    (List) The reasons for the current health_state (if any).The enumerated reason code values for this property will expand in the future. When processing this property, check for and log unknown values. Optionally halt processing and surface the error, or bypass the resource on which the unexpected reason code was encountered. Nested schema for health_reasons:
    healthState String
    (String) The health of this resource.- ok: No abnormal behavior detected- degraded: Experiencing compromised performance, capacity, or connectivity- faulted: Completely unreachable, inoperative, or otherwise entirely incapacitated- inapplicable: The health state does not apply because of the current lifecycle state. A resource with a lifecycle state of failed or deleting will have a health state of inapplicable. A pending resource may also have this state.[degraded, faulted, inapplicable, ok]
    id String
    The provider-assigned unique ID for this managed resource.
    resourceControllerUrl String
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    resourceCrn String
    The crn of the resource
    resourceGroupName String
    The resource group name in which resource is provisioned
    resourceName String
    The name of the resource
    resourceStatus String
    The status of the resource
    securityGroups List<Property Map>
    (List) A list of security groups attached to VPC.
    status String
    (String) The provisioning status of your VPC.
    subnets List<Property Map>
    (List of Strings) A list of subnets that are attached to a VPC.

    Look up Existing IsVpc Resource

    Get an existing IsVpc 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?: IsVpcState, opts?: CustomResourceOptions): IsVpc
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            access_tags: Optional[Sequence[str]] = None,
            address_prefix_management: Optional[str] = None,
            classic_access: Optional[bool] = None,
            crn: Optional[str] = None,
            cse_source_addresses: Optional[Sequence[IsVpcCseSourceAddressArgs]] = None,
            default_address_prefixes: Optional[Mapping[str, str]] = None,
            default_network_acl: Optional[str] = None,
            default_network_acl_crn: Optional[str] = None,
            default_network_acl_name: Optional[str] = None,
            default_routing_table: Optional[str] = None,
            default_routing_table_crn: Optional[str] = None,
            default_routing_table_name: Optional[str] = None,
            default_security_group: Optional[str] = None,
            default_security_group_crn: Optional[str] = None,
            default_security_group_name: Optional[str] = None,
            dns: Optional[IsVpcDnsArgs] = None,
            health_reasons: Optional[Sequence[IsVpcHealthReasonArgs]] = None,
            health_state: Optional[str] = None,
            is_vpc_id: Optional[str] = None,
            name: Optional[str] = None,
            no_sg_acl_rules: Optional[bool] = None,
            resource_controller_url: Optional[str] = None,
            resource_crn: Optional[str] = None,
            resource_group: Optional[str] = None,
            resource_group_name: Optional[str] = None,
            resource_name: Optional[str] = None,
            resource_status: Optional[str] = None,
            security_groups: Optional[Sequence[IsVpcSecurityGroupArgs]] = None,
            status: Optional[str] = None,
            subnets: Optional[Sequence[IsVpcSubnetArgs]] = None,
            tags: Optional[Sequence[str]] = None,
            timeouts: Optional[IsVpcTimeoutsArgs] = None) -> IsVpc
    func GetIsVpc(ctx *Context, name string, id IDInput, state *IsVpcState, opts ...ResourceOption) (*IsVpc, error)
    public static IsVpc Get(string name, Input<string> id, IsVpcState? state, CustomResourceOptions? opts = null)
    public static IsVpc get(String name, Output<String> id, IsVpcState state, CustomResourceOptions options)
    resources:  _:    type: ibm:IsVpc    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:
    AccessTags List<string>

    A list of access management tags to attach to the bare metal server.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    AddressPrefixManagement string
    Indicates whether a default address prefix should be created automatically auto or manually manual for each zone in this VPC. Default value is auto.
    ClassicAccess bool

    Specify if you want to create a VPC that can connect to classic infrastructure resources. Enter true to set up private network connectivity from your VPC to classic infrastructure resources that are created in the same IBM Cloud account, and false to disable this access. If you choose to not set up this access, you cannot enable it after the VPC is created. Make sure to review the prerequisites before you create a VPC with classic infrastructure access. Note that you can enable one VPC for classic infrastructure access per IBM Cloud account only.

    Note: classic_access is deprecated. Use Transit Gateway with Classic as a spoke/connection.

    Deprecated: Deprecated

    Crn string
    (String) The CRN of the VPC.
    CseSourceAddresses List<IsVpcCseSourceAddress>
    (List) A list of the cloud service endpoints that are associated with your VPC, including their source IP address and zone.
    DefaultAddressPrefixes Dictionary<string, string>
    (Map) A map of default address prefixes for each zone in the VPC. The keys are the zone names, and the values are the corresponding address prefixes. Example:

    import * as pulumi from "@pulumi/pulumi";
    
    import pulumi
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    

    return await Deployment.RunAsync(() => { });

    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		return nil
    	})
    }
    
    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) {
        }
    }
    
    {}
    
    title="Optional"> <span id="state_defaultnetworkacl_csharp">

    DefaultNetworkAcl string

    (String) The default network ACL ID created and attached to the VPC.
    DefaultNetworkAclCrn string
    (String) CRN of the default network ACL ID created and attached to the VPC.
    DefaultNetworkAclName string
    Enter the name of the default network access control list (ACL).
    DefaultRoutingTable string
    (String) The unique identifier of the VPC default routing table.
    DefaultRoutingTableCrn string
    (String) CRN of the default routing table.
    DefaultRoutingTableName string
    Enter the name of the default routing table.
    DefaultSecurityGroup string
    (String) The default security group ID created and attached to the VPC.
    DefaultSecurityGroupCrn string
    (String) CRN of the default security group created and attached to the VPC.
    DefaultSecurityGroupName string
    Enter the name of the default security group.
    Dns IsVpcDns

    The DNS configuration for this VPC.

    Nested scheme for dns:

    HealthReasons List<IsVpcHealthReason>
    (List) The reasons for the current health_state (if any).The enumerated reason code values for this property will expand in the future. When processing this property, check for and log unknown values. Optionally halt processing and surface the error, or bypass the resource on which the unexpected reason code was encountered. Nested schema for health_reasons:
    HealthState string
    (String) The health of this resource.- ok: No abnormal behavior detected- degraded: Experiencing compromised performance, capacity, or connectivity- faulted: Completely unreachable, inoperative, or otherwise entirely incapacitated- inapplicable: The health state does not apply because of the current lifecycle state. A resource with a lifecycle state of failed or deleting will have a health state of inapplicable. A pending resource may also have this state.[degraded, faulted, inapplicable, ok]
    IsVpcId string
    (String) The ID of the subnet.
    Name string
    Enter a name for your VPC. No.
    NoSgAclRules bool
    If set to true, delete all rules attached to default security group and default network ACL for a new VPC. This attribute has no impact on update. default false.
    ResourceControllerUrl string
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    ResourceCrn string
    The crn of the resource
    ResourceGroup string
    Enter the ID of the resource group where you want to create the VPC. To list available resource groups, run ibmcloud resource groups. If you do not specify a resource group, the VPC is created in the default resource group.
    ResourceGroupName string
    The resource group name in which resource is provisioned
    ResourceName string
    The name of the resource
    ResourceStatus string
    The status of the resource
    SecurityGroups List<IsVpcSecurityGroup>
    (List) A list of security groups attached to VPC.
    Status string
    (String) The provisioning status of your VPC.
    Subnets List<IsVpcSubnet>
    (List of Strings) A list of subnets that are attached to a VPC.
    Tags List<string>
    Enter any tags that you want to associate with your VPC. Tags might help you find your VPC more easily after it is created. Separate multiple tags with a comma (,).
    Timeouts IsVpcTimeouts
    AccessTags []string

    A list of access management tags to attach to the bare metal server.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    AddressPrefixManagement string
    Indicates whether a default address prefix should be created automatically auto or manually manual for each zone in this VPC. Default value is auto.
    ClassicAccess bool

    Specify if you want to create a VPC that can connect to classic infrastructure resources. Enter true to set up private network connectivity from your VPC to classic infrastructure resources that are created in the same IBM Cloud account, and false to disable this access. If you choose to not set up this access, you cannot enable it after the VPC is created. Make sure to review the prerequisites before you create a VPC with classic infrastructure access. Note that you can enable one VPC for classic infrastructure access per IBM Cloud account only.

    Note: classic_access is deprecated. Use Transit Gateway with Classic as a spoke/connection.

    Deprecated: Deprecated

    Crn string
    (String) The CRN of the VPC.
    CseSourceAddresses []IsVpcCseSourceAddressArgs
    (List) A list of the cloud service endpoints that are associated with your VPC, including their source IP address and zone.
    DefaultAddressPrefixes map[string]string
    (Map) A map of default address prefixes for each zone in the VPC. The keys are the zone names, and the values are the corresponding address prefixes. Example:

    import * as pulumi from "@pulumi/pulumi";
    
    import pulumi
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    

    return await Deployment.RunAsync(() => { });

    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		return nil
    	})
    }
    
    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) {
        }
    }
    
    {}
    
    title="Optional"> <span id="state_defaultnetworkacl_go">

    DefaultNetworkAcl string

    (String) The default network ACL ID created and attached to the VPC.
    DefaultNetworkAclCrn string
    (String) CRN of the default network ACL ID created and attached to the VPC.
    DefaultNetworkAclName string
    Enter the name of the default network access control list (ACL).
    DefaultRoutingTable string
    (String) The unique identifier of the VPC default routing table.
    DefaultRoutingTableCrn string
    (String) CRN of the default routing table.
    DefaultRoutingTableName string
    Enter the name of the default routing table.
    DefaultSecurityGroup string
    (String) The default security group ID created and attached to the VPC.
    DefaultSecurityGroupCrn string
    (String) CRN of the default security group created and attached to the VPC.
    DefaultSecurityGroupName string
    Enter the name of the default security group.
    Dns IsVpcDnsArgs

    The DNS configuration for this VPC.

    Nested scheme for dns:

    HealthReasons []IsVpcHealthReasonArgs
    (List) The reasons for the current health_state (if any).The enumerated reason code values for this property will expand in the future. When processing this property, check for and log unknown values. Optionally halt processing and surface the error, or bypass the resource on which the unexpected reason code was encountered. Nested schema for health_reasons:
    HealthState string
    (String) The health of this resource.- ok: No abnormal behavior detected- degraded: Experiencing compromised performance, capacity, or connectivity- faulted: Completely unreachable, inoperative, or otherwise entirely incapacitated- inapplicable: The health state does not apply because of the current lifecycle state. A resource with a lifecycle state of failed or deleting will have a health state of inapplicable. A pending resource may also have this state.[degraded, faulted, inapplicable, ok]
    IsVpcId string
    (String) The ID of the subnet.
    Name string
    Enter a name for your VPC. No.
    NoSgAclRules bool
    If set to true, delete all rules attached to default security group and default network ACL for a new VPC. This attribute has no impact on update. default false.
    ResourceControllerUrl string
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    ResourceCrn string
    The crn of the resource
    ResourceGroup string
    Enter the ID of the resource group where you want to create the VPC. To list available resource groups, run ibmcloud resource groups. If you do not specify a resource group, the VPC is created in the default resource group.
    ResourceGroupName string
    The resource group name in which resource is provisioned
    ResourceName string
    The name of the resource
    ResourceStatus string
    The status of the resource
    SecurityGroups []IsVpcSecurityGroupArgs
    (List) A list of security groups attached to VPC.
    Status string
    (String) The provisioning status of your VPC.
    Subnets []IsVpcSubnetArgs
    (List of Strings) A list of subnets that are attached to a VPC.
    Tags []string
    Enter any tags that you want to associate with your VPC. Tags might help you find your VPC more easily after it is created. Separate multiple tags with a comma (,).
    Timeouts IsVpcTimeoutsArgs
    accessTags List<String>

    A list of access management tags to attach to the bare metal server.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    addressPrefixManagement String
    Indicates whether a default address prefix should be created automatically auto or manually manual for each zone in this VPC. Default value is auto.
    classicAccess Boolean

    Specify if you want to create a VPC that can connect to classic infrastructure resources. Enter true to set up private network connectivity from your VPC to classic infrastructure resources that are created in the same IBM Cloud account, and false to disable this access. If you choose to not set up this access, you cannot enable it after the VPC is created. Make sure to review the prerequisites before you create a VPC with classic infrastructure access. Note that you can enable one VPC for classic infrastructure access per IBM Cloud account only.

    Note: classic_access is deprecated. Use Transit Gateway with Classic as a spoke/connection.

    Deprecated: Deprecated

    crn String
    (String) The CRN of the VPC.
    cseSourceAddresses List<IsVpcCseSourceAddress>
    (List) A list of the cloud service endpoints that are associated with your VPC, including their source IP address and zone.
    defaultAddressPrefixes Map<String,String>
    (Map) A map of default address prefixes for each zone in the VPC. The keys are the zone names, and the values are the corresponding address prefixes. Example:

    import * as pulumi from "@pulumi/pulumi";
    
    import pulumi
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    

    return await Deployment.RunAsync(() => { });

    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		return nil
    	})
    }
    
    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) {
        }
    }
    
    {}
    
    title="Optional"> <span id="state_defaultnetworkacl_java">

    defaultNetworkAcl String

    (String) The default network ACL ID created and attached to the VPC.
    defaultNetworkAclCrn String
    (String) CRN of the default network ACL ID created and attached to the VPC.
    defaultNetworkAclName String
    Enter the name of the default network access control list (ACL).
    defaultRoutingTable String
    (String) The unique identifier of the VPC default routing table.
    defaultRoutingTableCrn String
    (String) CRN of the default routing table.
    defaultRoutingTableName String
    Enter the name of the default routing table.
    defaultSecurityGroup String
    (String) The default security group ID created and attached to the VPC.
    defaultSecurityGroupCrn String
    (String) CRN of the default security group created and attached to the VPC.
    defaultSecurityGroupName String
    Enter the name of the default security group.
    dns IsVpcDns

    The DNS configuration for this VPC.

    Nested scheme for dns:

    healthReasons List<IsVpcHealthReason>
    (List) The reasons for the current health_state (if any).The enumerated reason code values for this property will expand in the future. When processing this property, check for and log unknown values. Optionally halt processing and surface the error, or bypass the resource on which the unexpected reason code was encountered. Nested schema for health_reasons:
    healthState String
    (String) The health of this resource.- ok: No abnormal behavior detected- degraded: Experiencing compromised performance, capacity, or connectivity- faulted: Completely unreachable, inoperative, or otherwise entirely incapacitated- inapplicable: The health state does not apply because of the current lifecycle state. A resource with a lifecycle state of failed or deleting will have a health state of inapplicable. A pending resource may also have this state.[degraded, faulted, inapplicable, ok]
    isVpcId String
    (String) The ID of the subnet.
    name String
    Enter a name for your VPC. No.
    noSgAclRules Boolean
    If set to true, delete all rules attached to default security group and default network ACL for a new VPC. This attribute has no impact on update. default false.
    resourceControllerUrl String
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    resourceCrn String
    The crn of the resource
    resourceGroup String
    Enter the ID of the resource group where you want to create the VPC. To list available resource groups, run ibmcloud resource groups. If you do not specify a resource group, the VPC is created in the default resource group.
    resourceGroupName String
    The resource group name in which resource is provisioned
    resourceName String
    The name of the resource
    resourceStatus String
    The status of the resource
    securityGroups List<IsVpcSecurityGroup>
    (List) A list of security groups attached to VPC.
    status String
    (String) The provisioning status of your VPC.
    subnets List<IsVpcSubnet>
    (List of Strings) A list of subnets that are attached to a VPC.
    tags List<String>
    Enter any tags that you want to associate with your VPC. Tags might help you find your VPC more easily after it is created. Separate multiple tags with a comma (,).
    timeouts IsVpcTimeouts
    accessTags string[]

    A list of access management tags to attach to the bare metal server.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    addressPrefixManagement string
    Indicates whether a default address prefix should be created automatically auto or manually manual for each zone in this VPC. Default value is auto.
    classicAccess boolean

    Specify if you want to create a VPC that can connect to classic infrastructure resources. Enter true to set up private network connectivity from your VPC to classic infrastructure resources that are created in the same IBM Cloud account, and false to disable this access. If you choose to not set up this access, you cannot enable it after the VPC is created. Make sure to review the prerequisites before you create a VPC with classic infrastructure access. Note that you can enable one VPC for classic infrastructure access per IBM Cloud account only.

    Note: classic_access is deprecated. Use Transit Gateway with Classic as a spoke/connection.

    Deprecated: Deprecated

    crn string
    (String) The CRN of the VPC.
    cseSourceAddresses IsVpcCseSourceAddress[]
    (List) A list of the cloud service endpoints that are associated with your VPC, including their source IP address and zone.
    defaultAddressPrefixes {[key: string]: string}
    (Map) A map of default address prefixes for each zone in the VPC. The keys are the zone names, and the values are the corresponding address prefixes. Example:

    import * as pulumi from "@pulumi/pulumi";
    
    import pulumi
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    

    return await Deployment.RunAsync(() => { });

    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		return nil
    	})
    }
    
    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) {
        }
    }
    
    {}
    
    title="Optional"> <span id="state_defaultnetworkacl_nodejs">

    defaultNetworkAcl string

    (String) The default network ACL ID created and attached to the VPC.
    defaultNetworkAclCrn string
    (String) CRN of the default network ACL ID created and attached to the VPC.
    defaultNetworkAclName string
    Enter the name of the default network access control list (ACL).
    defaultRoutingTable string
    (String) The unique identifier of the VPC default routing table.
    defaultRoutingTableCrn string
    (String) CRN of the default routing table.
    defaultRoutingTableName string
    Enter the name of the default routing table.
    defaultSecurityGroup string
    (String) The default security group ID created and attached to the VPC.
    defaultSecurityGroupCrn string
    (String) CRN of the default security group created and attached to the VPC.
    defaultSecurityGroupName string
    Enter the name of the default security group.
    dns IsVpcDns

    The DNS configuration for this VPC.

    Nested scheme for dns:

    healthReasons IsVpcHealthReason[]
    (List) The reasons for the current health_state (if any).The enumerated reason code values for this property will expand in the future. When processing this property, check for and log unknown values. Optionally halt processing and surface the error, or bypass the resource on which the unexpected reason code was encountered. Nested schema for health_reasons:
    healthState string
    (String) The health of this resource.- ok: No abnormal behavior detected- degraded: Experiencing compromised performance, capacity, or connectivity- faulted: Completely unreachable, inoperative, or otherwise entirely incapacitated- inapplicable: The health state does not apply because of the current lifecycle state. A resource with a lifecycle state of failed or deleting will have a health state of inapplicable. A pending resource may also have this state.[degraded, faulted, inapplicable, ok]
    isVpcId string
    (String) The ID of the subnet.
    name string
    Enter a name for your VPC. No.
    noSgAclRules boolean
    If set to true, delete all rules attached to default security group and default network ACL for a new VPC. This attribute has no impact on update. default false.
    resourceControllerUrl string
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    resourceCrn string
    The crn of the resource
    resourceGroup string
    Enter the ID of the resource group where you want to create the VPC. To list available resource groups, run ibmcloud resource groups. If you do not specify a resource group, the VPC is created in the default resource group.
    resourceGroupName string
    The resource group name in which resource is provisioned
    resourceName string
    The name of the resource
    resourceStatus string
    The status of the resource
    securityGroups IsVpcSecurityGroup[]
    (List) A list of security groups attached to VPC.
    status string
    (String) The provisioning status of your VPC.
    subnets IsVpcSubnet[]
    (List of Strings) A list of subnets that are attached to a VPC.
    tags string[]
    Enter any tags that you want to associate with your VPC. Tags might help you find your VPC more easily after it is created. Separate multiple tags with a comma (,).
    timeouts IsVpcTimeouts
    access_tags Sequence[str]

    A list of access management tags to attach to the bare metal server.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    address_prefix_management str
    Indicates whether a default address prefix should be created automatically auto or manually manual for each zone in this VPC. Default value is auto.
    classic_access bool

    Specify if you want to create a VPC that can connect to classic infrastructure resources. Enter true to set up private network connectivity from your VPC to classic infrastructure resources that are created in the same IBM Cloud account, and false to disable this access. If you choose to not set up this access, you cannot enable it after the VPC is created. Make sure to review the prerequisites before you create a VPC with classic infrastructure access. Note that you can enable one VPC for classic infrastructure access per IBM Cloud account only.

    Note: classic_access is deprecated. Use Transit Gateway with Classic as a spoke/connection.

    Deprecated: Deprecated

    crn str
    (String) The CRN of the VPC.
    cse_source_addresses Sequence[IsVpcCseSourceAddressArgs]
    (List) A list of the cloud service endpoints that are associated with your VPC, including their source IP address and zone.
    default_address_prefixes Mapping[str, str]
    (Map) A map of default address prefixes for each zone in the VPC. The keys are the zone names, and the values are the corresponding address prefixes. Example:

    import * as pulumi from "@pulumi/pulumi";
    
    import pulumi
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    

    return await Deployment.RunAsync(() => { });

    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		return nil
    	})
    }
    
    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) {
        }
    }
    
    {}
    
    title="Optional"> <span id="state_default_network_acl_python">

    default_network_acl str

    (String) The default network ACL ID created and attached to the VPC.
    default_network_acl_crn str
    (String) CRN of the default network ACL ID created and attached to the VPC.
    default_network_acl_name str
    Enter the name of the default network access control list (ACL).
    default_routing_table str
    (String) The unique identifier of the VPC default routing table.
    default_routing_table_crn str
    (String) CRN of the default routing table.
    default_routing_table_name str
    Enter the name of the default routing table.
    default_security_group str
    (String) The default security group ID created and attached to the VPC.
    default_security_group_crn str
    (String) CRN of the default security group created and attached to the VPC.
    default_security_group_name str
    Enter the name of the default security group.
    dns IsVpcDnsArgs

    The DNS configuration for this VPC.

    Nested scheme for dns:

    health_reasons Sequence[IsVpcHealthReasonArgs]
    (List) The reasons for the current health_state (if any).The enumerated reason code values for this property will expand in the future. When processing this property, check for and log unknown values. Optionally halt processing and surface the error, or bypass the resource on which the unexpected reason code was encountered. Nested schema for health_reasons:
    health_state str
    (String) The health of this resource.- ok: No abnormal behavior detected- degraded: Experiencing compromised performance, capacity, or connectivity- faulted: Completely unreachable, inoperative, or otherwise entirely incapacitated- inapplicable: The health state does not apply because of the current lifecycle state. A resource with a lifecycle state of failed or deleting will have a health state of inapplicable. A pending resource may also have this state.[degraded, faulted, inapplicable, ok]
    is_vpc_id str
    (String) The ID of the subnet.
    name str
    Enter a name for your VPC. No.
    no_sg_acl_rules bool
    If set to true, delete all rules attached to default security group and default network ACL for a new VPC. This attribute has no impact on update. default false.
    resource_controller_url str
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    resource_crn str
    The crn of the resource
    resource_group str
    Enter the ID of the resource group where you want to create the VPC. To list available resource groups, run ibmcloud resource groups. If you do not specify a resource group, the VPC is created in the default resource group.
    resource_group_name str
    The resource group name in which resource is provisioned
    resource_name str
    The name of the resource
    resource_status str
    The status of the resource
    security_groups Sequence[IsVpcSecurityGroupArgs]
    (List) A list of security groups attached to VPC.
    status str
    (String) The provisioning status of your VPC.
    subnets Sequence[IsVpcSubnetArgs]
    (List of Strings) A list of subnets that are attached to a VPC.
    tags Sequence[str]
    Enter any tags that you want to associate with your VPC. Tags might help you find your VPC more easily after it is created. Separate multiple tags with a comma (,).
    timeouts IsVpcTimeoutsArgs
    accessTags List<String>

    A list of access management tags to attach to the bare metal server.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    addressPrefixManagement String
    Indicates whether a default address prefix should be created automatically auto or manually manual for each zone in this VPC. Default value is auto.
    classicAccess Boolean

    Specify if you want to create a VPC that can connect to classic infrastructure resources. Enter true to set up private network connectivity from your VPC to classic infrastructure resources that are created in the same IBM Cloud account, and false to disable this access. If you choose to not set up this access, you cannot enable it after the VPC is created. Make sure to review the prerequisites before you create a VPC with classic infrastructure access. Note that you can enable one VPC for classic infrastructure access per IBM Cloud account only.

    Note: classic_access is deprecated. Use Transit Gateway with Classic as a spoke/connection.

    Deprecated: Deprecated

    crn String
    (String) The CRN of the VPC.
    cseSourceAddresses List<Property Map>
    (List) A list of the cloud service endpoints that are associated with your VPC, including their source IP address and zone.
    defaultAddressPrefixes Map<String>
    (Map) A map of default address prefixes for each zone in the VPC. The keys are the zone names, and the values are the corresponding address prefixes. Example:

    import * as pulumi from "@pulumi/pulumi";
    
    import pulumi
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    

    return await Deployment.RunAsync(() => { });

    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		return nil
    	})
    }
    
    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) {
        }
    }
    
    {}
    
    title="Optional"> <span id="state_defaultnetworkacl_yaml">

    defaultNetworkAcl String

    (String) The default network ACL ID created and attached to the VPC.
    defaultNetworkAclCrn String
    (String) CRN of the default network ACL ID created and attached to the VPC.
    defaultNetworkAclName String
    Enter the name of the default network access control list (ACL).
    defaultRoutingTable String
    (String) The unique identifier of the VPC default routing table.
    defaultRoutingTableCrn String
    (String) CRN of the default routing table.
    defaultRoutingTableName String
    Enter the name of the default routing table.
    defaultSecurityGroup String
    (String) The default security group ID created and attached to the VPC.
    defaultSecurityGroupCrn String
    (String) CRN of the default security group created and attached to the VPC.
    defaultSecurityGroupName String
    Enter the name of the default security group.
    dns Property Map

    The DNS configuration for this VPC.

    Nested scheme for dns:

    healthReasons List<Property Map>
    (List) The reasons for the current health_state (if any).The enumerated reason code values for this property will expand in the future. When processing this property, check for and log unknown values. Optionally halt processing and surface the error, or bypass the resource on which the unexpected reason code was encountered. Nested schema for health_reasons:
    healthState String
    (String) The health of this resource.- ok: No abnormal behavior detected- degraded: Experiencing compromised performance, capacity, or connectivity- faulted: Completely unreachable, inoperative, or otherwise entirely incapacitated- inapplicable: The health state does not apply because of the current lifecycle state. A resource with a lifecycle state of failed or deleting will have a health state of inapplicable. A pending resource may also have this state.[degraded, faulted, inapplicable, ok]
    isVpcId String
    (String) The ID of the subnet.
    name String
    Enter a name for your VPC. No.
    noSgAclRules Boolean
    If set to true, delete all rules attached to default security group and default network ACL for a new VPC. This attribute has no impact on update. default false.
    resourceControllerUrl String
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    resourceCrn String
    The crn of the resource
    resourceGroup String
    Enter the ID of the resource group where you want to create the VPC. To list available resource groups, run ibmcloud resource groups. If you do not specify a resource group, the VPC is created in the default resource group.
    resourceGroupName String
    The resource group name in which resource is provisioned
    resourceName String
    The name of the resource
    resourceStatus String
    The status of the resource
    securityGroups List<Property Map>
    (List) A list of security groups attached to VPC.
    status String
    (String) The provisioning status of your VPC.
    subnets List<Property Map>
    (List of Strings) A list of subnets that are attached to a VPC.
    tags List<String>
    Enter any tags that you want to associate with your VPC. Tags might help you find your VPC more easily after it is created. Separate multiple tags with a comma (,).
    timeouts Property Map

    Supporting Types

    IsVpcCseSourceAddress, IsVpcCseSourceAddressArgs

    Address string
    (String) The IP address of the cloud service endpoint.
    ZoneName string
    (String) The zone where the cloud service endpoint is located.
    Address string
    (String) The IP address of the cloud service endpoint.
    ZoneName string
    (String) The zone where the cloud service endpoint is located.
    address String
    (String) The IP address of the cloud service endpoint.
    zoneName String
    (String) The zone where the cloud service endpoint is located.
    address string
    (String) The IP address of the cloud service endpoint.
    zoneName string
    (String) The zone where the cloud service endpoint is located.
    address str
    (String) The IP address of the cloud service endpoint.
    zone_name str
    (String) The zone where the cloud service endpoint is located.
    address String
    (String) The IP address of the cloud service endpoint.
    zoneName String
    (String) The zone where the cloud service endpoint is located.

    IsVpcDns, IsVpcDnsArgs

    EnableHub bool
    Indicates whether this VPC is enabled as a DNS name resolution hub.
    ResolutionBindingCount double
    The number of DNS resolution bindings for this VPC.
    Resolver IsVpcDnsResolver
    The zone list this backup policy plan will create snapshot clones in. Nested scheme for resolver:
    EnableHub bool
    Indicates whether this VPC is enabled as a DNS name resolution hub.
    ResolutionBindingCount float64
    The number of DNS resolution bindings for this VPC.
    Resolver IsVpcDnsResolver
    The zone list this backup policy plan will create snapshot clones in. Nested scheme for resolver:
    enableHub Boolean
    Indicates whether this VPC is enabled as a DNS name resolution hub.
    resolutionBindingCount Double
    The number of DNS resolution bindings for this VPC.
    resolver IsVpcDnsResolver
    The zone list this backup policy plan will create snapshot clones in. Nested scheme for resolver:
    enableHub boolean
    Indicates whether this VPC is enabled as a DNS name resolution hub.
    resolutionBindingCount number
    The number of DNS resolution bindings for this VPC.
    resolver IsVpcDnsResolver
    The zone list this backup policy plan will create snapshot clones in. Nested scheme for resolver:
    enable_hub bool
    Indicates whether this VPC is enabled as a DNS name resolution hub.
    resolution_binding_count float
    The number of DNS resolution bindings for this VPC.
    resolver IsVpcDnsResolver
    The zone list this backup policy plan will create snapshot clones in. Nested scheme for resolver:
    enableHub Boolean
    Indicates whether this VPC is enabled as a DNS name resolution hub.
    resolutionBindingCount Number
    The number of DNS resolution bindings for this VPC.
    resolver Property Map
    The zone list this backup policy plan will create snapshot clones in. Nested scheme for resolver:

    IsVpcDnsResolver, IsVpcDnsResolverArgs

    Configuration string
    The configuration of the system DNS resolver for this VPC.- custom_resolver: A custom DNS resolver is configured for this VPC.- private_resolver: A private DNS resolver is configured for this VPC. Applicable when the VPC has either or both of the following: - at least one endpoint gateway residing in it - a DNS Services private zone configured for it- default: The provider default DNS resolvers are configured for this VPC. This system DNS resolver configuration is used when the VPC has: - no custom DNS resolver configured for it, and - no endpoint gateways residing in it, and - no DNS Services private zone configured for it.
    DnsBindingId string
    The VPC dns binding id whose DNS resolver provides the DNS server addresses for this VPC. (If any)
    DnsBindingName string

    The VPC dns binding name whose DNS resolver provides the DNS server addresses for this VPC. Only applicable for delegated, providing value would create binding with this name. Providing "null" as name, would remove the binding.

    Note: manual_servers must be set if and only if dns.resolver.type is manual.

    ManualServers List<IsVpcDnsResolverManualServer>

    The DNS servers to use for this VPC, replacing any existing servers. All the DNS servers must either: have a unique zone_affinity, or not have a zone_affinity.

    Nested schema for manual_servers:

    Servers List<IsVpcDnsResolverServer>
    The DNS servers for this VPC. The servers are populated:- by the system when dns.resolver.type is system- using the DNS servers in dns.resolver.vpc when dns.resolver.type is delegated- using dns.resolver.manual_servers when the dns.resolver.type is manual.
    Type string

    The type of the DNS resolver to use. To update the resolver type, specify the type explicitly.

    Note: delegated: DNS server addresses will be provided by the resolver for the VPC specified in dns.resolver.vpc. Requires dns.enable_hub to be false. manual: DNS server addresses are specified in manual_servers. system: DNS server addresses will be provided by the system and depend on the configuration.

    Note: Updating from manual requires dns resolver manual_servers to be specified as null. Updating to manual requires dns resolver manual_servers to be specified and not empty. Updating from delegated requires dns.resolver.vpc to be specified as null. If type is delegated while creation then vpc_id is required

    VpcCrn string

    (update only) The VPC CRN to provide DNS server addresses for this VPC. The specified VPC must be configured with a DNS Services custom resolver and must be in one of this VPC's DNS resolution bindings. Mutually exclusive with vpc_id

    Note: Specify "null" string to remove an existing VPC. This property must be set if and only if dns resolver type is delegated.

    VpcId string

    (update only) The VPC ID to provide DNS server addresses for this VPC. The specified VPC must be configured with a DNS Services custom resolver and must be in one of this VPC's DNS resolution bindings. Mutually exclusive with vpc_crn

    Note: Specify "null" string to remove an existing VPC. This property must be set if and only if dns resolver type is delegated.

    VpcName string
    The VPC name whose DNS resolver provides the DNS server addresses for this VPC.The VPC may be remote and therefore may not be directly retrievable.
    VpcRemoteAccountId string
    The unique identifier for this account.
    VpcRemoteRegion string
    Region name. If present, this property indicates that the referenced resource is remote to this region, and identifies the native region.
    Configuration string
    The configuration of the system DNS resolver for this VPC.- custom_resolver: A custom DNS resolver is configured for this VPC.- private_resolver: A private DNS resolver is configured for this VPC. Applicable when the VPC has either or both of the following: - at least one endpoint gateway residing in it - a DNS Services private zone configured for it- default: The provider default DNS resolvers are configured for this VPC. This system DNS resolver configuration is used when the VPC has: - no custom DNS resolver configured for it, and - no endpoint gateways residing in it, and - no DNS Services private zone configured for it.
    DnsBindingId string
    The VPC dns binding id whose DNS resolver provides the DNS server addresses for this VPC. (If any)
    DnsBindingName string

    The VPC dns binding name whose DNS resolver provides the DNS server addresses for this VPC. Only applicable for delegated, providing value would create binding with this name. Providing "null" as name, would remove the binding.

    Note: manual_servers must be set if and only if dns.resolver.type is manual.

    ManualServers []IsVpcDnsResolverManualServer

    The DNS servers to use for this VPC, replacing any existing servers. All the DNS servers must either: have a unique zone_affinity, or not have a zone_affinity.

    Nested schema for manual_servers:

    Servers []IsVpcDnsResolverServer
    The DNS servers for this VPC. The servers are populated:- by the system when dns.resolver.type is system- using the DNS servers in dns.resolver.vpc when dns.resolver.type is delegated- using dns.resolver.manual_servers when the dns.resolver.type is manual.
    Type string

    The type of the DNS resolver to use. To update the resolver type, specify the type explicitly.

    Note: delegated: DNS server addresses will be provided by the resolver for the VPC specified in dns.resolver.vpc. Requires dns.enable_hub to be false. manual: DNS server addresses are specified in manual_servers. system: DNS server addresses will be provided by the system and depend on the configuration.

    Note: Updating from manual requires dns resolver manual_servers to be specified as null. Updating to manual requires dns resolver manual_servers to be specified and not empty. Updating from delegated requires dns.resolver.vpc to be specified as null. If type is delegated while creation then vpc_id is required

    VpcCrn string

    (update only) The VPC CRN to provide DNS server addresses for this VPC. The specified VPC must be configured with a DNS Services custom resolver and must be in one of this VPC's DNS resolution bindings. Mutually exclusive with vpc_id

    Note: Specify "null" string to remove an existing VPC. This property must be set if and only if dns resolver type is delegated.

    VpcId string

    (update only) The VPC ID to provide DNS server addresses for this VPC. The specified VPC must be configured with a DNS Services custom resolver and must be in one of this VPC's DNS resolution bindings. Mutually exclusive with vpc_crn

    Note: Specify "null" string to remove an existing VPC. This property must be set if and only if dns resolver type is delegated.

    VpcName string
    The VPC name whose DNS resolver provides the DNS server addresses for this VPC.The VPC may be remote and therefore may not be directly retrievable.
    VpcRemoteAccountId string
    The unique identifier for this account.
    VpcRemoteRegion string
    Region name. If present, this property indicates that the referenced resource is remote to this region, and identifies the native region.
    configuration String
    The configuration of the system DNS resolver for this VPC.- custom_resolver: A custom DNS resolver is configured for this VPC.- private_resolver: A private DNS resolver is configured for this VPC. Applicable when the VPC has either or both of the following: - at least one endpoint gateway residing in it - a DNS Services private zone configured for it- default: The provider default DNS resolvers are configured for this VPC. This system DNS resolver configuration is used when the VPC has: - no custom DNS resolver configured for it, and - no endpoint gateways residing in it, and - no DNS Services private zone configured for it.
    dnsBindingId String
    The VPC dns binding id whose DNS resolver provides the DNS server addresses for this VPC. (If any)
    dnsBindingName String

    The VPC dns binding name whose DNS resolver provides the DNS server addresses for this VPC. Only applicable for delegated, providing value would create binding with this name. Providing "null" as name, would remove the binding.

    Note: manual_servers must be set if and only if dns.resolver.type is manual.

    manualServers List<IsVpcDnsResolverManualServer>

    The DNS servers to use for this VPC, replacing any existing servers. All the DNS servers must either: have a unique zone_affinity, or not have a zone_affinity.

    Nested schema for manual_servers:

    servers List<IsVpcDnsResolverServer>
    The DNS servers for this VPC. The servers are populated:- by the system when dns.resolver.type is system- using the DNS servers in dns.resolver.vpc when dns.resolver.type is delegated- using dns.resolver.manual_servers when the dns.resolver.type is manual.
    type String

    The type of the DNS resolver to use. To update the resolver type, specify the type explicitly.

    Note: delegated: DNS server addresses will be provided by the resolver for the VPC specified in dns.resolver.vpc. Requires dns.enable_hub to be false. manual: DNS server addresses are specified in manual_servers. system: DNS server addresses will be provided by the system and depend on the configuration.

    Note: Updating from manual requires dns resolver manual_servers to be specified as null. Updating to manual requires dns resolver manual_servers to be specified and not empty. Updating from delegated requires dns.resolver.vpc to be specified as null. If type is delegated while creation then vpc_id is required

    vpcCrn String

    (update only) The VPC CRN to provide DNS server addresses for this VPC. The specified VPC must be configured with a DNS Services custom resolver and must be in one of this VPC's DNS resolution bindings. Mutually exclusive with vpc_id

    Note: Specify "null" string to remove an existing VPC. This property must be set if and only if dns resolver type is delegated.

    vpcId String

    (update only) The VPC ID to provide DNS server addresses for this VPC. The specified VPC must be configured with a DNS Services custom resolver and must be in one of this VPC's DNS resolution bindings. Mutually exclusive with vpc_crn

    Note: Specify "null" string to remove an existing VPC. This property must be set if and only if dns resolver type is delegated.

    vpcName String
    The VPC name whose DNS resolver provides the DNS server addresses for this VPC.The VPC may be remote and therefore may not be directly retrievable.
    vpcRemoteAccountId String
    The unique identifier for this account.
    vpcRemoteRegion String
    Region name. If present, this property indicates that the referenced resource is remote to this region, and identifies the native region.
    configuration string
    The configuration of the system DNS resolver for this VPC.- custom_resolver: A custom DNS resolver is configured for this VPC.- private_resolver: A private DNS resolver is configured for this VPC. Applicable when the VPC has either or both of the following: - at least one endpoint gateway residing in it - a DNS Services private zone configured for it- default: The provider default DNS resolvers are configured for this VPC. This system DNS resolver configuration is used when the VPC has: - no custom DNS resolver configured for it, and - no endpoint gateways residing in it, and - no DNS Services private zone configured for it.
    dnsBindingId string
    The VPC dns binding id whose DNS resolver provides the DNS server addresses for this VPC. (If any)
    dnsBindingName string

    The VPC dns binding name whose DNS resolver provides the DNS server addresses for this VPC. Only applicable for delegated, providing value would create binding with this name. Providing "null" as name, would remove the binding.

    Note: manual_servers must be set if and only if dns.resolver.type is manual.

    manualServers IsVpcDnsResolverManualServer[]

    The DNS servers to use for this VPC, replacing any existing servers. All the DNS servers must either: have a unique zone_affinity, or not have a zone_affinity.

    Nested schema for manual_servers:

    servers IsVpcDnsResolverServer[]
    The DNS servers for this VPC. The servers are populated:- by the system when dns.resolver.type is system- using the DNS servers in dns.resolver.vpc when dns.resolver.type is delegated- using dns.resolver.manual_servers when the dns.resolver.type is manual.
    type string

    The type of the DNS resolver to use. To update the resolver type, specify the type explicitly.

    Note: delegated: DNS server addresses will be provided by the resolver for the VPC specified in dns.resolver.vpc. Requires dns.enable_hub to be false. manual: DNS server addresses are specified in manual_servers. system: DNS server addresses will be provided by the system and depend on the configuration.

    Note: Updating from manual requires dns resolver manual_servers to be specified as null. Updating to manual requires dns resolver manual_servers to be specified and not empty. Updating from delegated requires dns.resolver.vpc to be specified as null. If type is delegated while creation then vpc_id is required

    vpcCrn string

    (update only) The VPC CRN to provide DNS server addresses for this VPC. The specified VPC must be configured with a DNS Services custom resolver and must be in one of this VPC's DNS resolution bindings. Mutually exclusive with vpc_id

    Note: Specify "null" string to remove an existing VPC. This property must be set if and only if dns resolver type is delegated.

    vpcId string

    (update only) The VPC ID to provide DNS server addresses for this VPC. The specified VPC must be configured with a DNS Services custom resolver and must be in one of this VPC's DNS resolution bindings. Mutually exclusive with vpc_crn

    Note: Specify "null" string to remove an existing VPC. This property must be set if and only if dns resolver type is delegated.

    vpcName string
    The VPC name whose DNS resolver provides the DNS server addresses for this VPC.The VPC may be remote and therefore may not be directly retrievable.
    vpcRemoteAccountId string
    The unique identifier for this account.
    vpcRemoteRegion string
    Region name. If present, this property indicates that the referenced resource is remote to this region, and identifies the native region.
    configuration str
    The configuration of the system DNS resolver for this VPC.- custom_resolver: A custom DNS resolver is configured for this VPC.- private_resolver: A private DNS resolver is configured for this VPC. Applicable when the VPC has either or both of the following: - at least one endpoint gateway residing in it - a DNS Services private zone configured for it- default: The provider default DNS resolvers are configured for this VPC. This system DNS resolver configuration is used when the VPC has: - no custom DNS resolver configured for it, and - no endpoint gateways residing in it, and - no DNS Services private zone configured for it.
    dns_binding_id str
    The VPC dns binding id whose DNS resolver provides the DNS server addresses for this VPC. (If any)
    dns_binding_name str

    The VPC dns binding name whose DNS resolver provides the DNS server addresses for this VPC. Only applicable for delegated, providing value would create binding with this name. Providing "null" as name, would remove the binding.

    Note: manual_servers must be set if and only if dns.resolver.type is manual.

    manual_servers Sequence[IsVpcDnsResolverManualServer]

    The DNS servers to use for this VPC, replacing any existing servers. All the DNS servers must either: have a unique zone_affinity, or not have a zone_affinity.

    Nested schema for manual_servers:

    servers Sequence[IsVpcDnsResolverServer]
    The DNS servers for this VPC. The servers are populated:- by the system when dns.resolver.type is system- using the DNS servers in dns.resolver.vpc when dns.resolver.type is delegated- using dns.resolver.manual_servers when the dns.resolver.type is manual.
    type str

    The type of the DNS resolver to use. To update the resolver type, specify the type explicitly.

    Note: delegated: DNS server addresses will be provided by the resolver for the VPC specified in dns.resolver.vpc. Requires dns.enable_hub to be false. manual: DNS server addresses are specified in manual_servers. system: DNS server addresses will be provided by the system and depend on the configuration.

    Note: Updating from manual requires dns resolver manual_servers to be specified as null. Updating to manual requires dns resolver manual_servers to be specified and not empty. Updating from delegated requires dns.resolver.vpc to be specified as null. If type is delegated while creation then vpc_id is required

    vpc_crn str

    (update only) The VPC CRN to provide DNS server addresses for this VPC. The specified VPC must be configured with a DNS Services custom resolver and must be in one of this VPC's DNS resolution bindings. Mutually exclusive with vpc_id

    Note: Specify "null" string to remove an existing VPC. This property must be set if and only if dns resolver type is delegated.

    vpc_id str

    (update only) The VPC ID to provide DNS server addresses for this VPC. The specified VPC must be configured with a DNS Services custom resolver and must be in one of this VPC's DNS resolution bindings. Mutually exclusive with vpc_crn

    Note: Specify "null" string to remove an existing VPC. This property must be set if and only if dns resolver type is delegated.

    vpc_name str
    The VPC name whose DNS resolver provides the DNS server addresses for this VPC.The VPC may be remote and therefore may not be directly retrievable.
    vpc_remote_account_id str
    The unique identifier for this account.
    vpc_remote_region str
    Region name. If present, this property indicates that the referenced resource is remote to this region, and identifies the native region.
    configuration String
    The configuration of the system DNS resolver for this VPC.- custom_resolver: A custom DNS resolver is configured for this VPC.- private_resolver: A private DNS resolver is configured for this VPC. Applicable when the VPC has either or both of the following: - at least one endpoint gateway residing in it - a DNS Services private zone configured for it- default: The provider default DNS resolvers are configured for this VPC. This system DNS resolver configuration is used when the VPC has: - no custom DNS resolver configured for it, and - no endpoint gateways residing in it, and - no DNS Services private zone configured for it.
    dnsBindingId String
    The VPC dns binding id whose DNS resolver provides the DNS server addresses for this VPC. (If any)
    dnsBindingName String

    The VPC dns binding name whose DNS resolver provides the DNS server addresses for this VPC. Only applicable for delegated, providing value would create binding with this name. Providing "null" as name, would remove the binding.

    Note: manual_servers must be set if and only if dns.resolver.type is manual.

    manualServers List<Property Map>

    The DNS servers to use for this VPC, replacing any existing servers. All the DNS servers must either: have a unique zone_affinity, or not have a zone_affinity.

    Nested schema for manual_servers:

    servers List<Property Map>
    The DNS servers for this VPC. The servers are populated:- by the system when dns.resolver.type is system- using the DNS servers in dns.resolver.vpc when dns.resolver.type is delegated- using dns.resolver.manual_servers when the dns.resolver.type is manual.
    type String

    The type of the DNS resolver to use. To update the resolver type, specify the type explicitly.

    Note: delegated: DNS server addresses will be provided by the resolver for the VPC specified in dns.resolver.vpc. Requires dns.enable_hub to be false. manual: DNS server addresses are specified in manual_servers. system: DNS server addresses will be provided by the system and depend on the configuration.

    Note: Updating from manual requires dns resolver manual_servers to be specified as null. Updating to manual requires dns resolver manual_servers to be specified and not empty. Updating from delegated requires dns.resolver.vpc to be specified as null. If type is delegated while creation then vpc_id is required

    vpcCrn String

    (update only) The VPC CRN to provide DNS server addresses for this VPC. The specified VPC must be configured with a DNS Services custom resolver and must be in one of this VPC's DNS resolution bindings. Mutually exclusive with vpc_id

    Note: Specify "null" string to remove an existing VPC. This property must be set if and only if dns resolver type is delegated.

    vpcId String

    (update only) The VPC ID to provide DNS server addresses for this VPC. The specified VPC must be configured with a DNS Services custom resolver and must be in one of this VPC's DNS resolution bindings. Mutually exclusive with vpc_crn

    Note: Specify "null" string to remove an existing VPC. This property must be set if and only if dns resolver type is delegated.

    vpcName String
    The VPC name whose DNS resolver provides the DNS server addresses for this VPC.The VPC may be remote and therefore may not be directly retrievable.
    vpcRemoteAccountId String
    The unique identifier for this account.
    vpcRemoteRegion String
    Region name. If present, this property indicates that the referenced resource is remote to this region, and identifies the native region.

    IsVpcDnsResolverManualServer, IsVpcDnsResolverManualServerArgs

    Address string
    The IP address. 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.
    ZoneAffinity string
    The name of the zone. If present, DHCP configuration for this zone will have this DNS server listed first.
    Address string
    The IP address. 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.
    ZoneAffinity string
    The name of the zone. If present, DHCP configuration for this zone will have this DNS server listed first.
    address String
    The IP address. 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.
    zoneAffinity String
    The name of the zone. If present, DHCP configuration for this zone will have this DNS server listed first.
    address string
    The IP address. 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.
    zoneAffinity string
    The name of the zone. If present, DHCP configuration for this zone will have this DNS server listed first.
    address str
    The IP address. 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.
    zone_affinity str
    The name of the zone. If present, DHCP configuration for this zone will have this DNS server listed first.
    address String
    The IP address. 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.
    zoneAffinity String
    The name of the zone. If present, DHCP configuration for this zone will have this DNS server listed first.

    IsVpcDnsResolverServer, IsVpcDnsResolverServerArgs

    Address string
    (String) The IP address of the cloud service endpoint.
    ZoneAffinity string
    Address string
    (String) The IP address of the cloud service endpoint.
    ZoneAffinity string
    address String
    (String) The IP address of the cloud service endpoint.
    zoneAffinity String
    address string
    (String) The IP address of the cloud service endpoint.
    zoneAffinity string
    address str
    (String) The IP address of the cloud service endpoint.
    zone_affinity str
    address String
    (String) The IP address of the cloud service endpoint.
    zoneAffinity String

    IsVpcHealthReason, IsVpcHealthReasonArgs

    Code string
    (String) The ICMP traffic code to allow.
    Message string
    (String) An explanation of the reason for this health state.
    MoreInfo string
    (String) Link to documentation about the reason for this health state.
    Code string
    (String) The ICMP traffic code to allow.
    Message string
    (String) An explanation of the reason for this health state.
    MoreInfo string
    (String) Link to documentation about the reason for this health state.
    code String
    (String) The ICMP traffic code to allow.
    message String
    (String) An explanation of the reason for this health state.
    moreInfo String
    (String) Link to documentation about the reason for this health state.
    code string
    (String) The ICMP traffic code to allow.
    message string
    (String) An explanation of the reason for this health state.
    moreInfo string
    (String) Link to documentation about the reason for this health state.
    code str
    (String) The ICMP traffic code to allow.
    message str
    (String) An explanation of the reason for this health state.
    more_info str
    (String) Link to documentation about the reason for this health state.
    code String
    (String) The ICMP traffic code to allow.
    message String
    (String) An explanation of the reason for this health state.
    moreInfo String
    (String) Link to documentation about the reason for this health state.

    IsVpcSecurityGroup, IsVpcSecurityGroupArgs

    GroupId string
    (String) The security group ID.
    GroupName string
    (String) The name of the security group.
    Rules List<IsVpcSecurityGroupRule>
    (List) Set of rules attached to a security group.
    GroupId string
    (String) The security group ID.
    GroupName string
    (String) The name of the security group.
    Rules []IsVpcSecurityGroupRule
    (List) Set of rules attached to a security group.
    groupId String
    (String) The security group ID.
    groupName String
    (String) The name of the security group.
    rules List<IsVpcSecurityGroupRule>
    (List) Set of rules attached to a security group.
    groupId string
    (String) The security group ID.
    groupName string
    (String) The name of the security group.
    rules IsVpcSecurityGroupRule[]
    (List) Set of rules attached to a security group.
    group_id str
    (String) The security group ID.
    group_name str
    (String) The name of the security group.
    rules Sequence[IsVpcSecurityGroupRule]
    (List) Set of rules attached to a security group.
    groupId String
    (String) The security group ID.
    groupName String
    (String) The name of the security group.
    rules List<Property Map>
    (List) Set of rules attached to a security group.

    IsVpcSecurityGroupRule, IsVpcSecurityGroupRuleArgs

    Code double
    (String) The ICMP traffic code to allow.
    Direction string
    (String) The direction of the traffic either inbound or outbound.
    IpVersion string
    (String) The IP version: ipv4.
    PortMax double
    (String) The inclusive upper bound of TCP port range.
    PortMin double
    (String) The inclusive lower bound of TCP port range.
    Protocol string
    Remote string
    (String) Security group ID, an IP address, a CIDR block, or a single security group identifier.
    RuleId string
    (String) The rule ID.
    Type double
    (String) The ICMP traffic type to allow.
    Code float64
    (String) The ICMP traffic code to allow.
    Direction string
    (String) The direction of the traffic either inbound or outbound.
    IpVersion string
    (String) The IP version: ipv4.
    PortMax float64
    (String) The inclusive upper bound of TCP port range.
    PortMin float64
    (String) The inclusive lower bound of TCP port range.
    Protocol string
    Remote string
    (String) Security group ID, an IP address, a CIDR block, or a single security group identifier.
    RuleId string
    (String) The rule ID.
    Type float64
    (String) The ICMP traffic type to allow.
    code Double
    (String) The ICMP traffic code to allow.
    direction String
    (String) The direction of the traffic either inbound or outbound.
    ipVersion String
    (String) The IP version: ipv4.
    portMax Double
    (String) The inclusive upper bound of TCP port range.
    portMin Double
    (String) The inclusive lower bound of TCP port range.
    protocol String
    remote String
    (String) Security group ID, an IP address, a CIDR block, or a single security group identifier.
    ruleId String
    (String) The rule ID.
    type Double
    (String) The ICMP traffic type to allow.
    code number
    (String) The ICMP traffic code to allow.
    direction string
    (String) The direction of the traffic either inbound or outbound.
    ipVersion string
    (String) The IP version: ipv4.
    portMax number
    (String) The inclusive upper bound of TCP port range.
    portMin number
    (String) The inclusive lower bound of TCP port range.
    protocol string
    remote string
    (String) Security group ID, an IP address, a CIDR block, or a single security group identifier.
    ruleId string
    (String) The rule ID.
    type number
    (String) The ICMP traffic type to allow.
    code float
    (String) The ICMP traffic code to allow.
    direction str
    (String) The direction of the traffic either inbound or outbound.
    ip_version str
    (String) The IP version: ipv4.
    port_max float
    (String) The inclusive upper bound of TCP port range.
    port_min float
    (String) The inclusive lower bound of TCP port range.
    protocol str
    remote str
    (String) Security group ID, an IP address, a CIDR block, or a single security group identifier.
    rule_id str
    (String) The rule ID.
    type float
    (String) The ICMP traffic type to allow.
    code Number
    (String) The ICMP traffic code to allow.
    direction String
    (String) The direction of the traffic either inbound or outbound.
    ipVersion String
    (String) The IP version: ipv4.
    portMax Number
    (String) The inclusive upper bound of TCP port range.
    portMin Number
    (String) The inclusive lower bound of TCP port range.
    protocol String
    remote String
    (String) Security group ID, an IP address, a CIDR block, or a single security group identifier.
    ruleId String
    (String) The rule ID.
    type Number
    (String) The ICMP traffic type to allow.

    IsVpcSubnet, IsVpcSubnetArgs

    AvailableIpv4AddressCount double
    (Integer) The number of IPv4 addresses in the subnet that are available for you to be used.
    Id string
    (String) The ID of the subnet.
    Name string
    Enter a name for your VPC. No.
    Status string
    (String) The provisioning status of your VPC.
    TotalIpv4AddressCount double
    (Integer) The total number of IPv4 addresses in the subnet.
    Zone string
    (String) The Zone of the subnet.
    AvailableIpv4AddressCount float64
    (Integer) The number of IPv4 addresses in the subnet that are available for you to be used.
    Id string
    (String) The ID of the subnet.
    Name string
    Enter a name for your VPC. No.
    Status string
    (String) The provisioning status of your VPC.
    TotalIpv4AddressCount float64
    (Integer) The total number of IPv4 addresses in the subnet.
    Zone string
    (String) The Zone of the subnet.
    availableIpv4AddressCount Double
    (Integer) The number of IPv4 addresses in the subnet that are available for you to be used.
    id String
    (String) The ID of the subnet.
    name String
    Enter a name for your VPC. No.
    status String
    (String) The provisioning status of your VPC.
    totalIpv4AddressCount Double
    (Integer) The total number of IPv4 addresses in the subnet.
    zone String
    (String) The Zone of the subnet.
    availableIpv4AddressCount number
    (Integer) The number of IPv4 addresses in the subnet that are available for you to be used.
    id string
    (String) The ID of the subnet.
    name string
    Enter a name for your VPC. No.
    status string
    (String) The provisioning status of your VPC.
    totalIpv4AddressCount number
    (Integer) The total number of IPv4 addresses in the subnet.
    zone string
    (String) The Zone of the subnet.
    available_ipv4_address_count float
    (Integer) The number of IPv4 addresses in the subnet that are available for you to be used.
    id str
    (String) The ID of the subnet.
    name str
    Enter a name for your VPC. No.
    status str
    (String) The provisioning status of your VPC.
    total_ipv4_address_count float
    (Integer) The total number of IPv4 addresses in the subnet.
    zone str
    (String) The Zone of the subnet.
    availableIpv4AddressCount Number
    (Integer) The number of IPv4 addresses in the subnet that are available for you to be used.
    id String
    (String) The ID of the subnet.
    name String
    Enter a name for your VPC. No.
    status String
    (String) The provisioning status of your VPC.
    totalIpv4AddressCount Number
    (Integer) The total number of IPv4 addresses in the subnet.
    zone String
    (String) The Zone of the subnet.

    IsVpcTimeouts, IsVpcTimeoutsArgs

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

    Import

    The ibm_is_vpc resource can be imported by using the VPC ID.

    Syntax

    $ pulumi import ibm:index/isVpc:IsVpc example <vpc_ID>
    

    Example

    $ pulumi import ibm:index/isVpc:IsVpc example d7bec597-4726-451f-8a63-e62e6f19c32c
    

    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.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud