Docs Home
oci.Core.Vcn
Explore with Pulumi AI
This resource provides the Vcn resource in Oracle Cloud Infrastructure Core service.
The VCN automatically comes with a default route table, default security list, and default set of DHCP options. For managing these resources, see Managing Default VCN Resources
Creates a new Virtual Cloud Network (VCN). For more information, see VCNs and Subnets.
For the VCN, you specify a list of one or more IPv4 CIDR blocks that meet the following criteria:
- The CIDR blocks must be valid.
- They must not overlap with each other or with the on-premises network CIDR block.
- The number of CIDR blocks does not exceed the limit of CIDR blocks allowed per VCN.
For a CIDR block, Oracle recommends that you use one of the private IP address ranges specified in RFC 1918 (10.0.0.0/8, 172.16/12, and 192.168/16). Example: 172.16.0.0/16. The CIDR blocks can range from /16 to /30.
For the purposes of access control, you must provide the OCID of the compartment where you want the VCN to reside. Consult an Oracle Cloud Infrastructure administrator in your organization if you’re not sure which compartment to use. Notice that the VCN doesn’t have to be in the same compartment as the subnets or other Networking Service components. For more information about compartments and access control, see Overview of the IAM Service. For information about OCIDs, see Resource Identifiers.
You may optionally specify a display name for the VCN, otherwise a default is provided. It does not have to be unique, and you can change it. Avoid entering confidential information.
You can also add a DNS label for the VCN, which is required if you want the instances to use the Interent and VCN Resolver option for DNS in the VCN. For more information, see DNS in Your Virtual Cloud Network.
The VCN automatically comes with a default route table, default security list, and default set of DHCP options. The OCID for each is returned in the response. You can’t delete these default objects, but you can change their contents (that is, change the route rules, security list rules, and so on).
The VCN and subnets you create are not accessible until you attach an internet gateway or set up a Site-to-Site VPN or FastConnect. For more information, see Overview of the Networking Service.
Supported Aliases
oci.Core.VirtualNetwork
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testVcn = new oci.core.Vcn("test_vcn", {
compartmentId: compartmentId,
byoipv6cidrDetails: [{
byoipv6rangeId: testByoipv6range.id,
ipv6cidrBlock: vcnByoipv6cidrDetailsIpv6cidrBlock,
}],
cidrBlock: vcnCidrBlock,
cidrBlocks: vcnCidrBlocks,
definedTags: {
"Operations.CostCenter": "42",
},
displayName: vcnDisplayName,
dnsLabel: vcnDnsLabel,
freeformTags: {
Department: "Finance",
},
ipv6privateCidrBlocks: vcnIpv6privateCidrBlocks,
isIpv6enabled: vcnIsIpv6enabled,
isOracleGuaAllocationEnabled: vcnIsOracleGuaAllocationEnabled,
securityAttributes: vcnSecurityAttributes,
});
import pulumi
import pulumi_oci as oci
test_vcn = oci.core.Vcn("test_vcn",
compartment_id=compartment_id,
byoipv6cidr_details=[{
"byoipv6range_id": test_byoipv6range["id"],
"ipv6cidr_block": vcn_byoipv6cidr_details_ipv6cidr_block,
}],
cidr_block=vcn_cidr_block,
cidr_blocks=vcn_cidr_blocks,
defined_tags={
"Operations.CostCenter": "42",
},
display_name=vcn_display_name,
dns_label=vcn_dns_label,
freeform_tags={
"Department": "Finance",
},
ipv6private_cidr_blocks=vcn_ipv6private_cidr_blocks,
is_ipv6enabled=vcn_is_ipv6enabled,
is_oracle_gua_allocation_enabled=vcn_is_oracle_gua_allocation_enabled,
security_attributes=vcn_security_attributes)
package main
import (
"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/Core"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := Core.NewVcn(ctx, "test_vcn", &Core.VcnArgs{
CompartmentId: pulumi.Any(compartmentId),
Byoipv6cidrDetails: core.VcnByoipv6cidrDetailArray{
&core.VcnByoipv6cidrDetailArgs{
Byoipv6rangeId: pulumi.Any(testByoipv6range.Id),
Ipv6cidrBlock: pulumi.Any(vcnByoipv6cidrDetailsIpv6cidrBlock),
},
},
CidrBlock: pulumi.Any(vcnCidrBlock),
CidrBlocks: pulumi.Any(vcnCidrBlocks),
DefinedTags: pulumi.StringMap{
"Operations.CostCenter": pulumi.String("42"),
},
DisplayName: pulumi.Any(vcnDisplayName),
DnsLabel: pulumi.Any(vcnDnsLabel),
FreeformTags: pulumi.StringMap{
"Department": pulumi.String("Finance"),
},
Ipv6privateCidrBlocks: pulumi.Any(vcnIpv6privateCidrBlocks),
IsIpv6enabled: pulumi.Any(vcnIsIpv6enabled),
IsOracleGuaAllocationEnabled: pulumi.Any(vcnIsOracleGuaAllocationEnabled),
SecurityAttributes: pulumi.Any(vcnSecurityAttributes),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;
return await Deployment.RunAsync(() =>
{
var testVcn = new Oci.Core.Vcn("test_vcn", new()
{
CompartmentId = compartmentId,
Byoipv6cidrDetails = new[]
{
new Oci.Core.Inputs.VcnByoipv6cidrDetailArgs
{
Byoipv6rangeId = testByoipv6range.Id,
Ipv6cidrBlock = vcnByoipv6cidrDetailsIpv6cidrBlock,
},
},
CidrBlock = vcnCidrBlock,
CidrBlocks = vcnCidrBlocks,
DefinedTags =
{
{ "Operations.CostCenter", "42" },
},
DisplayName = vcnDisplayName,
DnsLabel = vcnDnsLabel,
FreeformTags =
{
{ "Department", "Finance" },
},
Ipv6privateCidrBlocks = vcnIpv6privateCidrBlocks,
IsIpv6enabled = vcnIsIpv6enabled,
IsOracleGuaAllocationEnabled = vcnIsOracleGuaAllocationEnabled,
SecurityAttributes = vcnSecurityAttributes,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Core.Vcn;
import com.pulumi.oci.Core.VcnArgs;
import com.pulumi.oci.Core.inputs.VcnByoipv6cidrDetailArgs;
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 testVcn = new Vcn("testVcn", VcnArgs.builder()
.compartmentId(compartmentId)
.byoipv6cidrDetails(VcnByoipv6cidrDetailArgs.builder()
.byoipv6rangeId(testByoipv6range.id())
.ipv6cidrBlock(vcnByoipv6cidrDetailsIpv6cidrBlock)
.build())
.cidrBlock(vcnCidrBlock)
.cidrBlocks(vcnCidrBlocks)
.definedTags(Map.of("Operations.CostCenter", "42"))
.displayName(vcnDisplayName)
.dnsLabel(vcnDnsLabel)
.freeformTags(Map.of("Department", "Finance"))
.ipv6privateCidrBlocks(vcnIpv6privateCidrBlocks)
.isIpv6enabled(vcnIsIpv6enabled)
.isOracleGuaAllocationEnabled(vcnIsOracleGuaAllocationEnabled)
.securityAttributes(vcnSecurityAttributes)
.build());
}
}
resources:
testVcn:
type: oci:Core:Vcn
name: test_vcn
properties:
compartmentId: ${compartmentId}
byoipv6cidrDetails:
- byoipv6rangeId: ${testByoipv6range.id}
ipv6cidrBlock: ${vcnByoipv6cidrDetailsIpv6cidrBlock}
cidrBlock: ${vcnCidrBlock}
cidrBlocks: ${vcnCidrBlocks}
definedTags:
Operations.CostCenter: '42'
displayName: ${vcnDisplayName}
dnsLabel: ${vcnDnsLabel}
freeformTags:
Department: Finance
ipv6privateCidrBlocks: ${vcnIpv6privateCidrBlocks}
isIpv6enabled: ${vcnIsIpv6enabled}
isOracleGuaAllocationEnabled: ${vcnIsOracleGuaAllocationEnabled}
securityAttributes: ${vcnSecurityAttributes}
Create Vcn Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Vcn(name: string, args: VcnArgs, opts?: CustomResourceOptions);@overload
def Vcn(resource_name: str,
args: VcnArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Vcn(resource_name: str,
opts: Optional[ResourceOptions] = None,
compartment_id: Optional[str] = None,
byoipv6cidr_details: Optional[Sequence[_core.VcnByoipv6cidrDetailArgs]] = None,
cidr_block: Optional[str] = None,
cidr_blocks: Optional[Sequence[str]] = None,
defined_tags: Optional[Mapping[str, str]] = None,
display_name: Optional[str] = None,
dns_label: Optional[str] = None,
freeform_tags: Optional[Mapping[str, str]] = None,
ipv6private_cidr_blocks: Optional[Sequence[str]] = None,
is_ipv6enabled: Optional[bool] = None,
is_oracle_gua_allocation_enabled: Optional[bool] = None,
security_attributes: Optional[Mapping[str, str]] = None)func NewVcn(ctx *Context, name string, args VcnArgs, opts ...ResourceOption) (*Vcn, error)public Vcn(string name, VcnArgs args, CustomResourceOptions? opts = null)type: oci:Core:Vcn
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 VcnArgs
- 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 VcnArgs
- 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 VcnArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args VcnArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args VcnArgs
- 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 vcnResource = new Oci.Core.Vcn("vcnResource", new()
{
CompartmentId = "string",
Byoipv6cidrDetails = new[]
{
new Oci.Core.Inputs.VcnByoipv6cidrDetailArgs
{
Byoipv6rangeId = "string",
Ipv6cidrBlock = "string",
},
},
CidrBlock = "string",
CidrBlocks = new[]
{
"string",
},
DefinedTags =
{
{ "string", "string" },
},
DisplayName = "string",
DnsLabel = "string",
FreeformTags =
{
{ "string", "string" },
},
Ipv6privateCidrBlocks = new[]
{
"string",
},
IsIpv6enabled = false,
IsOracleGuaAllocationEnabled = false,
SecurityAttributes =
{
{ "string", "string" },
},
});
example, err := Core.NewVcn(ctx, "vcnResource", &Core.VcnArgs{
CompartmentId: pulumi.String("string"),
Byoipv6cidrDetails: core.VcnByoipv6cidrDetailArray{
&core.VcnByoipv6cidrDetailArgs{
Byoipv6rangeId: pulumi.String("string"),
Ipv6cidrBlock: pulumi.String("string"),
},
},
CidrBlock: pulumi.String("string"),
CidrBlocks: pulumi.StringArray{
pulumi.String("string"),
},
DefinedTags: pulumi.StringMap{
"string": pulumi.String("string"),
},
DisplayName: pulumi.String("string"),
DnsLabel: pulumi.String("string"),
FreeformTags: pulumi.StringMap{
"string": pulumi.String("string"),
},
Ipv6privateCidrBlocks: pulumi.StringArray{
pulumi.String("string"),
},
IsIpv6enabled: pulumi.Bool(false),
IsOracleGuaAllocationEnabled: pulumi.Bool(false),
SecurityAttributes: pulumi.StringMap{
"string": pulumi.String("string"),
},
})
var vcnResource = new Vcn("vcnResource", VcnArgs.builder()
.compartmentId("string")
.byoipv6cidrDetails(VcnByoipv6cidrDetailArgs.builder()
.byoipv6rangeId("string")
.ipv6cidrBlock("string")
.build())
.cidrBlock("string")
.cidrBlocks("string")
.definedTags(Map.of("string", "string"))
.displayName("string")
.dnsLabel("string")
.freeformTags(Map.of("string", "string"))
.ipv6privateCidrBlocks("string")
.isIpv6enabled(false)
.isOracleGuaAllocationEnabled(false)
.securityAttributes(Map.of("string", "string"))
.build());
vcn_resource = oci.core.Vcn("vcnResource",
compartment_id="string",
byoipv6cidr_details=[{
"byoipv6range_id": "string",
"ipv6cidr_block": "string",
}],
cidr_block="string",
cidr_blocks=["string"],
defined_tags={
"string": "string",
},
display_name="string",
dns_label="string",
freeform_tags={
"string": "string",
},
ipv6private_cidr_blocks=["string"],
is_ipv6enabled=False,
is_oracle_gua_allocation_enabled=False,
security_attributes={
"string": "string",
})
const vcnResource = new oci.core.Vcn("vcnResource", {
compartmentId: "string",
byoipv6cidrDetails: [{
byoipv6rangeId: "string",
ipv6cidrBlock: "string",
}],
cidrBlock: "string",
cidrBlocks: ["string"],
definedTags: {
string: "string",
},
displayName: "string",
dnsLabel: "string",
freeformTags: {
string: "string",
},
ipv6privateCidrBlocks: ["string"],
isIpv6enabled: false,
isOracleGuaAllocationEnabled: false,
securityAttributes: {
string: "string",
},
});
type: oci:Core:Vcn
properties:
byoipv6cidrDetails:
- byoipv6rangeId: string
ipv6cidrBlock: string
cidrBlock: string
cidrBlocks:
- string
compartmentId: string
definedTags:
string: string
displayName: string
dnsLabel: string
freeformTags:
string: string
ipv6privateCidrBlocks:
- string
isIpv6enabled: false
isOracleGuaAllocationEnabled: false
securityAttributes:
string: string
Vcn 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 Vcn resource accepts the following input properties:
- Compartment
Id string - (Updatable) The OCID of the compartment to contain the VCN.
- Byoipv6cidr
Details List<VcnByoipv6cidr Detail> - The list of BYOIPv6 OCIDs and BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 address ranges.
- Cidr
Block string - Deprecated. Do not set this value. Use
cidr_blocksinstead. Example:10.0.0.0/16 - Cidr
Blocks List<string> - (Updatable) The list of one or more IPv4 CIDR blocks for the VCN that meet the following criteria:
- The CIDR blocks must be valid.
- They must not overlap with each other or with the on-premises network CIDR block.
- The number of CIDR blocks must not exceed the limit of CIDR blocks allowed per VCN. It is an error to set both cidr_block and cidr_blocks. Note: cidr_blocks update must be restricted to one operation at a time (either add/remove or modify one single cidr_block) or the operation will be declined. new cidr_block to be added must be placed at the end of the list. Once you migrate to using
cidr_blocksfromcidr_block, you will not be able to switch back. Important: Do not specify a value forcidr_block. Use this parameter instead.
- Dictionary<string, string>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"} - Display
Name string - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- Dns
Label string A DNS label for the VCN, used in conjunction with the VNIC's hostname and subnet's DNS label to form a fully qualified domain name (FQDN) for each VNIC within this subnet (for example,
bminstance1.subnet123.vcn1.oraclevcn.com). Not required to be unique, but it's a best practice to set unique DNS labels for VCNs in your tenancy. Must be an alphanumeric string that begins with a letter. The value cannot be changed. You must set this value if you want instances to be able to use hostnames to resolve other instances in the VCN. Otherwise the Internet and VCN Resolver will not work.For more information, see DNS in Your Virtual Cloud Network.
Example:
vcn1- Dictionary<string, string>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"} - Ipv6private
Cidr List<string>Blocks The list of one or more ULA or Private IPv6 CIDR blocks for the vcn that meets the following criteria:
- The CIDR blocks must be valid.
- Multiple CIDR blocks must not overlap each other or the on-premises network prefix.
- The number of CIDR blocks must not exceed the limit of IPv6 prefixes allowed to a VCN.
Important: Do not specify a value for
ipv6cidr_block. Use this parameter instead.- Is
Ipv6enabled bool - Whether IPv6 is enabled for the VCN. Default is
false. If enabled, Oracle will assign the VCN a IPv6 /56 CIDR block. You may skip having Oracle allocate the VCN a IPv6 /56 CIDR block by setting isOracleGuaAllocationEnabled tofalse. For important details about IPv6 addressing in a VCN, see IPv6 Addresses. Example:true - Is
Oracle boolGua Allocation Enabled - Specifies whether to skip Oracle allocated IPv6 GUA. By default, Oracle will allocate one GUA of /56 size for an IPv6 enabled VCN.
- Security
Attributes Dictionary<string, string> (Updatable) Security Attributes for this resource. This is unique to ZPR, and helps identify which resources are allowed to be accessed by what permission controls. Example:
{"Oracle-DataSecurity-ZPR.MaxEgressCount.value": "42", "Oracle-DataSecurity-ZPR.MaxEgressCount.mode": "audit"}** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Compartment
Id string - (Updatable) The OCID of the compartment to contain the VCN.
- Byoipv6cidr
Details []VcnByoipv6cidr Detail Args - The list of BYOIPv6 OCIDs and BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 address ranges.
- Cidr
Block string - Deprecated. Do not set this value. Use
cidr_blocksinstead. Example:10.0.0.0/16 - Cidr
Blocks []string - (Updatable) The list of one or more IPv4 CIDR blocks for the VCN that meet the following criteria:
- The CIDR blocks must be valid.
- They must not overlap with each other or with the on-premises network CIDR block.
- The number of CIDR blocks must not exceed the limit of CIDR blocks allowed per VCN. It is an error to set both cidr_block and cidr_blocks. Note: cidr_blocks update must be restricted to one operation at a time (either add/remove or modify one single cidr_block) or the operation will be declined. new cidr_block to be added must be placed at the end of the list. Once you migrate to using
cidr_blocksfromcidr_block, you will not be able to switch back. Important: Do not specify a value forcidr_block. Use this parameter instead.
- map[string]string
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"} - Display
Name string - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- Dns
Label string A DNS label for the VCN, used in conjunction with the VNIC's hostname and subnet's DNS label to form a fully qualified domain name (FQDN) for each VNIC within this subnet (for example,
bminstance1.subnet123.vcn1.oraclevcn.com). Not required to be unique, but it's a best practice to set unique DNS labels for VCNs in your tenancy. Must be an alphanumeric string that begins with a letter. The value cannot be changed. You must set this value if you want instances to be able to use hostnames to resolve other instances in the VCN. Otherwise the Internet and VCN Resolver will not work.For more information, see DNS in Your Virtual Cloud Network.
Example:
vcn1- map[string]string
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"} - Ipv6private
Cidr []stringBlocks The list of one or more ULA or Private IPv6 CIDR blocks for the vcn that meets the following criteria:
- The CIDR blocks must be valid.
- Multiple CIDR blocks must not overlap each other or the on-premises network prefix.
- The number of CIDR blocks must not exceed the limit of IPv6 prefixes allowed to a VCN.
Important: Do not specify a value for
ipv6cidr_block. Use this parameter instead.- Is
Ipv6enabled bool - Whether IPv6 is enabled for the VCN. Default is
false. If enabled, Oracle will assign the VCN a IPv6 /56 CIDR block. You may skip having Oracle allocate the VCN a IPv6 /56 CIDR block by setting isOracleGuaAllocationEnabled tofalse. For important details about IPv6 addressing in a VCN, see IPv6 Addresses. Example:true - Is
Oracle boolGua Allocation Enabled - Specifies whether to skip Oracle allocated IPv6 GUA. By default, Oracle will allocate one GUA of /56 size for an IPv6 enabled VCN.
- Security
Attributes map[string]string (Updatable) Security Attributes for this resource. This is unique to ZPR, and helps identify which resources are allowed to be accessed by what permission controls. Example:
{"Oracle-DataSecurity-ZPR.MaxEgressCount.value": "42", "Oracle-DataSecurity-ZPR.MaxEgressCount.mode": "audit"}** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- compartment
Id String - (Updatable) The OCID of the compartment to contain the VCN.
- byoipv6cidr
Details List<VcnByoipv6cidr Detail> - The list of BYOIPv6 OCIDs and BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 address ranges.
- cidr
Block String - Deprecated. Do not set this value. Use
cidr_blocksinstead. Example:10.0.0.0/16 - cidr
Blocks List<String> - (Updatable) The list of one or more IPv4 CIDR blocks for the VCN that meet the following criteria:
- The CIDR blocks must be valid.
- They must not overlap with each other or with the on-premises network CIDR block.
- The number of CIDR blocks must not exceed the limit of CIDR blocks allowed per VCN. It is an error to set both cidr_block and cidr_blocks. Note: cidr_blocks update must be restricted to one operation at a time (either add/remove or modify one single cidr_block) or the operation will be declined. new cidr_block to be added must be placed at the end of the list. Once you migrate to using
cidr_blocksfromcidr_block, you will not be able to switch back. Important: Do not specify a value forcidr_block. Use this parameter instead.
- Map<String,String>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"} - display
Name String - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- dns
Label String A DNS label for the VCN, used in conjunction with the VNIC's hostname and subnet's DNS label to form a fully qualified domain name (FQDN) for each VNIC within this subnet (for example,
bminstance1.subnet123.vcn1.oraclevcn.com). Not required to be unique, but it's a best practice to set unique DNS labels for VCNs in your tenancy. Must be an alphanumeric string that begins with a letter. The value cannot be changed. You must set this value if you want instances to be able to use hostnames to resolve other instances in the VCN. Otherwise the Internet and VCN Resolver will not work.For more information, see DNS in Your Virtual Cloud Network.
Example:
vcn1- Map<String,String>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"} - ipv6private
Cidr List<String>Blocks The list of one or more ULA or Private IPv6 CIDR blocks for the vcn that meets the following criteria:
- The CIDR blocks must be valid.
- Multiple CIDR blocks must not overlap each other or the on-premises network prefix.
- The number of CIDR blocks must not exceed the limit of IPv6 prefixes allowed to a VCN.
Important: Do not specify a value for
ipv6cidr_block. Use this parameter instead.- is
Ipv6enabled Boolean - Whether IPv6 is enabled for the VCN. Default is
false. If enabled, Oracle will assign the VCN a IPv6 /56 CIDR block. You may skip having Oracle allocate the VCN a IPv6 /56 CIDR block by setting isOracleGuaAllocationEnabled tofalse. For important details about IPv6 addressing in a VCN, see IPv6 Addresses. Example:true - is
Oracle BooleanGua Allocation Enabled - Specifies whether to skip Oracle allocated IPv6 GUA. By default, Oracle will allocate one GUA of /56 size for an IPv6 enabled VCN.
- security
Attributes Map<String,String> (Updatable) Security Attributes for this resource. This is unique to ZPR, and helps identify which resources are allowed to be accessed by what permission controls. Example:
{"Oracle-DataSecurity-ZPR.MaxEgressCount.value": "42", "Oracle-DataSecurity-ZPR.MaxEgressCount.mode": "audit"}** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- compartment
Id string - (Updatable) The OCID of the compartment to contain the VCN.
- byoipv6cidr
Details VcnByoipv6cidr Detail[] - The list of BYOIPv6 OCIDs and BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 address ranges.
- cidr
Block string - Deprecated. Do not set this value. Use
cidr_blocksinstead. Example:10.0.0.0/16 - cidr
Blocks string[] - (Updatable) The list of one or more IPv4 CIDR blocks for the VCN that meet the following criteria:
- The CIDR blocks must be valid.
- They must not overlap with each other or with the on-premises network CIDR block.
- The number of CIDR blocks must not exceed the limit of CIDR blocks allowed per VCN. It is an error to set both cidr_block and cidr_blocks. Note: cidr_blocks update must be restricted to one operation at a time (either add/remove or modify one single cidr_block) or the operation will be declined. new cidr_block to be added must be placed at the end of the list. Once you migrate to using
cidr_blocksfromcidr_block, you will not be able to switch back. Important: Do not specify a value forcidr_block. Use this parameter instead.
- {[key: string]: string}
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"} - display
Name string - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- dns
Label string A DNS label for the VCN, used in conjunction with the VNIC's hostname and subnet's DNS label to form a fully qualified domain name (FQDN) for each VNIC within this subnet (for example,
bminstance1.subnet123.vcn1.oraclevcn.com). Not required to be unique, but it's a best practice to set unique DNS labels for VCNs in your tenancy. Must be an alphanumeric string that begins with a letter. The value cannot be changed. You must set this value if you want instances to be able to use hostnames to resolve other instances in the VCN. Otherwise the Internet and VCN Resolver will not work.For more information, see DNS in Your Virtual Cloud Network.
Example:
vcn1- {[key: string]: string}
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"} - ipv6private
Cidr string[]Blocks The list of one or more ULA or Private IPv6 CIDR blocks for the vcn that meets the following criteria:
- The CIDR blocks must be valid.
- Multiple CIDR blocks must not overlap each other or the on-premises network prefix.
- The number of CIDR blocks must not exceed the limit of IPv6 prefixes allowed to a VCN.
Important: Do not specify a value for
ipv6cidr_block. Use this parameter instead.- is
Ipv6enabled boolean - Whether IPv6 is enabled for the VCN. Default is
false. If enabled, Oracle will assign the VCN a IPv6 /56 CIDR block. You may skip having Oracle allocate the VCN a IPv6 /56 CIDR block by setting isOracleGuaAllocationEnabled tofalse. For important details about IPv6 addressing in a VCN, see IPv6 Addresses. Example:true - is
Oracle booleanGua Allocation Enabled - Specifies whether to skip Oracle allocated IPv6 GUA. By default, Oracle will allocate one GUA of /56 size for an IPv6 enabled VCN.
- security
Attributes {[key: string]: string} (Updatable) Security Attributes for this resource. This is unique to ZPR, and helps identify which resources are allowed to be accessed by what permission controls. Example:
{"Oracle-DataSecurity-ZPR.MaxEgressCount.value": "42", "Oracle-DataSecurity-ZPR.MaxEgressCount.mode": "audit"}** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- compartment_
id str - (Updatable) The OCID of the compartment to contain the VCN.
- byoipv6cidr_
details Sequence[core.Vcn Byoipv6cidr Detail Args] - The list of BYOIPv6 OCIDs and BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 address ranges.
- cidr_
block str - Deprecated. Do not set this value. Use
cidr_blocksinstead. Example:10.0.0.0/16 - cidr_
blocks Sequence[str] - (Updatable) The list of one or more IPv4 CIDR blocks for the VCN that meet the following criteria:
- The CIDR blocks must be valid.
- They must not overlap with each other or with the on-premises network CIDR block.
- The number of CIDR blocks must not exceed the limit of CIDR blocks allowed per VCN. It is an error to set both cidr_block and cidr_blocks. Note: cidr_blocks update must be restricted to one operation at a time (either add/remove or modify one single cidr_block) or the operation will be declined. new cidr_block to be added must be placed at the end of the list. Once you migrate to using
cidr_blocksfromcidr_block, you will not be able to switch back. Important: Do not specify a value forcidr_block. Use this parameter instead.
- Mapping[str, str]
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"} - display_
name str - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- dns_
label str A DNS label for the VCN, used in conjunction with the VNIC's hostname and subnet's DNS label to form a fully qualified domain name (FQDN) for each VNIC within this subnet (for example,
bminstance1.subnet123.vcn1.oraclevcn.com). Not required to be unique, but it's a best practice to set unique DNS labels for VCNs in your tenancy. Must be an alphanumeric string that begins with a letter. The value cannot be changed. You must set this value if you want instances to be able to use hostnames to resolve other instances in the VCN. Otherwise the Internet and VCN Resolver will not work.For more information, see DNS in Your Virtual Cloud Network.
Example:
vcn1- Mapping[str, str]
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"} - ipv6private_
cidr_ Sequence[str]blocks The list of one or more ULA or Private IPv6 CIDR blocks for the vcn that meets the following criteria:
- The CIDR blocks must be valid.
- Multiple CIDR blocks must not overlap each other or the on-premises network prefix.
- The number of CIDR blocks must not exceed the limit of IPv6 prefixes allowed to a VCN.
Important: Do not specify a value for
ipv6cidr_block. Use this parameter instead.- is_
ipv6enabled bool - Whether IPv6 is enabled for the VCN. Default is
false. If enabled, Oracle will assign the VCN a IPv6 /56 CIDR block. You may skip having Oracle allocate the VCN a IPv6 /56 CIDR block by setting isOracleGuaAllocationEnabled tofalse. For important details about IPv6 addressing in a VCN, see IPv6 Addresses. Example:true - is_
oracle_ boolgua_ allocation_ enabled - Specifies whether to skip Oracle allocated IPv6 GUA. By default, Oracle will allocate one GUA of /56 size for an IPv6 enabled VCN.
- security_
attributes Mapping[str, str] (Updatable) Security Attributes for this resource. This is unique to ZPR, and helps identify which resources are allowed to be accessed by what permission controls. Example:
{"Oracle-DataSecurity-ZPR.MaxEgressCount.value": "42", "Oracle-DataSecurity-ZPR.MaxEgressCount.mode": "audit"}** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- compartment
Id String - (Updatable) The OCID of the compartment to contain the VCN.
- byoipv6cidr
Details List<Property Map> - The list of BYOIPv6 OCIDs and BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 address ranges.
- cidr
Block String - Deprecated. Do not set this value. Use
cidr_blocksinstead. Example:10.0.0.0/16 - cidr
Blocks List<String> - (Updatable) The list of one or more IPv4 CIDR blocks for the VCN that meet the following criteria:
- The CIDR blocks must be valid.
- They must not overlap with each other or with the on-premises network CIDR block.
- The number of CIDR blocks must not exceed the limit of CIDR blocks allowed per VCN. It is an error to set both cidr_block and cidr_blocks. Note: cidr_blocks update must be restricted to one operation at a time (either add/remove or modify one single cidr_block) or the operation will be declined. new cidr_block to be added must be placed at the end of the list. Once you migrate to using
cidr_blocksfromcidr_block, you will not be able to switch back. Important: Do not specify a value forcidr_block. Use this parameter instead.
- Map<String>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"} - display
Name String - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- dns
Label String A DNS label for the VCN, used in conjunction with the VNIC's hostname and subnet's DNS label to form a fully qualified domain name (FQDN) for each VNIC within this subnet (for example,
bminstance1.subnet123.vcn1.oraclevcn.com). Not required to be unique, but it's a best practice to set unique DNS labels for VCNs in your tenancy. Must be an alphanumeric string that begins with a letter. The value cannot be changed. You must set this value if you want instances to be able to use hostnames to resolve other instances in the VCN. Otherwise the Internet and VCN Resolver will not work.For more information, see DNS in Your Virtual Cloud Network.
Example:
vcn1- Map<String>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"} - ipv6private
Cidr List<String>Blocks The list of one or more ULA or Private IPv6 CIDR blocks for the vcn that meets the following criteria:
- The CIDR blocks must be valid.
- Multiple CIDR blocks must not overlap each other or the on-premises network prefix.
- The number of CIDR blocks must not exceed the limit of IPv6 prefixes allowed to a VCN.
Important: Do not specify a value for
ipv6cidr_block. Use this parameter instead.- is
Ipv6enabled Boolean - Whether IPv6 is enabled for the VCN. Default is
false. If enabled, Oracle will assign the VCN a IPv6 /56 CIDR block. You may skip having Oracle allocate the VCN a IPv6 /56 CIDR block by setting isOracleGuaAllocationEnabled tofalse. For important details about IPv6 addressing in a VCN, see IPv6 Addresses. Example:true - is
Oracle BooleanGua Allocation Enabled - Specifies whether to skip Oracle allocated IPv6 GUA. By default, Oracle will allocate one GUA of /56 size for an IPv6 enabled VCN.
- security
Attributes Map<String> (Updatable) Security Attributes for this resource. This is unique to ZPR, and helps identify which resources are allowed to be accessed by what permission controls. Example:
{"Oracle-DataSecurity-ZPR.MaxEgressCount.value": "42", "Oracle-DataSecurity-ZPR.MaxEgressCount.mode": "audit"}** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
Outputs
All input properties are implicitly available as output properties. Additionally, the Vcn resource produces the following output properties:
- Byoipv6cidr
Blocks List<string> - The list of BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 ranges.
- Default
Dhcp stringOptions Id - The OCID for the VCN's default set of DHCP options.
- Default
Route stringTable Id - The OCID for the VCN's default route table.
- Default
Security stringList Id - The OCID for the VCN's default security list.
- Id string
- The provider-assigned unique ID for this managed resource.
- Ipv6cidr
Blocks List<string> - For an IPv6-enabled VCN, this is the list of IPv6 prefixes for the VCN's IP address space. The prefixes are provided by Oracle and the sizes are always /56.
- State string
- The VCN's current state.
- Time
Created string - The date and time the VCN was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z - Vcn
Domain stringName - The VCN's domain name, which consists of the VCN's DNS label, and the
oraclevcn.comdomain.
- Byoipv6cidr
Blocks []string - The list of BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 ranges.
- Default
Dhcp stringOptions Id - The OCID for the VCN's default set of DHCP options.
- Default
Route stringTable Id - The OCID for the VCN's default route table.
- Default
Security stringList Id - The OCID for the VCN's default security list.
- Id string
- The provider-assigned unique ID for this managed resource.
- Ipv6cidr
Blocks []string - For an IPv6-enabled VCN, this is the list of IPv6 prefixes for the VCN's IP address space. The prefixes are provided by Oracle and the sizes are always /56.
- State string
- The VCN's current state.
- Time
Created string - The date and time the VCN was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z - Vcn
Domain stringName - The VCN's domain name, which consists of the VCN's DNS label, and the
oraclevcn.comdomain.
- byoipv6cidr
Blocks List<String> - The list of BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 ranges.
- default
Dhcp StringOptions Id - The OCID for the VCN's default set of DHCP options.
- default
Route StringTable Id - The OCID for the VCN's default route table.
- default
Security StringList Id - The OCID for the VCN's default security list.
- id String
- The provider-assigned unique ID for this managed resource.
- ipv6cidr
Blocks List<String> - For an IPv6-enabled VCN, this is the list of IPv6 prefixes for the VCN's IP address space. The prefixes are provided by Oracle and the sizes are always /56.
- state String
- The VCN's current state.
- time
Created String - The date and time the VCN was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z - vcn
Domain StringName - The VCN's domain name, which consists of the VCN's DNS label, and the
oraclevcn.comdomain.
- byoipv6cidr
Blocks string[] - The list of BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 ranges.
- default
Dhcp stringOptions Id - The OCID for the VCN's default set of DHCP options.
- default
Route stringTable Id - The OCID for the VCN's default route table.
- default
Security stringList Id - The OCID for the VCN's default security list.
- id string
- The provider-assigned unique ID for this managed resource.
- ipv6cidr
Blocks string[] - For an IPv6-enabled VCN, this is the list of IPv6 prefixes for the VCN's IP address space. The prefixes are provided by Oracle and the sizes are always /56.
- state string
- The VCN's current state.
- time
Created string - The date and time the VCN was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z - vcn
Domain stringName - The VCN's domain name, which consists of the VCN's DNS label, and the
oraclevcn.comdomain.
- byoipv6cidr_
blocks Sequence[str] - The list of BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 ranges.
- default_
dhcp_ stroptions_ id - The OCID for the VCN's default set of DHCP options.
- default_
route_ strtable_ id - The OCID for the VCN's default route table.
- default_
security_ strlist_ id - The OCID for the VCN's default security list.
- id str
- The provider-assigned unique ID for this managed resource.
- ipv6cidr_
blocks Sequence[str] - For an IPv6-enabled VCN, this is the list of IPv6 prefixes for the VCN's IP address space. The prefixes are provided by Oracle and the sizes are always /56.
- state str
- The VCN's current state.
- time_
created str - The date and time the VCN was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z - vcn_
domain_ strname - The VCN's domain name, which consists of the VCN's DNS label, and the
oraclevcn.comdomain.
- byoipv6cidr
Blocks List<String> - The list of BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 ranges.
- default
Dhcp StringOptions Id - The OCID for the VCN's default set of DHCP options.
- default
Route StringTable Id - The OCID for the VCN's default route table.
- default
Security StringList Id - The OCID for the VCN's default security list.
- id String
- The provider-assigned unique ID for this managed resource.
- ipv6cidr
Blocks List<String> - For an IPv6-enabled VCN, this is the list of IPv6 prefixes for the VCN's IP address space. The prefixes are provided by Oracle and the sizes are always /56.
- state String
- The VCN's current state.
- time
Created String - The date and time the VCN was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z - vcn
Domain StringName - The VCN's domain name, which consists of the VCN's DNS label, and the
oraclevcn.comdomain.
Look up Existing Vcn Resource
Get an existing Vcn 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?: VcnState, opts?: CustomResourceOptions): Vcn@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
byoipv6cidr_blocks: Optional[Sequence[str]] = None,
byoipv6cidr_details: Optional[Sequence[_core.VcnByoipv6cidrDetailArgs]] = None,
cidr_block: Optional[str] = None,
cidr_blocks: Optional[Sequence[str]] = None,
compartment_id: Optional[str] = None,
default_dhcp_options_id: Optional[str] = None,
default_route_table_id: Optional[str] = None,
default_security_list_id: Optional[str] = None,
defined_tags: Optional[Mapping[str, str]] = None,
display_name: Optional[str] = None,
dns_label: Optional[str] = None,
freeform_tags: Optional[Mapping[str, str]] = None,
ipv6cidr_blocks: Optional[Sequence[str]] = None,
ipv6private_cidr_blocks: Optional[Sequence[str]] = None,
is_ipv6enabled: Optional[bool] = None,
is_oracle_gua_allocation_enabled: Optional[bool] = None,
security_attributes: Optional[Mapping[str, str]] = None,
state: Optional[str] = None,
time_created: Optional[str] = None,
vcn_domain_name: Optional[str] = None) -> Vcnfunc GetVcn(ctx *Context, name string, id IDInput, state *VcnState, opts ...ResourceOption) (*Vcn, error)public static Vcn Get(string name, Input<string> id, VcnState? state, CustomResourceOptions? opts = null)public static Vcn get(String name, Output<String> id, VcnState state, CustomResourceOptions options)Resource lookup is not supported in YAML- 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.
- Byoipv6cidr
Blocks List<string> - The list of BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 ranges.
- Byoipv6cidr
Details List<VcnByoipv6cidr Detail> - The list of BYOIPv6 OCIDs and BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 address ranges.
- Cidr
Block string - Deprecated. Do not set this value. Use
cidr_blocksinstead. Example:10.0.0.0/16 - Cidr
Blocks List<string> - (Updatable) The list of one or more IPv4 CIDR blocks for the VCN that meet the following criteria:
- The CIDR blocks must be valid.
- They must not overlap with each other or with the on-premises network CIDR block.
- The number of CIDR blocks must not exceed the limit of CIDR blocks allowed per VCN. It is an error to set both cidr_block and cidr_blocks. Note: cidr_blocks update must be restricted to one operation at a time (either add/remove or modify one single cidr_block) or the operation will be declined. new cidr_block to be added must be placed at the end of the list. Once you migrate to using
cidr_blocksfromcidr_block, you will not be able to switch back. Important: Do not specify a value forcidr_block. Use this parameter instead.
- Compartment
Id string - (Updatable) The OCID of the compartment to contain the VCN.
- Default
Dhcp stringOptions Id - The OCID for the VCN's default set of DHCP options.
- Default
Route stringTable Id - The OCID for the VCN's default route table.
- Default
Security stringList Id - The OCID for the VCN's default security list.
- Dictionary<string, string>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"} - Display
Name string - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- Dns
Label string A DNS label for the VCN, used in conjunction with the VNIC's hostname and subnet's DNS label to form a fully qualified domain name (FQDN) for each VNIC within this subnet (for example,
bminstance1.subnet123.vcn1.oraclevcn.com). Not required to be unique, but it's a best practice to set unique DNS labels for VCNs in your tenancy. Must be an alphanumeric string that begins with a letter. The value cannot be changed. You must set this value if you want instances to be able to use hostnames to resolve other instances in the VCN. Otherwise the Internet and VCN Resolver will not work.For more information, see DNS in Your Virtual Cloud Network.
Example:
vcn1- Dictionary<string, string>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"} - Ipv6cidr
Blocks List<string> - For an IPv6-enabled VCN, this is the list of IPv6 prefixes for the VCN's IP address space. The prefixes are provided by Oracle and the sizes are always /56.
- Ipv6private
Cidr List<string>Blocks The list of one or more ULA or Private IPv6 CIDR blocks for the vcn that meets the following criteria:
- The CIDR blocks must be valid.
- Multiple CIDR blocks must not overlap each other or the on-premises network prefix.
- The number of CIDR blocks must not exceed the limit of IPv6 prefixes allowed to a VCN.
Important: Do not specify a value for
ipv6cidr_block. Use this parameter instead.- Is
Ipv6enabled bool - Whether IPv6 is enabled for the VCN. Default is
false. If enabled, Oracle will assign the VCN a IPv6 /56 CIDR block. You may skip having Oracle allocate the VCN a IPv6 /56 CIDR block by setting isOracleGuaAllocationEnabled tofalse. For important details about IPv6 addressing in a VCN, see IPv6 Addresses. Example:true - Is
Oracle boolGua Allocation Enabled - Specifies whether to skip Oracle allocated IPv6 GUA. By default, Oracle will allocate one GUA of /56 size for an IPv6 enabled VCN.
- Security
Attributes Dictionary<string, string> (Updatable) Security Attributes for this resource. This is unique to ZPR, and helps identify which resources are allowed to be accessed by what permission controls. Example:
{"Oracle-DataSecurity-ZPR.MaxEgressCount.value": "42", "Oracle-DataSecurity-ZPR.MaxEgressCount.mode": "audit"}** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- State string
- The VCN's current state.
- Time
Created string - The date and time the VCN was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z - Vcn
Domain stringName - The VCN's domain name, which consists of the VCN's DNS label, and the
oraclevcn.comdomain.
- Byoipv6cidr
Blocks []string - The list of BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 ranges.
- Byoipv6cidr
Details []VcnByoipv6cidr Detail Args - The list of BYOIPv6 OCIDs and BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 address ranges.
- Cidr
Block string - Deprecated. Do not set this value. Use
cidr_blocksinstead. Example:10.0.0.0/16 - Cidr
Blocks []string - (Updatable) The list of one or more IPv4 CIDR blocks for the VCN that meet the following criteria:
- The CIDR blocks must be valid.
- They must not overlap with each other or with the on-premises network CIDR block.
- The number of CIDR blocks must not exceed the limit of CIDR blocks allowed per VCN. It is an error to set both cidr_block and cidr_blocks. Note: cidr_blocks update must be restricted to one operation at a time (either add/remove or modify one single cidr_block) or the operation will be declined. new cidr_block to be added must be placed at the end of the list. Once you migrate to using
cidr_blocksfromcidr_block, you will not be able to switch back. Important: Do not specify a value forcidr_block. Use this parameter instead.
- Compartment
Id string - (Updatable) The OCID of the compartment to contain the VCN.
- Default
Dhcp stringOptions Id - The OCID for the VCN's default set of DHCP options.
- Default
Route stringTable Id - The OCID for the VCN's default route table.
- Default
Security stringList Id - The OCID for the VCN's default security list.
- map[string]string
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"} - Display
Name string - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- Dns
Label string A DNS label for the VCN, used in conjunction with the VNIC's hostname and subnet's DNS label to form a fully qualified domain name (FQDN) for each VNIC within this subnet (for example,
bminstance1.subnet123.vcn1.oraclevcn.com). Not required to be unique, but it's a best practice to set unique DNS labels for VCNs in your tenancy. Must be an alphanumeric string that begins with a letter. The value cannot be changed. You must set this value if you want instances to be able to use hostnames to resolve other instances in the VCN. Otherwise the Internet and VCN Resolver will not work.For more information, see DNS in Your Virtual Cloud Network.
Example:
vcn1- map[string]string
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"} - Ipv6cidr
Blocks []string - For an IPv6-enabled VCN, this is the list of IPv6 prefixes for the VCN's IP address space. The prefixes are provided by Oracle and the sizes are always /56.
- Ipv6private
Cidr []stringBlocks The list of one or more ULA or Private IPv6 CIDR blocks for the vcn that meets the following criteria:
- The CIDR blocks must be valid.
- Multiple CIDR blocks must not overlap each other or the on-premises network prefix.
- The number of CIDR blocks must not exceed the limit of IPv6 prefixes allowed to a VCN.
Important: Do not specify a value for
ipv6cidr_block. Use this parameter instead.- Is
Ipv6enabled bool - Whether IPv6 is enabled for the VCN. Default is
false. If enabled, Oracle will assign the VCN a IPv6 /56 CIDR block. You may skip having Oracle allocate the VCN a IPv6 /56 CIDR block by setting isOracleGuaAllocationEnabled tofalse. For important details about IPv6 addressing in a VCN, see IPv6 Addresses. Example:true - Is
Oracle boolGua Allocation Enabled - Specifies whether to skip Oracle allocated IPv6 GUA. By default, Oracle will allocate one GUA of /56 size for an IPv6 enabled VCN.
- Security
Attributes map[string]string (Updatable) Security Attributes for this resource. This is unique to ZPR, and helps identify which resources are allowed to be accessed by what permission controls. Example:
{"Oracle-DataSecurity-ZPR.MaxEgressCount.value": "42", "Oracle-DataSecurity-ZPR.MaxEgressCount.mode": "audit"}** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- State string
- The VCN's current state.
- Time
Created string - The date and time the VCN was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z - Vcn
Domain stringName - The VCN's domain name, which consists of the VCN's DNS label, and the
oraclevcn.comdomain.
- byoipv6cidr
Blocks List<String> - The list of BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 ranges.
- byoipv6cidr
Details List<VcnByoipv6cidr Detail> - The list of BYOIPv6 OCIDs and BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 address ranges.
- cidr
Block String - Deprecated. Do not set this value. Use
cidr_blocksinstead. Example:10.0.0.0/16 - cidr
Blocks List<String> - (Updatable) The list of one or more IPv4 CIDR blocks for the VCN that meet the following criteria:
- The CIDR blocks must be valid.
- They must not overlap with each other or with the on-premises network CIDR block.
- The number of CIDR blocks must not exceed the limit of CIDR blocks allowed per VCN. It is an error to set both cidr_block and cidr_blocks. Note: cidr_blocks update must be restricted to one operation at a time (either add/remove or modify one single cidr_block) or the operation will be declined. new cidr_block to be added must be placed at the end of the list. Once you migrate to using
cidr_blocksfromcidr_block, you will not be able to switch back. Important: Do not specify a value forcidr_block. Use this parameter instead.
- compartment
Id String - (Updatable) The OCID of the compartment to contain the VCN.
- default
Dhcp StringOptions Id - The OCID for the VCN's default set of DHCP options.
- default
Route StringTable Id - The OCID for the VCN's default route table.
- default
Security StringList Id - The OCID for the VCN's default security list.
- Map<String,String>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"} - display
Name String - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- dns
Label String A DNS label for the VCN, used in conjunction with the VNIC's hostname and subnet's DNS label to form a fully qualified domain name (FQDN) for each VNIC within this subnet (for example,
bminstance1.subnet123.vcn1.oraclevcn.com). Not required to be unique, but it's a best practice to set unique DNS labels for VCNs in your tenancy. Must be an alphanumeric string that begins with a letter. The value cannot be changed. You must set this value if you want instances to be able to use hostnames to resolve other instances in the VCN. Otherwise the Internet and VCN Resolver will not work.For more information, see DNS in Your Virtual Cloud Network.
Example:
vcn1- Map<String,String>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"} - ipv6cidr
Blocks List<String> - For an IPv6-enabled VCN, this is the list of IPv6 prefixes for the VCN's IP address space. The prefixes are provided by Oracle and the sizes are always /56.
- ipv6private
Cidr List<String>Blocks The list of one or more ULA or Private IPv6 CIDR blocks for the vcn that meets the following criteria:
- The CIDR blocks must be valid.
- Multiple CIDR blocks must not overlap each other or the on-premises network prefix.
- The number of CIDR blocks must not exceed the limit of IPv6 prefixes allowed to a VCN.
Important: Do not specify a value for
ipv6cidr_block. Use this parameter instead.- is
Ipv6enabled Boolean - Whether IPv6 is enabled for the VCN. Default is
false. If enabled, Oracle will assign the VCN a IPv6 /56 CIDR block. You may skip having Oracle allocate the VCN a IPv6 /56 CIDR block by setting isOracleGuaAllocationEnabled tofalse. For important details about IPv6 addressing in a VCN, see IPv6 Addresses. Example:true - is
Oracle BooleanGua Allocation Enabled - Specifies whether to skip Oracle allocated IPv6 GUA. By default, Oracle will allocate one GUA of /56 size for an IPv6 enabled VCN.
- security
Attributes Map<String,String> (Updatable) Security Attributes for this resource. This is unique to ZPR, and helps identify which resources are allowed to be accessed by what permission controls. Example:
{"Oracle-DataSecurity-ZPR.MaxEgressCount.value": "42", "Oracle-DataSecurity-ZPR.MaxEgressCount.mode": "audit"}** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- state String
- The VCN's current state.
- time
Created String - The date and time the VCN was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z - vcn
Domain StringName - The VCN's domain name, which consists of the VCN's DNS label, and the
oraclevcn.comdomain.
- byoipv6cidr
Blocks string[] - The list of BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 ranges.
- byoipv6cidr
Details VcnByoipv6cidr Detail[] - The list of BYOIPv6 OCIDs and BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 address ranges.
- cidr
Block string - Deprecated. Do not set this value. Use
cidr_blocksinstead. Example:10.0.0.0/16 - cidr
Blocks string[] - (Updatable) The list of one or more IPv4 CIDR blocks for the VCN that meet the following criteria:
- The CIDR blocks must be valid.
- They must not overlap with each other or with the on-premises network CIDR block.
- The number of CIDR blocks must not exceed the limit of CIDR blocks allowed per VCN. It is an error to set both cidr_block and cidr_blocks. Note: cidr_blocks update must be restricted to one operation at a time (either add/remove or modify one single cidr_block) or the operation will be declined. new cidr_block to be added must be placed at the end of the list. Once you migrate to using
cidr_blocksfromcidr_block, you will not be able to switch back. Important: Do not specify a value forcidr_block. Use this parameter instead.
- compartment
Id string - (Updatable) The OCID of the compartment to contain the VCN.
- default
Dhcp stringOptions Id - The OCID for the VCN's default set of DHCP options.
- default
Route stringTable Id - The OCID for the VCN's default route table.
- default
Security stringList Id - The OCID for the VCN's default security list.
- {[key: string]: string}
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"} - display
Name string - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- dns
Label string A DNS label for the VCN, used in conjunction with the VNIC's hostname and subnet's DNS label to form a fully qualified domain name (FQDN) for each VNIC within this subnet (for example,
bminstance1.subnet123.vcn1.oraclevcn.com). Not required to be unique, but it's a best practice to set unique DNS labels for VCNs in your tenancy. Must be an alphanumeric string that begins with a letter. The value cannot be changed. You must set this value if you want instances to be able to use hostnames to resolve other instances in the VCN. Otherwise the Internet and VCN Resolver will not work.For more information, see DNS in Your Virtual Cloud Network.
Example:
vcn1- {[key: string]: string}
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"} - ipv6cidr
Blocks string[] - For an IPv6-enabled VCN, this is the list of IPv6 prefixes for the VCN's IP address space. The prefixes are provided by Oracle and the sizes are always /56.
- ipv6private
Cidr string[]Blocks The list of one or more ULA or Private IPv6 CIDR blocks for the vcn that meets the following criteria:
- The CIDR blocks must be valid.
- Multiple CIDR blocks must not overlap each other or the on-premises network prefix.
- The number of CIDR blocks must not exceed the limit of IPv6 prefixes allowed to a VCN.
Important: Do not specify a value for
ipv6cidr_block. Use this parameter instead.- is
Ipv6enabled boolean - Whether IPv6 is enabled for the VCN. Default is
false. If enabled, Oracle will assign the VCN a IPv6 /56 CIDR block. You may skip having Oracle allocate the VCN a IPv6 /56 CIDR block by setting isOracleGuaAllocationEnabled tofalse. For important details about IPv6 addressing in a VCN, see IPv6 Addresses. Example:true - is
Oracle booleanGua Allocation Enabled - Specifies whether to skip Oracle allocated IPv6 GUA. By default, Oracle will allocate one GUA of /56 size for an IPv6 enabled VCN.
- security
Attributes {[key: string]: string} (Updatable) Security Attributes for this resource. This is unique to ZPR, and helps identify which resources are allowed to be accessed by what permission controls. Example:
{"Oracle-DataSecurity-ZPR.MaxEgressCount.value": "42", "Oracle-DataSecurity-ZPR.MaxEgressCount.mode": "audit"}** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- state string
- The VCN's current state.
- time
Created string - The date and time the VCN was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z - vcn
Domain stringName - The VCN's domain name, which consists of the VCN's DNS label, and the
oraclevcn.comdomain.
- byoipv6cidr_
blocks Sequence[str] - The list of BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 ranges.
- byoipv6cidr_
details Sequence[core.Vcn Byoipv6cidr Detail Args] - The list of BYOIPv6 OCIDs and BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 address ranges.
- cidr_
block str - Deprecated. Do not set this value. Use
cidr_blocksinstead. Example:10.0.0.0/16 - cidr_
blocks Sequence[str] - (Updatable) The list of one or more IPv4 CIDR blocks for the VCN that meet the following criteria:
- The CIDR blocks must be valid.
- They must not overlap with each other or with the on-premises network CIDR block.
- The number of CIDR blocks must not exceed the limit of CIDR blocks allowed per VCN. It is an error to set both cidr_block and cidr_blocks. Note: cidr_blocks update must be restricted to one operation at a time (either add/remove or modify one single cidr_block) or the operation will be declined. new cidr_block to be added must be placed at the end of the list. Once you migrate to using
cidr_blocksfromcidr_block, you will not be able to switch back. Important: Do not specify a value forcidr_block. Use this parameter instead.
- compartment_
id str - (Updatable) The OCID of the compartment to contain the VCN.
- default_
dhcp_ stroptions_ id - The OCID for the VCN's default set of DHCP options.
- default_
route_ strtable_ id - The OCID for the VCN's default route table.
- default_
security_ strlist_ id - The OCID for the VCN's default security list.
- Mapping[str, str]
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"} - display_
name str - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- dns_
label str A DNS label for the VCN, used in conjunction with the VNIC's hostname and subnet's DNS label to form a fully qualified domain name (FQDN) for each VNIC within this subnet (for example,
bminstance1.subnet123.vcn1.oraclevcn.com). Not required to be unique, but it's a best practice to set unique DNS labels for VCNs in your tenancy. Must be an alphanumeric string that begins with a letter. The value cannot be changed. You must set this value if you want instances to be able to use hostnames to resolve other instances in the VCN. Otherwise the Internet and VCN Resolver will not work.For more information, see DNS in Your Virtual Cloud Network.
Example:
vcn1- Mapping[str, str]
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"} - ipv6cidr_
blocks Sequence[str] - For an IPv6-enabled VCN, this is the list of IPv6 prefixes for the VCN's IP address space. The prefixes are provided by Oracle and the sizes are always /56.
- ipv6private_
cidr_ Sequence[str]blocks The list of one or more ULA or Private IPv6 CIDR blocks for the vcn that meets the following criteria:
- The CIDR blocks must be valid.
- Multiple CIDR blocks must not overlap each other or the on-premises network prefix.
- The number of CIDR blocks must not exceed the limit of IPv6 prefixes allowed to a VCN.
Important: Do not specify a value for
ipv6cidr_block. Use this parameter instead.- is_
ipv6enabled bool - Whether IPv6 is enabled for the VCN. Default is
false. If enabled, Oracle will assign the VCN a IPv6 /56 CIDR block. You may skip having Oracle allocate the VCN a IPv6 /56 CIDR block by setting isOracleGuaAllocationEnabled tofalse. For important details about IPv6 addressing in a VCN, see IPv6 Addresses. Example:true - is_
oracle_ boolgua_ allocation_ enabled - Specifies whether to skip Oracle allocated IPv6 GUA. By default, Oracle will allocate one GUA of /56 size for an IPv6 enabled VCN.
- security_
attributes Mapping[str, str] (Updatable) Security Attributes for this resource. This is unique to ZPR, and helps identify which resources are allowed to be accessed by what permission controls. Example:
{"Oracle-DataSecurity-ZPR.MaxEgressCount.value": "42", "Oracle-DataSecurity-ZPR.MaxEgressCount.mode": "audit"}** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- state str
- The VCN's current state.
- time_
created str - The date and time the VCN was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z - vcn_
domain_ strname - The VCN's domain name, which consists of the VCN's DNS label, and the
oraclevcn.comdomain.
- byoipv6cidr
Blocks List<String> - The list of BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 ranges.
- byoipv6cidr
Details List<Property Map> - The list of BYOIPv6 OCIDs and BYOIPv6 prefixes required to create a VCN that uses BYOIPv6 address ranges.
- cidr
Block String - Deprecated. Do not set this value. Use
cidr_blocksinstead. Example:10.0.0.0/16 - cidr
Blocks List<String> - (Updatable) The list of one or more IPv4 CIDR blocks for the VCN that meet the following criteria:
- The CIDR blocks must be valid.
- They must not overlap with each other or with the on-premises network CIDR block.
- The number of CIDR blocks must not exceed the limit of CIDR blocks allowed per VCN. It is an error to set both cidr_block and cidr_blocks. Note: cidr_blocks update must be restricted to one operation at a time (either add/remove or modify one single cidr_block) or the operation will be declined. new cidr_block to be added must be placed at the end of the list. Once you migrate to using
cidr_blocksfromcidr_block, you will not be able to switch back. Important: Do not specify a value forcidr_block. Use this parameter instead.
- compartment
Id String - (Updatable) The OCID of the compartment to contain the VCN.
- default
Dhcp StringOptions Id - The OCID for the VCN's default set of DHCP options.
- default
Route StringTable Id - The OCID for the VCN's default route table.
- default
Security StringList Id - The OCID for the VCN's default security list.
- Map<String>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"} - display
Name String - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- dns
Label String A DNS label for the VCN, used in conjunction with the VNIC's hostname and subnet's DNS label to form a fully qualified domain name (FQDN) for each VNIC within this subnet (for example,
bminstance1.subnet123.vcn1.oraclevcn.com). Not required to be unique, but it's a best practice to set unique DNS labels for VCNs in your tenancy. Must be an alphanumeric string that begins with a letter. The value cannot be changed. You must set this value if you want instances to be able to use hostnames to resolve other instances in the VCN. Otherwise the Internet and VCN Resolver will not work.For more information, see DNS in Your Virtual Cloud Network.
Example:
vcn1- Map<String>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"} - ipv6cidr
Blocks List<String> - For an IPv6-enabled VCN, this is the list of IPv6 prefixes for the VCN's IP address space. The prefixes are provided by Oracle and the sizes are always /56.
- ipv6private
Cidr List<String>Blocks The list of one or more ULA or Private IPv6 CIDR blocks for the vcn that meets the following criteria:
- The CIDR blocks must be valid.
- Multiple CIDR blocks must not overlap each other or the on-premises network prefix.
- The number of CIDR blocks must not exceed the limit of IPv6 prefixes allowed to a VCN.
Important: Do not specify a value for
ipv6cidr_block. Use this parameter instead.- is
Ipv6enabled Boolean - Whether IPv6 is enabled for the VCN. Default is
false. If enabled, Oracle will assign the VCN a IPv6 /56 CIDR block. You may skip having Oracle allocate the VCN a IPv6 /56 CIDR block by setting isOracleGuaAllocationEnabled tofalse. For important details about IPv6 addressing in a VCN, see IPv6 Addresses. Example:true - is
Oracle BooleanGua Allocation Enabled - Specifies whether to skip Oracle allocated IPv6 GUA. By default, Oracle will allocate one GUA of /56 size for an IPv6 enabled VCN.
- security
Attributes Map<String> (Updatable) Security Attributes for this resource. This is unique to ZPR, and helps identify which resources are allowed to be accessed by what permission controls. Example:
{"Oracle-DataSecurity-ZPR.MaxEgressCount.value": "42", "Oracle-DataSecurity-ZPR.MaxEgressCount.mode": "audit"}** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- state String
- The VCN's current state.
- time
Created String - The date and time the VCN was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z - vcn
Domain StringName - The VCN's domain name, which consists of the VCN's DNS label, and the
oraclevcn.comdomain.
Supporting Types
VcnByoipv6cidrDetail, VcnByoipv6cidrDetailArgs
- Byoipv6range
Id string - The OCID of the
ByoipRangeresource to which the CIDR block belongs. - Ipv6cidr
Block string - An IPv6 prefix required to create a VCN with a BYOIP prefix. It could be the whole prefix identified in
byoipv6RangeId, or a subrange. Example:2001:0db8:0123::/48
- Byoipv6range
Id string - The OCID of the
ByoipRangeresource to which the CIDR block belongs. - Ipv6cidr
Block string - An IPv6 prefix required to create a VCN with a BYOIP prefix. It could be the whole prefix identified in
byoipv6RangeId, or a subrange. Example:2001:0db8:0123::/48
- byoipv6range
Id String - The OCID of the
ByoipRangeresource to which the CIDR block belongs. - ipv6cidr
Block String - An IPv6 prefix required to create a VCN with a BYOIP prefix. It could be the whole prefix identified in
byoipv6RangeId, or a subrange. Example:2001:0db8:0123::/48
- byoipv6range
Id string - The OCID of the
ByoipRangeresource to which the CIDR block belongs. - ipv6cidr
Block string - An IPv6 prefix required to create a VCN with a BYOIP prefix. It could be the whole prefix identified in
byoipv6RangeId, or a subrange. Example:2001:0db8:0123::/48
- byoipv6range_
id str - The OCID of the
ByoipRangeresource to which the CIDR block belongs. - ipv6cidr_
block str - An IPv6 prefix required to create a VCN with a BYOIP prefix. It could be the whole prefix identified in
byoipv6RangeId, or a subrange. Example:2001:0db8:0123::/48
- byoipv6range
Id String - The OCID of the
ByoipRangeresource to which the CIDR block belongs. - ipv6cidr
Block String - An IPv6 prefix required to create a VCN with a BYOIP prefix. It could be the whole prefix identified in
byoipv6RangeId, or a subrange. Example:2001:0db8:0123::/48
Import
Vcns can be imported using the id, e.g.
$ pulumi import oci:Core/vcn:Vcn test_vcn "id"
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- oci pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
ociTerraform Provider.