gcp.compute.Network
Explore with Pulumi AI
Manages a VPC network or legacy network resource on GCP.
To get more information about Network, see:
- API documentation
- How-to Guides
Example Usage
Network Basic
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const vpcNetwork = new gcp.compute.Network("vpc_network", {name: "vpc-network"});
import pulumi
import pulumi_gcp as gcp
vpc_network = gcp.compute.Network("vpc_network", name="vpc-network")
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/compute"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := compute.NewNetwork(ctx, "vpc_network", &compute.NetworkArgs{
Name: pulumi.String("vpc-network"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var vpcNetwork = new Gcp.Compute.Network("vpc_network", new()
{
Name = "vpc-network",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.Network;
import com.pulumi.gcp.compute.NetworkArgs;
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 vpcNetwork = new Network("vpcNetwork", NetworkArgs.builder()
.name("vpc-network")
.build());
}
}
resources:
vpcNetwork:
type: gcp:compute:Network
name: vpc_network
properties:
name: vpc-network
Network Custom Mtu
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const vpcNetwork = new gcp.compute.Network("vpc_network", {
project: "my-project-name",
name: "vpc-network",
autoCreateSubnetworks: true,
mtu: 1460,
});
import pulumi
import pulumi_gcp as gcp
vpc_network = gcp.compute.Network("vpc_network",
project="my-project-name",
name="vpc-network",
auto_create_subnetworks=True,
mtu=1460)
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/compute"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := compute.NewNetwork(ctx, "vpc_network", &compute.NetworkArgs{
Project: pulumi.String("my-project-name"),
Name: pulumi.String("vpc-network"),
AutoCreateSubnetworks: pulumi.Bool(true),
Mtu: pulumi.Int(1460),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var vpcNetwork = new Gcp.Compute.Network("vpc_network", new()
{
Project = "my-project-name",
Name = "vpc-network",
AutoCreateSubnetworks = true,
Mtu = 1460,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.Network;
import com.pulumi.gcp.compute.NetworkArgs;
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 vpcNetwork = new Network("vpcNetwork", NetworkArgs.builder()
.project("my-project-name")
.name("vpc-network")
.autoCreateSubnetworks(true)
.mtu(1460)
.build());
}
}
resources:
vpcNetwork:
type: gcp:compute:Network
name: vpc_network
properties:
project: my-project-name
name: vpc-network
autoCreateSubnetworks: true
mtu: 1460
Network Custom Firewall Enforcement Order
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const vpcNetwork = new gcp.compute.Network("vpc_network", {
project: "my-project-name",
name: "vpc-network",
autoCreateSubnetworks: true,
networkFirewallPolicyEnforcementOrder: "BEFORE_CLASSIC_FIREWALL",
});
import pulumi
import pulumi_gcp as gcp
vpc_network = gcp.compute.Network("vpc_network",
project="my-project-name",
name="vpc-network",
auto_create_subnetworks=True,
network_firewall_policy_enforcement_order="BEFORE_CLASSIC_FIREWALL")
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/compute"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := compute.NewNetwork(ctx, "vpc_network", &compute.NetworkArgs{
Project: pulumi.String("my-project-name"),
Name: pulumi.String("vpc-network"),
AutoCreateSubnetworks: pulumi.Bool(true),
NetworkFirewallPolicyEnforcementOrder: pulumi.String("BEFORE_CLASSIC_FIREWALL"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var vpcNetwork = new Gcp.Compute.Network("vpc_network", new()
{
Project = "my-project-name",
Name = "vpc-network",
AutoCreateSubnetworks = true,
NetworkFirewallPolicyEnforcementOrder = "BEFORE_CLASSIC_FIREWALL",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.Network;
import com.pulumi.gcp.compute.NetworkArgs;
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 vpcNetwork = new Network("vpcNetwork", NetworkArgs.builder()
.project("my-project-name")
.name("vpc-network")
.autoCreateSubnetworks(true)
.networkFirewallPolicyEnforcementOrder("BEFORE_CLASSIC_FIREWALL")
.build());
}
}
resources:
vpcNetwork:
type: gcp:compute:Network
name: vpc_network
properties:
project: my-project-name
name: vpc-network
autoCreateSubnetworks: true
networkFirewallPolicyEnforcementOrder: BEFORE_CLASSIC_FIREWALL
Network Bgp Best Path Selection Mode
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const vpcNetwork = new gcp.compute.Network("vpc_network", {
project: "my-project-name",
name: "vpc-network",
routingMode: "GLOBAL",
});
import pulumi
import pulumi_gcp as gcp
vpc_network = gcp.compute.Network("vpc_network",
project="my-project-name",
name="vpc-network",
routing_mode="GLOBAL")
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/compute"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := compute.NewNetwork(ctx, "vpc_network", &compute.NetworkArgs{
Project: pulumi.String("my-project-name"),
Name: pulumi.String("vpc-network"),
RoutingMode: pulumi.String("GLOBAL"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var vpcNetwork = new Gcp.Compute.Network("vpc_network", new()
{
Project = "my-project-name",
Name = "vpc-network",
RoutingMode = "GLOBAL",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.Network;
import com.pulumi.gcp.compute.NetworkArgs;
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 vpcNetwork = new Network("vpcNetwork", NetworkArgs.builder()
.project("my-project-name")
.name("vpc-network")
.routingMode("GLOBAL")
.build());
}
}
resources:
vpcNetwork:
type: gcp:compute:Network
name: vpc_network
properties:
project: my-project-name
name: vpc-network
routingMode: GLOBAL
Network Bgp Best Path Selection Mode Standard
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const vpcNetwork = new gcp.compute.Network("vpc_network", {
project: "my-project-name",
name: "vpc-network",
routingMode: "GLOBAL",
bgpBestPathSelectionMode: "STANDARD",
});
import pulumi
import pulumi_gcp as gcp
vpc_network = gcp.compute.Network("vpc_network",
project="my-project-name",
name="vpc-network",
routing_mode="GLOBAL",
bgp_best_path_selection_mode="STANDARD")
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/compute"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := compute.NewNetwork(ctx, "vpc_network", &compute.NetworkArgs{
Project: pulumi.String("my-project-name"),
Name: pulumi.String("vpc-network"),
RoutingMode: pulumi.String("GLOBAL"),
BgpBestPathSelectionMode: pulumi.String("STANDARD"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var vpcNetwork = new Gcp.Compute.Network("vpc_network", new()
{
Project = "my-project-name",
Name = "vpc-network",
RoutingMode = "GLOBAL",
BgpBestPathSelectionMode = "STANDARD",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.Network;
import com.pulumi.gcp.compute.NetworkArgs;
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 vpcNetwork = new Network("vpcNetwork", NetworkArgs.builder()
.project("my-project-name")
.name("vpc-network")
.routingMode("GLOBAL")
.bgpBestPathSelectionMode("STANDARD")
.build());
}
}
resources:
vpcNetwork:
type: gcp:compute:Network
name: vpc_network
properties:
project: my-project-name
name: vpc-network
routingMode: GLOBAL
bgpBestPathSelectionMode: STANDARD
Network Bgp Best Path Selection Mode Standard Custom Fields
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const vpcNetwork = new gcp.compute.Network("vpc_network", {
project: "my-project-name",
name: "vpc-network",
routingMode: "GLOBAL",
bgpBestPathSelectionMode: "STANDARD",
bgpAlwaysCompareMed: true,
bgpInterRegionCost: "ADD_COST_TO_MED",
});
import pulumi
import pulumi_gcp as gcp
vpc_network = gcp.compute.Network("vpc_network",
project="my-project-name",
name="vpc-network",
routing_mode="GLOBAL",
bgp_best_path_selection_mode="STANDARD",
bgp_always_compare_med=True,
bgp_inter_region_cost="ADD_COST_TO_MED")
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/compute"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := compute.NewNetwork(ctx, "vpc_network", &compute.NetworkArgs{
Project: pulumi.String("my-project-name"),
Name: pulumi.String("vpc-network"),
RoutingMode: pulumi.String("GLOBAL"),
BgpBestPathSelectionMode: pulumi.String("STANDARD"),
BgpAlwaysCompareMed: pulumi.Bool(true),
BgpInterRegionCost: pulumi.String("ADD_COST_TO_MED"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var vpcNetwork = new Gcp.Compute.Network("vpc_network", new()
{
Project = "my-project-name",
Name = "vpc-network",
RoutingMode = "GLOBAL",
BgpBestPathSelectionMode = "STANDARD",
BgpAlwaysCompareMed = true,
BgpInterRegionCost = "ADD_COST_TO_MED",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.Network;
import com.pulumi.gcp.compute.NetworkArgs;
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 vpcNetwork = new Network("vpcNetwork", NetworkArgs.builder()
.project("my-project-name")
.name("vpc-network")
.routingMode("GLOBAL")
.bgpBestPathSelectionMode("STANDARD")
.bgpAlwaysCompareMed(true)
.bgpInterRegionCost("ADD_COST_TO_MED")
.build());
}
}
resources:
vpcNetwork:
type: gcp:compute:Network
name: vpc_network
properties:
project: my-project-name
name: vpc-network
routingMode: GLOBAL
bgpBestPathSelectionMode: STANDARD
bgpAlwaysCompareMed: true
bgpInterRegionCost: ADD_COST_TO_MED
Create Network Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Network(name: string, args?: NetworkArgs, opts?: CustomResourceOptions);
@overload
def Network(resource_name: str,
args: Optional[NetworkArgs] = None,
opts: Optional[ResourceOptions] = None)
@overload
def Network(resource_name: str,
opts: Optional[ResourceOptions] = None,
auto_create_subnetworks: Optional[bool] = None,
bgp_always_compare_med: Optional[bool] = None,
bgp_best_path_selection_mode: Optional[str] = None,
bgp_inter_region_cost: Optional[str] = None,
delete_default_routes_on_create: Optional[bool] = None,
description: Optional[str] = None,
enable_ula_internal_ipv6: Optional[bool] = None,
internal_ipv6_range: Optional[str] = None,
mtu: Optional[int] = None,
name: Optional[str] = None,
network_firewall_policy_enforcement_order: Optional[str] = None,
project: Optional[str] = None,
routing_mode: Optional[str] = None)
func NewNetwork(ctx *Context, name string, args *NetworkArgs, opts ...ResourceOption) (*Network, error)
public Network(string name, NetworkArgs? args = null, CustomResourceOptions? opts = null)
public Network(String name, NetworkArgs args)
public Network(String name, NetworkArgs args, CustomResourceOptions options)
type: gcp:compute:Network
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 NetworkArgs
- 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 NetworkArgs
- 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 NetworkArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args NetworkArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args NetworkArgs
- 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 networkResource = new Gcp.Compute.Network("networkResource", new()
{
AutoCreateSubnetworks = false,
BgpAlwaysCompareMed = false,
BgpBestPathSelectionMode = "string",
BgpInterRegionCost = "string",
DeleteDefaultRoutesOnCreate = false,
Description = "string",
EnableUlaInternalIpv6 = false,
InternalIpv6Range = "string",
Mtu = 0,
Name = "string",
NetworkFirewallPolicyEnforcementOrder = "string",
Project = "string",
RoutingMode = "string",
});
example, err := compute.NewNetwork(ctx, "networkResource", &compute.NetworkArgs{
AutoCreateSubnetworks: pulumi.Bool(false),
BgpAlwaysCompareMed: pulumi.Bool(false),
BgpBestPathSelectionMode: pulumi.String("string"),
BgpInterRegionCost: pulumi.String("string"),
DeleteDefaultRoutesOnCreate: pulumi.Bool(false),
Description: pulumi.String("string"),
EnableUlaInternalIpv6: pulumi.Bool(false),
InternalIpv6Range: pulumi.String("string"),
Mtu: pulumi.Int(0),
Name: pulumi.String("string"),
NetworkFirewallPolicyEnforcementOrder: pulumi.String("string"),
Project: pulumi.String("string"),
RoutingMode: pulumi.String("string"),
})
var networkResource = new Network("networkResource", NetworkArgs.builder()
.autoCreateSubnetworks(false)
.bgpAlwaysCompareMed(false)
.bgpBestPathSelectionMode("string")
.bgpInterRegionCost("string")
.deleteDefaultRoutesOnCreate(false)
.description("string")
.enableUlaInternalIpv6(false)
.internalIpv6Range("string")
.mtu(0)
.name("string")
.networkFirewallPolicyEnforcementOrder("string")
.project("string")
.routingMode("string")
.build());
network_resource = gcp.compute.Network("networkResource",
auto_create_subnetworks=False,
bgp_always_compare_med=False,
bgp_best_path_selection_mode="string",
bgp_inter_region_cost="string",
delete_default_routes_on_create=False,
description="string",
enable_ula_internal_ipv6=False,
internal_ipv6_range="string",
mtu=0,
name="string",
network_firewall_policy_enforcement_order="string",
project="string",
routing_mode="string")
const networkResource = new gcp.compute.Network("networkResource", {
autoCreateSubnetworks: false,
bgpAlwaysCompareMed: false,
bgpBestPathSelectionMode: "string",
bgpInterRegionCost: "string",
deleteDefaultRoutesOnCreate: false,
description: "string",
enableUlaInternalIpv6: false,
internalIpv6Range: "string",
mtu: 0,
name: "string",
networkFirewallPolicyEnforcementOrder: "string",
project: "string",
routingMode: "string",
});
type: gcp:compute:Network
properties:
autoCreateSubnetworks: false
bgpAlwaysCompareMed: false
bgpBestPathSelectionMode: string
bgpInterRegionCost: string
deleteDefaultRoutesOnCreate: false
description: string
enableUlaInternalIpv6: false
internalIpv6Range: string
mtu: 0
name: string
networkFirewallPolicyEnforcementOrder: string
project: string
routingMode: string
Network 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 Network resource accepts the following input properties:
- Auto
Create boolSubnetworks - When set to
true
, the network is created in "auto subnet mode" and it will create a subnet for each region automatically across the10.128.0.0/9
address range. When set tofalse
, the network is created in "custom subnet mode" so the user can explicitly connect subnetwork resources. - Bgp
Always boolCompare Med - Enables/disables the comparison of MED across routes with different Neighbor ASNs. This value can only be set if the --bgp-best-path-selection-mode is STANDARD
- Bgp
Best stringPath Selection Mode - The BGP best selection algorithm to be employed. MODE can be LEGACY or STANDARD.
Possible values are:
LEGACY
,STANDARD
. - Bgp
Inter stringRegion Cost - Choice of the behavior of inter-regional cost and MED in the BPS algorithm.
Possible values are:
DEFAULT
,ADD_COST_TO_MED
. - Delete
Default boolRoutes On Create - If set to
true
, default routes (0.0.0.0/0
) will be deleted immediately after network creation. Defaults tofalse
. - Description string
- An optional description of this resource. The resource must be recreated to modify this field.
- Enable
Ula boolInternal Ipv6 - Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20.
- Internal
Ipv6Range string - When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field.
- Mtu int
- Maximum Transmission Unit in bytes. The default value is 1460 bytes.
The minimum value for this field is 1300 and the maximum value is 8896 bytes (jumbo frames).
Note that packets larger than 1500 bytes (standard Ethernet) can be subject to TCP-MSS clamping or dropped
with an ICMP
Fragmentation-Needed
message if the packets are routed to the Internet or other VPCs with varying MTUs. - Name string
- Name of the resource. Provided by the client when the resource is
created. The name must be 1-63 characters long, and comply with
RFC1035. Specifically, the name must be 1-63 characters long and match
the regular expression
a-z?
which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - Network
Firewall stringPolicy Enforcement Order - Set the order that Firewall Rules and Firewall Policies are evaluated.
Default value is
AFTER_CLASSIC_FIREWALL
. Possible values are:BEFORE_CLASSIC_FIREWALL
,AFTER_CLASSIC_FIREWALL
. - Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Routing
Mode string - The network-wide routing mode to use. If set to
REGIONAL
, this network's cloud routers will only advertise routes with subnetworks of this network in the same region as the router. If set toGLOBAL
, this network's cloud routers will advertise routes with all subnetworks of this network, across regions. Possible values are:REGIONAL
,GLOBAL
.
- Auto
Create boolSubnetworks - When set to
true
, the network is created in "auto subnet mode" and it will create a subnet for each region automatically across the10.128.0.0/9
address range. When set tofalse
, the network is created in "custom subnet mode" so the user can explicitly connect subnetwork resources. - Bgp
Always boolCompare Med - Enables/disables the comparison of MED across routes with different Neighbor ASNs. This value can only be set if the --bgp-best-path-selection-mode is STANDARD
- Bgp
Best stringPath Selection Mode - The BGP best selection algorithm to be employed. MODE can be LEGACY or STANDARD.
Possible values are:
LEGACY
,STANDARD
. - Bgp
Inter stringRegion Cost - Choice of the behavior of inter-regional cost and MED in the BPS algorithm.
Possible values are:
DEFAULT
,ADD_COST_TO_MED
. - Delete
Default boolRoutes On Create - If set to
true
, default routes (0.0.0.0/0
) will be deleted immediately after network creation. Defaults tofalse
. - Description string
- An optional description of this resource. The resource must be recreated to modify this field.
- Enable
Ula boolInternal Ipv6 - Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20.
- Internal
Ipv6Range string - When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field.
- Mtu int
- Maximum Transmission Unit in bytes. The default value is 1460 bytes.
The minimum value for this field is 1300 and the maximum value is 8896 bytes (jumbo frames).
Note that packets larger than 1500 bytes (standard Ethernet) can be subject to TCP-MSS clamping or dropped
with an ICMP
Fragmentation-Needed
message if the packets are routed to the Internet or other VPCs with varying MTUs. - Name string
- Name of the resource. Provided by the client when the resource is
created. The name must be 1-63 characters long, and comply with
RFC1035. Specifically, the name must be 1-63 characters long and match
the regular expression
a-z?
which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - Network
Firewall stringPolicy Enforcement Order - Set the order that Firewall Rules and Firewall Policies are evaluated.
Default value is
AFTER_CLASSIC_FIREWALL
. Possible values are:BEFORE_CLASSIC_FIREWALL
,AFTER_CLASSIC_FIREWALL
. - Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Routing
Mode string - The network-wide routing mode to use. If set to
REGIONAL
, this network's cloud routers will only advertise routes with subnetworks of this network in the same region as the router. If set toGLOBAL
, this network's cloud routers will advertise routes with all subnetworks of this network, across regions. Possible values are:REGIONAL
,GLOBAL
.
- auto
Create BooleanSubnetworks - When set to
true
, the network is created in "auto subnet mode" and it will create a subnet for each region automatically across the10.128.0.0/9
address range. When set tofalse
, the network is created in "custom subnet mode" so the user can explicitly connect subnetwork resources. - bgp
Always BooleanCompare Med - Enables/disables the comparison of MED across routes with different Neighbor ASNs. This value can only be set if the --bgp-best-path-selection-mode is STANDARD
- bgp
Best StringPath Selection Mode - The BGP best selection algorithm to be employed. MODE can be LEGACY or STANDARD.
Possible values are:
LEGACY
,STANDARD
. - bgp
Inter StringRegion Cost - Choice of the behavior of inter-regional cost and MED in the BPS algorithm.
Possible values are:
DEFAULT
,ADD_COST_TO_MED
. - delete
Default BooleanRoutes On Create - If set to
true
, default routes (0.0.0.0/0
) will be deleted immediately after network creation. Defaults tofalse
. - description String
- An optional description of this resource. The resource must be recreated to modify this field.
- enable
Ula BooleanInternal Ipv6 - Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20.
- internal
Ipv6Range String - When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field.
- mtu Integer
- Maximum Transmission Unit in bytes. The default value is 1460 bytes.
The minimum value for this field is 1300 and the maximum value is 8896 bytes (jumbo frames).
Note that packets larger than 1500 bytes (standard Ethernet) can be subject to TCP-MSS clamping or dropped
with an ICMP
Fragmentation-Needed
message if the packets are routed to the Internet or other VPCs with varying MTUs. - name String
- Name of the resource. Provided by the client when the resource is
created. The name must be 1-63 characters long, and comply with
RFC1035. Specifically, the name must be 1-63 characters long and match
the regular expression
a-z?
which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - network
Firewall StringPolicy Enforcement Order - Set the order that Firewall Rules and Firewall Policies are evaluated.
Default value is
AFTER_CLASSIC_FIREWALL
. Possible values are:BEFORE_CLASSIC_FIREWALL
,AFTER_CLASSIC_FIREWALL
. - project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- routing
Mode String - The network-wide routing mode to use. If set to
REGIONAL
, this network's cloud routers will only advertise routes with subnetworks of this network in the same region as the router. If set toGLOBAL
, this network's cloud routers will advertise routes with all subnetworks of this network, across regions. Possible values are:REGIONAL
,GLOBAL
.
- auto
Create booleanSubnetworks - When set to
true
, the network is created in "auto subnet mode" and it will create a subnet for each region automatically across the10.128.0.0/9
address range. When set tofalse
, the network is created in "custom subnet mode" so the user can explicitly connect subnetwork resources. - bgp
Always booleanCompare Med - Enables/disables the comparison of MED across routes with different Neighbor ASNs. This value can only be set if the --bgp-best-path-selection-mode is STANDARD
- bgp
Best stringPath Selection Mode - The BGP best selection algorithm to be employed. MODE can be LEGACY or STANDARD.
Possible values are:
LEGACY
,STANDARD
. - bgp
Inter stringRegion Cost - Choice of the behavior of inter-regional cost and MED in the BPS algorithm.
Possible values are:
DEFAULT
,ADD_COST_TO_MED
. - delete
Default booleanRoutes On Create - If set to
true
, default routes (0.0.0.0/0
) will be deleted immediately after network creation. Defaults tofalse
. - description string
- An optional description of this resource. The resource must be recreated to modify this field.
- enable
Ula booleanInternal Ipv6 - Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20.
- internal
Ipv6Range string - When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field.
- mtu number
- Maximum Transmission Unit in bytes. The default value is 1460 bytes.
The minimum value for this field is 1300 and the maximum value is 8896 bytes (jumbo frames).
Note that packets larger than 1500 bytes (standard Ethernet) can be subject to TCP-MSS clamping or dropped
with an ICMP
Fragmentation-Needed
message if the packets are routed to the Internet or other VPCs with varying MTUs. - name string
- Name of the resource. Provided by the client when the resource is
created. The name must be 1-63 characters long, and comply with
RFC1035. Specifically, the name must be 1-63 characters long and match
the regular expression
a-z?
which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - network
Firewall stringPolicy Enforcement Order - Set the order that Firewall Rules and Firewall Policies are evaluated.
Default value is
AFTER_CLASSIC_FIREWALL
. Possible values are:BEFORE_CLASSIC_FIREWALL
,AFTER_CLASSIC_FIREWALL
. - project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- routing
Mode string - The network-wide routing mode to use. If set to
REGIONAL
, this network's cloud routers will only advertise routes with subnetworks of this network in the same region as the router. If set toGLOBAL
, this network's cloud routers will advertise routes with all subnetworks of this network, across regions. Possible values are:REGIONAL
,GLOBAL
.
- auto_
create_ boolsubnetworks - When set to
true
, the network is created in "auto subnet mode" and it will create a subnet for each region automatically across the10.128.0.0/9
address range. When set tofalse
, the network is created in "custom subnet mode" so the user can explicitly connect subnetwork resources. - bgp_
always_ boolcompare_ med - Enables/disables the comparison of MED across routes with different Neighbor ASNs. This value can only be set if the --bgp-best-path-selection-mode is STANDARD
- bgp_
best_ strpath_ selection_ mode - The BGP best selection algorithm to be employed. MODE can be LEGACY or STANDARD.
Possible values are:
LEGACY
,STANDARD
. - bgp_
inter_ strregion_ cost - Choice of the behavior of inter-regional cost and MED in the BPS algorithm.
Possible values are:
DEFAULT
,ADD_COST_TO_MED
. - delete_
default_ boolroutes_ on_ create - If set to
true
, default routes (0.0.0.0/0
) will be deleted immediately after network creation. Defaults tofalse
. - description str
- An optional description of this resource. The resource must be recreated to modify this field.
- enable_
ula_ boolinternal_ ipv6 - Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20.
- internal_
ipv6_ strrange - When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field.
- mtu int
- Maximum Transmission Unit in bytes. The default value is 1460 bytes.
The minimum value for this field is 1300 and the maximum value is 8896 bytes (jumbo frames).
Note that packets larger than 1500 bytes (standard Ethernet) can be subject to TCP-MSS clamping or dropped
with an ICMP
Fragmentation-Needed
message if the packets are routed to the Internet or other VPCs with varying MTUs. - name str
- Name of the resource. Provided by the client when the resource is
created. The name must be 1-63 characters long, and comply with
RFC1035. Specifically, the name must be 1-63 characters long and match
the regular expression
a-z?
which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - network_
firewall_ strpolicy_ enforcement_ order - Set the order that Firewall Rules and Firewall Policies are evaluated.
Default value is
AFTER_CLASSIC_FIREWALL
. Possible values are:BEFORE_CLASSIC_FIREWALL
,AFTER_CLASSIC_FIREWALL
. - project str
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- routing_
mode str - The network-wide routing mode to use. If set to
REGIONAL
, this network's cloud routers will only advertise routes with subnetworks of this network in the same region as the router. If set toGLOBAL
, this network's cloud routers will advertise routes with all subnetworks of this network, across regions. Possible values are:REGIONAL
,GLOBAL
.
- auto
Create BooleanSubnetworks - When set to
true
, the network is created in "auto subnet mode" and it will create a subnet for each region automatically across the10.128.0.0/9
address range. When set tofalse
, the network is created in "custom subnet mode" so the user can explicitly connect subnetwork resources. - bgp
Always BooleanCompare Med - Enables/disables the comparison of MED across routes with different Neighbor ASNs. This value can only be set if the --bgp-best-path-selection-mode is STANDARD
- bgp
Best StringPath Selection Mode - The BGP best selection algorithm to be employed. MODE can be LEGACY or STANDARD.
Possible values are:
LEGACY
,STANDARD
. - bgp
Inter StringRegion Cost - Choice of the behavior of inter-regional cost and MED in the BPS algorithm.
Possible values are:
DEFAULT
,ADD_COST_TO_MED
. - delete
Default BooleanRoutes On Create - If set to
true
, default routes (0.0.0.0/0
) will be deleted immediately after network creation. Defaults tofalse
. - description String
- An optional description of this resource. The resource must be recreated to modify this field.
- enable
Ula BooleanInternal Ipv6 - Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20.
- internal
Ipv6Range String - When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field.
- mtu Number
- Maximum Transmission Unit in bytes. The default value is 1460 bytes.
The minimum value for this field is 1300 and the maximum value is 8896 bytes (jumbo frames).
Note that packets larger than 1500 bytes (standard Ethernet) can be subject to TCP-MSS clamping or dropped
with an ICMP
Fragmentation-Needed
message if the packets are routed to the Internet or other VPCs with varying MTUs. - name String
- Name of the resource. Provided by the client when the resource is
created. The name must be 1-63 characters long, and comply with
RFC1035. Specifically, the name must be 1-63 characters long and match
the regular expression
a-z?
which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - network
Firewall StringPolicy Enforcement Order - Set the order that Firewall Rules and Firewall Policies are evaluated.
Default value is
AFTER_CLASSIC_FIREWALL
. Possible values are:BEFORE_CLASSIC_FIREWALL
,AFTER_CLASSIC_FIREWALL
. - project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- routing
Mode String - The network-wide routing mode to use. If set to
REGIONAL
, this network's cloud routers will only advertise routes with subnetworks of this network in the same region as the router. If set toGLOBAL
, this network's cloud routers will advertise routes with all subnetworks of this network, across regions. Possible values are:REGIONAL
,GLOBAL
.
Outputs
All input properties are implicitly available as output properties. Additionally, the Network resource produces the following output properties:
- Gateway
Ipv4 string - The gateway address for default routing out of the network. This value is selected by GCP.
- Id string
- The provider-assigned unique ID for this managed resource.
- Numeric
Id string - The unique identifier for the resource. This identifier is defined by the server.
- Self
Link string - The URI of the created resource.
- Gateway
Ipv4 string - The gateway address for default routing out of the network. This value is selected by GCP.
- Id string
- The provider-assigned unique ID for this managed resource.
- Numeric
Id string - The unique identifier for the resource. This identifier is defined by the server.
- Self
Link string - The URI of the created resource.
- gateway
Ipv4 String - The gateway address for default routing out of the network. This value is selected by GCP.
- id String
- The provider-assigned unique ID for this managed resource.
- numeric
Id String - The unique identifier for the resource. This identifier is defined by the server.
- self
Link String - The URI of the created resource.
- gateway
Ipv4 string - The gateway address for default routing out of the network. This value is selected by GCP.
- id string
- The provider-assigned unique ID for this managed resource.
- numeric
Id string - The unique identifier for the resource. This identifier is defined by the server.
- self
Link string - The URI of the created resource.
- gateway_
ipv4 str - The gateway address for default routing out of the network. This value is selected by GCP.
- id str
- The provider-assigned unique ID for this managed resource.
- numeric_
id str - The unique identifier for the resource. This identifier is defined by the server.
- self_
link str - The URI of the created resource.
- gateway
Ipv4 String - The gateway address for default routing out of the network. This value is selected by GCP.
- id String
- The provider-assigned unique ID for this managed resource.
- numeric
Id String - The unique identifier for the resource. This identifier is defined by the server.
- self
Link String - The URI of the created resource.
Look up Existing Network Resource
Get an existing Network 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?: NetworkState, opts?: CustomResourceOptions): Network
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
auto_create_subnetworks: Optional[bool] = None,
bgp_always_compare_med: Optional[bool] = None,
bgp_best_path_selection_mode: Optional[str] = None,
bgp_inter_region_cost: Optional[str] = None,
delete_default_routes_on_create: Optional[bool] = None,
description: Optional[str] = None,
enable_ula_internal_ipv6: Optional[bool] = None,
gateway_ipv4: Optional[str] = None,
internal_ipv6_range: Optional[str] = None,
mtu: Optional[int] = None,
name: Optional[str] = None,
network_firewall_policy_enforcement_order: Optional[str] = None,
numeric_id: Optional[str] = None,
project: Optional[str] = None,
routing_mode: Optional[str] = None,
self_link: Optional[str] = None) -> Network
func GetNetwork(ctx *Context, name string, id IDInput, state *NetworkState, opts ...ResourceOption) (*Network, error)
public static Network Get(string name, Input<string> id, NetworkState? state, CustomResourceOptions? opts = null)
public static Network get(String name, Output<String> id, NetworkState 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.
- Auto
Create boolSubnetworks - When set to
true
, the network is created in "auto subnet mode" and it will create a subnet for each region automatically across the10.128.0.0/9
address range. When set tofalse
, the network is created in "custom subnet mode" so the user can explicitly connect subnetwork resources. - Bgp
Always boolCompare Med - Enables/disables the comparison of MED across routes with different Neighbor ASNs. This value can only be set if the --bgp-best-path-selection-mode is STANDARD
- Bgp
Best stringPath Selection Mode - The BGP best selection algorithm to be employed. MODE can be LEGACY or STANDARD.
Possible values are:
LEGACY
,STANDARD
. - Bgp
Inter stringRegion Cost - Choice of the behavior of inter-regional cost and MED in the BPS algorithm.
Possible values are:
DEFAULT
,ADD_COST_TO_MED
. - Delete
Default boolRoutes On Create - If set to
true
, default routes (0.0.0.0/0
) will be deleted immediately after network creation. Defaults tofalse
. - Description string
- An optional description of this resource. The resource must be recreated to modify this field.
- Enable
Ula boolInternal Ipv6 - Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20.
- Gateway
Ipv4 string - The gateway address for default routing out of the network. This value is selected by GCP.
- Internal
Ipv6Range string - When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field.
- Mtu int
- Maximum Transmission Unit in bytes. The default value is 1460 bytes.
The minimum value for this field is 1300 and the maximum value is 8896 bytes (jumbo frames).
Note that packets larger than 1500 bytes (standard Ethernet) can be subject to TCP-MSS clamping or dropped
with an ICMP
Fragmentation-Needed
message if the packets are routed to the Internet or other VPCs with varying MTUs. - Name string
- Name of the resource. Provided by the client when the resource is
created. The name must be 1-63 characters long, and comply with
RFC1035. Specifically, the name must be 1-63 characters long and match
the regular expression
a-z?
which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - Network
Firewall stringPolicy Enforcement Order - Set the order that Firewall Rules and Firewall Policies are evaluated.
Default value is
AFTER_CLASSIC_FIREWALL
. Possible values are:BEFORE_CLASSIC_FIREWALL
,AFTER_CLASSIC_FIREWALL
. - Numeric
Id string - The unique identifier for the resource. This identifier is defined by the server.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Routing
Mode string - The network-wide routing mode to use. If set to
REGIONAL
, this network's cloud routers will only advertise routes with subnetworks of this network in the same region as the router. If set toGLOBAL
, this network's cloud routers will advertise routes with all subnetworks of this network, across regions. Possible values are:REGIONAL
,GLOBAL
. - Self
Link string - The URI of the created resource.
- Auto
Create boolSubnetworks - When set to
true
, the network is created in "auto subnet mode" and it will create a subnet for each region automatically across the10.128.0.0/9
address range. When set tofalse
, the network is created in "custom subnet mode" so the user can explicitly connect subnetwork resources. - Bgp
Always boolCompare Med - Enables/disables the comparison of MED across routes with different Neighbor ASNs. This value can only be set if the --bgp-best-path-selection-mode is STANDARD
- Bgp
Best stringPath Selection Mode - The BGP best selection algorithm to be employed. MODE can be LEGACY or STANDARD.
Possible values are:
LEGACY
,STANDARD
. - Bgp
Inter stringRegion Cost - Choice of the behavior of inter-regional cost and MED in the BPS algorithm.
Possible values are:
DEFAULT
,ADD_COST_TO_MED
. - Delete
Default boolRoutes On Create - If set to
true
, default routes (0.0.0.0/0
) will be deleted immediately after network creation. Defaults tofalse
. - Description string
- An optional description of this resource. The resource must be recreated to modify this field.
- Enable
Ula boolInternal Ipv6 - Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20.
- Gateway
Ipv4 string - The gateway address for default routing out of the network. This value is selected by GCP.
- Internal
Ipv6Range string - When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field.
- Mtu int
- Maximum Transmission Unit in bytes. The default value is 1460 bytes.
The minimum value for this field is 1300 and the maximum value is 8896 bytes (jumbo frames).
Note that packets larger than 1500 bytes (standard Ethernet) can be subject to TCP-MSS clamping or dropped
with an ICMP
Fragmentation-Needed
message if the packets are routed to the Internet or other VPCs with varying MTUs. - Name string
- Name of the resource. Provided by the client when the resource is
created. The name must be 1-63 characters long, and comply with
RFC1035. Specifically, the name must be 1-63 characters long and match
the regular expression
a-z?
which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - Network
Firewall stringPolicy Enforcement Order - Set the order that Firewall Rules and Firewall Policies are evaluated.
Default value is
AFTER_CLASSIC_FIREWALL
. Possible values are:BEFORE_CLASSIC_FIREWALL
,AFTER_CLASSIC_FIREWALL
. - Numeric
Id string - The unique identifier for the resource. This identifier is defined by the server.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Routing
Mode string - The network-wide routing mode to use. If set to
REGIONAL
, this network's cloud routers will only advertise routes with subnetworks of this network in the same region as the router. If set toGLOBAL
, this network's cloud routers will advertise routes with all subnetworks of this network, across regions. Possible values are:REGIONAL
,GLOBAL
. - Self
Link string - The URI of the created resource.
- auto
Create BooleanSubnetworks - When set to
true
, the network is created in "auto subnet mode" and it will create a subnet for each region automatically across the10.128.0.0/9
address range. When set tofalse
, the network is created in "custom subnet mode" so the user can explicitly connect subnetwork resources. - bgp
Always BooleanCompare Med - Enables/disables the comparison of MED across routes with different Neighbor ASNs. This value can only be set if the --bgp-best-path-selection-mode is STANDARD
- bgp
Best StringPath Selection Mode - The BGP best selection algorithm to be employed. MODE can be LEGACY or STANDARD.
Possible values are:
LEGACY
,STANDARD
. - bgp
Inter StringRegion Cost - Choice of the behavior of inter-regional cost and MED in the BPS algorithm.
Possible values are:
DEFAULT
,ADD_COST_TO_MED
. - delete
Default BooleanRoutes On Create - If set to
true
, default routes (0.0.0.0/0
) will be deleted immediately after network creation. Defaults tofalse
. - description String
- An optional description of this resource. The resource must be recreated to modify this field.
- enable
Ula BooleanInternal Ipv6 - Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20.
- gateway
Ipv4 String - The gateway address for default routing out of the network. This value is selected by GCP.
- internal
Ipv6Range String - When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field.
- mtu Integer
- Maximum Transmission Unit in bytes. The default value is 1460 bytes.
The minimum value for this field is 1300 and the maximum value is 8896 bytes (jumbo frames).
Note that packets larger than 1500 bytes (standard Ethernet) can be subject to TCP-MSS clamping or dropped
with an ICMP
Fragmentation-Needed
message if the packets are routed to the Internet or other VPCs with varying MTUs. - name String
- Name of the resource. Provided by the client when the resource is
created. The name must be 1-63 characters long, and comply with
RFC1035. Specifically, the name must be 1-63 characters long and match
the regular expression
a-z?
which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - network
Firewall StringPolicy Enforcement Order - Set the order that Firewall Rules and Firewall Policies are evaluated.
Default value is
AFTER_CLASSIC_FIREWALL
. Possible values are:BEFORE_CLASSIC_FIREWALL
,AFTER_CLASSIC_FIREWALL
. - numeric
Id String - The unique identifier for the resource. This identifier is defined by the server.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- routing
Mode String - The network-wide routing mode to use. If set to
REGIONAL
, this network's cloud routers will only advertise routes with subnetworks of this network in the same region as the router. If set toGLOBAL
, this network's cloud routers will advertise routes with all subnetworks of this network, across regions. Possible values are:REGIONAL
,GLOBAL
. - self
Link String - The URI of the created resource.
- auto
Create booleanSubnetworks - When set to
true
, the network is created in "auto subnet mode" and it will create a subnet for each region automatically across the10.128.0.0/9
address range. When set tofalse
, the network is created in "custom subnet mode" so the user can explicitly connect subnetwork resources. - bgp
Always booleanCompare Med - Enables/disables the comparison of MED across routes with different Neighbor ASNs. This value can only be set if the --bgp-best-path-selection-mode is STANDARD
- bgp
Best stringPath Selection Mode - The BGP best selection algorithm to be employed. MODE can be LEGACY or STANDARD.
Possible values are:
LEGACY
,STANDARD
. - bgp
Inter stringRegion Cost - Choice of the behavior of inter-regional cost and MED in the BPS algorithm.
Possible values are:
DEFAULT
,ADD_COST_TO_MED
. - delete
Default booleanRoutes On Create - If set to
true
, default routes (0.0.0.0/0
) will be deleted immediately after network creation. Defaults tofalse
. - description string
- An optional description of this resource. The resource must be recreated to modify this field.
- enable
Ula booleanInternal Ipv6 - Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20.
- gateway
Ipv4 string - The gateway address for default routing out of the network. This value is selected by GCP.
- internal
Ipv6Range string - When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field.
- mtu number
- Maximum Transmission Unit in bytes. The default value is 1460 bytes.
The minimum value for this field is 1300 and the maximum value is 8896 bytes (jumbo frames).
Note that packets larger than 1500 bytes (standard Ethernet) can be subject to TCP-MSS clamping or dropped
with an ICMP
Fragmentation-Needed
message if the packets are routed to the Internet or other VPCs with varying MTUs. - name string
- Name of the resource. Provided by the client when the resource is
created. The name must be 1-63 characters long, and comply with
RFC1035. Specifically, the name must be 1-63 characters long and match
the regular expression
a-z?
which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - network
Firewall stringPolicy Enforcement Order - Set the order that Firewall Rules and Firewall Policies are evaluated.
Default value is
AFTER_CLASSIC_FIREWALL
. Possible values are:BEFORE_CLASSIC_FIREWALL
,AFTER_CLASSIC_FIREWALL
. - numeric
Id string - The unique identifier for the resource. This identifier is defined by the server.
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- routing
Mode string - The network-wide routing mode to use. If set to
REGIONAL
, this network's cloud routers will only advertise routes with subnetworks of this network in the same region as the router. If set toGLOBAL
, this network's cloud routers will advertise routes with all subnetworks of this network, across regions. Possible values are:REGIONAL
,GLOBAL
. - self
Link string - The URI of the created resource.
- auto_
create_ boolsubnetworks - When set to
true
, the network is created in "auto subnet mode" and it will create a subnet for each region automatically across the10.128.0.0/9
address range. When set tofalse
, the network is created in "custom subnet mode" so the user can explicitly connect subnetwork resources. - bgp_
always_ boolcompare_ med - Enables/disables the comparison of MED across routes with different Neighbor ASNs. This value can only be set if the --bgp-best-path-selection-mode is STANDARD
- bgp_
best_ strpath_ selection_ mode - The BGP best selection algorithm to be employed. MODE can be LEGACY or STANDARD.
Possible values are:
LEGACY
,STANDARD
. - bgp_
inter_ strregion_ cost - Choice of the behavior of inter-regional cost and MED in the BPS algorithm.
Possible values are:
DEFAULT
,ADD_COST_TO_MED
. - delete_
default_ boolroutes_ on_ create - If set to
true
, default routes (0.0.0.0/0
) will be deleted immediately after network creation. Defaults tofalse
. - description str
- An optional description of this resource. The resource must be recreated to modify this field.
- enable_
ula_ boolinternal_ ipv6 - Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20.
- gateway_
ipv4 str - The gateway address for default routing out of the network. This value is selected by GCP.
- internal_
ipv6_ strrange - When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field.
- mtu int
- Maximum Transmission Unit in bytes. The default value is 1460 bytes.
The minimum value for this field is 1300 and the maximum value is 8896 bytes (jumbo frames).
Note that packets larger than 1500 bytes (standard Ethernet) can be subject to TCP-MSS clamping or dropped
with an ICMP
Fragmentation-Needed
message if the packets are routed to the Internet or other VPCs with varying MTUs. - name str
- Name of the resource. Provided by the client when the resource is
created. The name must be 1-63 characters long, and comply with
RFC1035. Specifically, the name must be 1-63 characters long and match
the regular expression
a-z?
which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - network_
firewall_ strpolicy_ enforcement_ order - Set the order that Firewall Rules and Firewall Policies are evaluated.
Default value is
AFTER_CLASSIC_FIREWALL
. Possible values are:BEFORE_CLASSIC_FIREWALL
,AFTER_CLASSIC_FIREWALL
. - numeric_
id str - The unique identifier for the resource. This identifier is defined by the server.
- project str
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- routing_
mode str - The network-wide routing mode to use. If set to
REGIONAL
, this network's cloud routers will only advertise routes with subnetworks of this network in the same region as the router. If set toGLOBAL
, this network's cloud routers will advertise routes with all subnetworks of this network, across regions. Possible values are:REGIONAL
,GLOBAL
. - self_
link str - The URI of the created resource.
- auto
Create BooleanSubnetworks - When set to
true
, the network is created in "auto subnet mode" and it will create a subnet for each region automatically across the10.128.0.0/9
address range. When set tofalse
, the network is created in "custom subnet mode" so the user can explicitly connect subnetwork resources. - bgp
Always BooleanCompare Med - Enables/disables the comparison of MED across routes with different Neighbor ASNs. This value can only be set if the --bgp-best-path-selection-mode is STANDARD
- bgp
Best StringPath Selection Mode - The BGP best selection algorithm to be employed. MODE can be LEGACY or STANDARD.
Possible values are:
LEGACY
,STANDARD
. - bgp
Inter StringRegion Cost - Choice of the behavior of inter-regional cost and MED in the BPS algorithm.
Possible values are:
DEFAULT
,ADD_COST_TO_MED
. - delete
Default BooleanRoutes On Create - If set to
true
, default routes (0.0.0.0/0
) will be deleted immediately after network creation. Defaults tofalse
. - description String
- An optional description of this resource. The resource must be recreated to modify this field.
- enable
Ula BooleanInternal Ipv6 - Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20.
- gateway
Ipv4 String - The gateway address for default routing out of the network. This value is selected by GCP.
- internal
Ipv6Range String - When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field.
- mtu Number
- Maximum Transmission Unit in bytes. The default value is 1460 bytes.
The minimum value for this field is 1300 and the maximum value is 8896 bytes (jumbo frames).
Note that packets larger than 1500 bytes (standard Ethernet) can be subject to TCP-MSS clamping or dropped
with an ICMP
Fragmentation-Needed
message if the packets are routed to the Internet or other VPCs with varying MTUs. - name String
- Name of the resource. Provided by the client when the resource is
created. The name must be 1-63 characters long, and comply with
RFC1035. Specifically, the name must be 1-63 characters long and match
the regular expression
a-z?
which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. - network
Firewall StringPolicy Enforcement Order - Set the order that Firewall Rules and Firewall Policies are evaluated.
Default value is
AFTER_CLASSIC_FIREWALL
. Possible values are:BEFORE_CLASSIC_FIREWALL
,AFTER_CLASSIC_FIREWALL
. - numeric
Id String - The unique identifier for the resource. This identifier is defined by the server.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- routing
Mode String - The network-wide routing mode to use. If set to
REGIONAL
, this network's cloud routers will only advertise routes with subnetworks of this network in the same region as the router. If set toGLOBAL
, this network's cloud routers will advertise routes with all subnetworks of this network, across regions. Possible values are:REGIONAL
,GLOBAL
. - self
Link String - The URI of the created resource.
Import
Network can be imported using any of these accepted formats:
projects/{{project}}/global/networks/{{name}}
{{project}}/{{name}}
{{name}}
When using the pulumi import
command, Network can be imported using one of the formats above. For example:
$ pulumi import gcp:compute/network:Network default projects/{{project}}/global/networks/{{name}}
$ pulumi import gcp:compute/network:Network default {{project}}/{{name}}
$ pulumi import gcp:compute/network:Network default {{name}}
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Google Cloud (GCP) Classic pulumi/pulumi-gcp
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
google-beta
Terraform Provider.