gcp.compute.RouterPeer
Explore with Pulumi AI
BGP information that must be configured into the routing stack to establish BGP peering. This information must specify the peer ASN and either the interface name, IP address, or peer IP address. Please refer to RFC4273.
To get more information about RouterBgpPeer, see:
- API documentation
- How-to Guides
Example Usage
Router Peer Basic
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const peer = new gcp.compute.RouterPeer("peer", {
name: "my-router-peer",
router: "my-router",
region: "us-central1",
peerAsn: 65513,
advertisedRoutePriority: 100,
"interface": "interface-1",
});
import pulumi
import pulumi_gcp as gcp
peer = gcp.compute.RouterPeer("peer",
name="my-router-peer",
router="my-router",
region="us-central1",
peer_asn=65513,
advertised_route_priority=100,
interface="interface-1")
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/compute"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := compute.NewRouterPeer(ctx, "peer", &compute.RouterPeerArgs{
Name: pulumi.String("my-router-peer"),
Router: pulumi.String("my-router"),
Region: pulumi.String("us-central1"),
PeerAsn: pulumi.Int(65513),
AdvertisedRoutePriority: pulumi.Int(100),
Interface: pulumi.String("interface-1"),
})
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 peer = new Gcp.Compute.RouterPeer("peer", new()
{
Name = "my-router-peer",
Router = "my-router",
Region = "us-central1",
PeerAsn = 65513,
AdvertisedRoutePriority = 100,
Interface = "interface-1",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.RouterPeer;
import com.pulumi.gcp.compute.RouterPeerArgs;
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 peer = new RouterPeer("peer", RouterPeerArgs.builder()
.name("my-router-peer")
.router("my-router")
.region("us-central1")
.peerAsn(65513)
.advertisedRoutePriority(100)
.interface_("interface-1")
.build());
}
}
resources:
peer:
type: gcp:compute:RouterPeer
properties:
name: my-router-peer
router: my-router
region: us-central1
peerAsn: 65513
advertisedRoutePriority: 100
interface: interface-1
Router Peer Disabled
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const peer = new gcp.compute.RouterPeer("peer", {
name: "my-router-peer",
router: "my-router",
region: "us-central1",
peerIpAddress: "169.254.1.2",
peerAsn: 65513,
advertisedRoutePriority: 100,
"interface": "interface-1",
enable: false,
});
import pulumi
import pulumi_gcp as gcp
peer = gcp.compute.RouterPeer("peer",
name="my-router-peer",
router="my-router",
region="us-central1",
peer_ip_address="169.254.1.2",
peer_asn=65513,
advertised_route_priority=100,
interface="interface-1",
enable=False)
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/compute"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := compute.NewRouterPeer(ctx, "peer", &compute.RouterPeerArgs{
Name: pulumi.String("my-router-peer"),
Router: pulumi.String("my-router"),
Region: pulumi.String("us-central1"),
PeerIpAddress: pulumi.String("169.254.1.2"),
PeerAsn: pulumi.Int(65513),
AdvertisedRoutePriority: pulumi.Int(100),
Interface: pulumi.String("interface-1"),
Enable: pulumi.Bool(false),
})
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 peer = new Gcp.Compute.RouterPeer("peer", new()
{
Name = "my-router-peer",
Router = "my-router",
Region = "us-central1",
PeerIpAddress = "169.254.1.2",
PeerAsn = 65513,
AdvertisedRoutePriority = 100,
Interface = "interface-1",
Enable = false,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.RouterPeer;
import com.pulumi.gcp.compute.RouterPeerArgs;
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 peer = new RouterPeer("peer", RouterPeerArgs.builder()
.name("my-router-peer")
.router("my-router")
.region("us-central1")
.peerIpAddress("169.254.1.2")
.peerAsn(65513)
.advertisedRoutePriority(100)
.interface_("interface-1")
.enable(false)
.build());
}
}
resources:
peer:
type: gcp:compute:RouterPeer
properties:
name: my-router-peer
router: my-router
region: us-central1
peerIpAddress: 169.254.1.2
peerAsn: 65513
advertisedRoutePriority: 100
interface: interface-1
enable: false
Router Peer Bfd
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const peer = new gcp.compute.RouterPeer("peer", {
name: "my-router-peer",
router: "my-router",
region: "us-central1",
peerIpAddress: "169.254.1.2",
peerAsn: 65513,
advertisedRoutePriority: 100,
"interface": "interface-1",
bfd: {
minReceiveInterval: 1000,
minTransmitInterval: 1000,
multiplier: 5,
sessionInitializationMode: "ACTIVE",
},
});
import pulumi
import pulumi_gcp as gcp
peer = gcp.compute.RouterPeer("peer",
name="my-router-peer",
router="my-router",
region="us-central1",
peer_ip_address="169.254.1.2",
peer_asn=65513,
advertised_route_priority=100,
interface="interface-1",
bfd=gcp.compute.RouterPeerBfdArgs(
min_receive_interval=1000,
min_transmit_interval=1000,
multiplier=5,
session_initialization_mode="ACTIVE",
))
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/compute"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := compute.NewRouterPeer(ctx, "peer", &compute.RouterPeerArgs{
Name: pulumi.String("my-router-peer"),
Router: pulumi.String("my-router"),
Region: pulumi.String("us-central1"),
PeerIpAddress: pulumi.String("169.254.1.2"),
PeerAsn: pulumi.Int(65513),
AdvertisedRoutePriority: pulumi.Int(100),
Interface: pulumi.String("interface-1"),
Bfd: &compute.RouterPeerBfdArgs{
MinReceiveInterval: pulumi.Int(1000),
MinTransmitInterval: pulumi.Int(1000),
Multiplier: pulumi.Int(5),
SessionInitializationMode: pulumi.String("ACTIVE"),
},
})
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 peer = new Gcp.Compute.RouterPeer("peer", new()
{
Name = "my-router-peer",
Router = "my-router",
Region = "us-central1",
PeerIpAddress = "169.254.1.2",
PeerAsn = 65513,
AdvertisedRoutePriority = 100,
Interface = "interface-1",
Bfd = new Gcp.Compute.Inputs.RouterPeerBfdArgs
{
MinReceiveInterval = 1000,
MinTransmitInterval = 1000,
Multiplier = 5,
SessionInitializationMode = "ACTIVE",
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.RouterPeer;
import com.pulumi.gcp.compute.RouterPeerArgs;
import com.pulumi.gcp.compute.inputs.RouterPeerBfdArgs;
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 peer = new RouterPeer("peer", RouterPeerArgs.builder()
.name("my-router-peer")
.router("my-router")
.region("us-central1")
.peerIpAddress("169.254.1.2")
.peerAsn(65513)
.advertisedRoutePriority(100)
.interface_("interface-1")
.bfd(RouterPeerBfdArgs.builder()
.minReceiveInterval(1000)
.minTransmitInterval(1000)
.multiplier(5)
.sessionInitializationMode("ACTIVE")
.build())
.build());
}
}
resources:
peer:
type: gcp:compute:RouterPeer
properties:
name: my-router-peer
router: my-router
region: us-central1
peerIpAddress: 169.254.1.2
peerAsn: 65513
advertisedRoutePriority: 100
interface: interface-1
bfd:
minReceiveInterval: 1000
minTransmitInterval: 1000
multiplier: 5
sessionInitializationMode: ACTIVE
Router Peer Router Appliance
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const network = new gcp.compute.Network("network", {
name: "my-router-net",
autoCreateSubnetworks: false,
});
const subnetwork = new gcp.compute.Subnetwork("subnetwork", {
name: "my-router-sub",
network: network.selfLink,
ipCidrRange: "10.0.0.0/16",
region: "us-central1",
});
const addrIntf = new gcp.compute.Address("addr_intf", {
name: "my-router-addr-intf",
region: subnetwork.region,
subnetwork: subnetwork.id,
addressType: "INTERNAL",
});
const addrIntfRedundant = new gcp.compute.Address("addr_intf_redundant", {
name: "my-router-addr-intf-red",
region: subnetwork.region,
subnetwork: subnetwork.id,
addressType: "INTERNAL",
});
const addrPeer = new gcp.compute.Address("addr_peer", {
name: "my-router-addr-peer",
region: subnetwork.region,
subnetwork: subnetwork.id,
addressType: "INTERNAL",
});
const instance = new gcp.compute.Instance("instance", {
name: "router-appliance",
zone: "us-central1-a",
machineType: "e2-medium",
canIpForward: true,
bootDisk: {
initializeParams: {
image: "debian-cloud/debian-11",
},
},
networkInterfaces: [{
networkIp: addrPeer.address,
subnetwork: subnetwork.selfLink,
}],
});
const hub = new gcp.networkconnectivity.Hub("hub", {name: "my-router-hub"});
const spoke = new gcp.networkconnectivity.Spoke("spoke", {
name: "my-router-spoke",
location: subnetwork.region,
hub: hub.id,
linkedRouterApplianceInstances: {
instances: [{
virtualMachine: instance.selfLink,
ipAddress: addrPeer.address,
}],
siteToSiteDataTransfer: false,
},
});
const router = new gcp.compute.Router("router", {
name: "my-router-router",
region: subnetwork.region,
network: network.selfLink,
bgp: {
asn: 64514,
},
});
const interfaceRedundant = new gcp.compute.RouterInterface("interface_redundant", {
name: "my-router-intf-red",
region: router.region,
router: router.name,
subnetwork: subnetwork.selfLink,
privateIpAddress: addrIntfRedundant.address,
});
const _interface = new gcp.compute.RouterInterface("interface", {
name: "my-router-intf",
region: router.region,
router: router.name,
subnetwork: subnetwork.selfLink,
privateIpAddress: addrIntf.address,
redundantInterface: interfaceRedundant.name,
});
const peer = new gcp.compute.RouterPeer("peer", {
name: "my-router-peer",
router: router.name,
region: router.region,
"interface": _interface.name,
routerApplianceInstance: instance.selfLink,
peerAsn: 65513,
peerIpAddress: addrPeer.address,
});
import pulumi
import pulumi_gcp as gcp
network = gcp.compute.Network("network",
name="my-router-net",
auto_create_subnetworks=False)
subnetwork = gcp.compute.Subnetwork("subnetwork",
name="my-router-sub",
network=network.self_link,
ip_cidr_range="10.0.0.0/16",
region="us-central1")
addr_intf = gcp.compute.Address("addr_intf",
name="my-router-addr-intf",
region=subnetwork.region,
subnetwork=subnetwork.id,
address_type="INTERNAL")
addr_intf_redundant = gcp.compute.Address("addr_intf_redundant",
name="my-router-addr-intf-red",
region=subnetwork.region,
subnetwork=subnetwork.id,
address_type="INTERNAL")
addr_peer = gcp.compute.Address("addr_peer",
name="my-router-addr-peer",
region=subnetwork.region,
subnetwork=subnetwork.id,
address_type="INTERNAL")
instance = gcp.compute.Instance("instance",
name="router-appliance",
zone="us-central1-a",
machine_type="e2-medium",
can_ip_forward=True,
boot_disk=gcp.compute.InstanceBootDiskArgs(
initialize_params=gcp.compute.InstanceBootDiskInitializeParamsArgs(
image="debian-cloud/debian-11",
),
),
network_interfaces=[gcp.compute.InstanceNetworkInterfaceArgs(
network_ip=addr_peer.address,
subnetwork=subnetwork.self_link,
)])
hub = gcp.networkconnectivity.Hub("hub", name="my-router-hub")
spoke = gcp.networkconnectivity.Spoke("spoke",
name="my-router-spoke",
location=subnetwork.region,
hub=hub.id,
linked_router_appliance_instances=gcp.networkconnectivity.SpokeLinkedRouterApplianceInstancesArgs(
instances=[gcp.networkconnectivity.SpokeLinkedRouterApplianceInstancesInstanceArgs(
virtual_machine=instance.self_link,
ip_address=addr_peer.address,
)],
site_to_site_data_transfer=False,
))
router = gcp.compute.Router("router",
name="my-router-router",
region=subnetwork.region,
network=network.self_link,
bgp=gcp.compute.RouterBgpArgs(
asn=64514,
))
interface_redundant = gcp.compute.RouterInterface("interface_redundant",
name="my-router-intf-red",
region=router.region,
router=router.name,
subnetwork=subnetwork.self_link,
private_ip_address=addr_intf_redundant.address)
interface = gcp.compute.RouterInterface("interface",
name="my-router-intf",
region=router.region,
router=router.name,
subnetwork=subnetwork.self_link,
private_ip_address=addr_intf.address,
redundant_interface=interface_redundant.name)
peer = gcp.compute.RouterPeer("peer",
name="my-router-peer",
router=router.name,
region=router.region,
interface=interface.name,
router_appliance_instance=instance.self_link,
peer_asn=65513,
peer_ip_address=addr_peer.address)
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/compute"
"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/networkconnectivity"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
network, err := compute.NewNetwork(ctx, "network", &compute.NetworkArgs{
Name: pulumi.String("my-router-net"),
AutoCreateSubnetworks: pulumi.Bool(false),
})
if err != nil {
return err
}
subnetwork, err := compute.NewSubnetwork(ctx, "subnetwork", &compute.SubnetworkArgs{
Name: pulumi.String("my-router-sub"),
Network: network.SelfLink,
IpCidrRange: pulumi.String("10.0.0.0/16"),
Region: pulumi.String("us-central1"),
})
if err != nil {
return err
}
addrIntf, err := compute.NewAddress(ctx, "addr_intf", &compute.AddressArgs{
Name: pulumi.String("my-router-addr-intf"),
Region: subnetwork.Region,
Subnetwork: subnetwork.ID(),
AddressType: pulumi.String("INTERNAL"),
})
if err != nil {
return err
}
addrIntfRedundant, err := compute.NewAddress(ctx, "addr_intf_redundant", &compute.AddressArgs{
Name: pulumi.String("my-router-addr-intf-red"),
Region: subnetwork.Region,
Subnetwork: subnetwork.ID(),
AddressType: pulumi.String("INTERNAL"),
})
if err != nil {
return err
}
addrPeer, err := compute.NewAddress(ctx, "addr_peer", &compute.AddressArgs{
Name: pulumi.String("my-router-addr-peer"),
Region: subnetwork.Region,
Subnetwork: subnetwork.ID(),
AddressType: pulumi.String("INTERNAL"),
})
if err != nil {
return err
}
instance, err := compute.NewInstance(ctx, "instance", &compute.InstanceArgs{
Name: pulumi.String("router-appliance"),
Zone: pulumi.String("us-central1-a"),
MachineType: pulumi.String("e2-medium"),
CanIpForward: pulumi.Bool(true),
BootDisk: &compute.InstanceBootDiskArgs{
InitializeParams: &compute.InstanceBootDiskInitializeParamsArgs{
Image: pulumi.String("debian-cloud/debian-11"),
},
},
NetworkInterfaces: compute.InstanceNetworkInterfaceArray{
&compute.InstanceNetworkInterfaceArgs{
NetworkIp: addrPeer.Address,
Subnetwork: subnetwork.SelfLink,
},
},
})
if err != nil {
return err
}
hub, err := networkconnectivity.NewHub(ctx, "hub", &networkconnectivity.HubArgs{
Name: pulumi.String("my-router-hub"),
})
if err != nil {
return err
}
_, err = networkconnectivity.NewSpoke(ctx, "spoke", &networkconnectivity.SpokeArgs{
Name: pulumi.String("my-router-spoke"),
Location: subnetwork.Region,
Hub: hub.ID(),
LinkedRouterApplianceInstances: &networkconnectivity.SpokeLinkedRouterApplianceInstancesArgs{
Instances: networkconnectivity.SpokeLinkedRouterApplianceInstancesInstanceArray{
&networkconnectivity.SpokeLinkedRouterApplianceInstancesInstanceArgs{
VirtualMachine: instance.SelfLink,
IpAddress: addrPeer.Address,
},
},
SiteToSiteDataTransfer: pulumi.Bool(false),
},
})
if err != nil {
return err
}
router, err := compute.NewRouter(ctx, "router", &compute.RouterArgs{
Name: pulumi.String("my-router-router"),
Region: subnetwork.Region,
Network: network.SelfLink,
Bgp: &compute.RouterBgpArgs{
Asn: pulumi.Int(64514),
},
})
if err != nil {
return err
}
interfaceRedundant, err := compute.NewRouterInterface(ctx, "interface_redundant", &compute.RouterInterfaceArgs{
Name: pulumi.String("my-router-intf-red"),
Region: router.Region,
Router: router.Name,
Subnetwork: subnetwork.SelfLink,
PrivateIpAddress: addrIntfRedundant.Address,
})
if err != nil {
return err
}
interface, err := compute.NewRouterInterface(ctx, "interface", &compute.RouterInterfaceArgs{
Name: pulumi.String("my-router-intf"),
Region: router.Region,
Router: router.Name,
Subnetwork: subnetwork.SelfLink,
PrivateIpAddress: addrIntf.Address,
RedundantInterface: interfaceRedundant.Name,
})
if err != nil {
return err
}
_, err = compute.NewRouterPeer(ctx, "peer", &compute.RouterPeerArgs{
Name: pulumi.String("my-router-peer"),
Router: router.Name,
Region: router.Region,
Interface: interface.Name,
RouterApplianceInstance: instance.SelfLink,
PeerAsn: pulumi.Int(65513),
PeerIpAddress: addrPeer.Address,
})
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 network = new Gcp.Compute.Network("network", new()
{
Name = "my-router-net",
AutoCreateSubnetworks = false,
});
var subnetwork = new Gcp.Compute.Subnetwork("subnetwork", new()
{
Name = "my-router-sub",
Network = network.SelfLink,
IpCidrRange = "10.0.0.0/16",
Region = "us-central1",
});
var addrIntf = new Gcp.Compute.Address("addr_intf", new()
{
Name = "my-router-addr-intf",
Region = subnetwork.Region,
Subnetwork = subnetwork.Id,
AddressType = "INTERNAL",
});
var addrIntfRedundant = new Gcp.Compute.Address("addr_intf_redundant", new()
{
Name = "my-router-addr-intf-red",
Region = subnetwork.Region,
Subnetwork = subnetwork.Id,
AddressType = "INTERNAL",
});
var addrPeer = new Gcp.Compute.Address("addr_peer", new()
{
Name = "my-router-addr-peer",
Region = subnetwork.Region,
Subnetwork = subnetwork.Id,
AddressType = "INTERNAL",
});
var instance = new Gcp.Compute.Instance("instance", new()
{
Name = "router-appliance",
Zone = "us-central1-a",
MachineType = "e2-medium",
CanIpForward = true,
BootDisk = new Gcp.Compute.Inputs.InstanceBootDiskArgs
{
InitializeParams = new Gcp.Compute.Inputs.InstanceBootDiskInitializeParamsArgs
{
Image = "debian-cloud/debian-11",
},
},
NetworkInterfaces = new[]
{
new Gcp.Compute.Inputs.InstanceNetworkInterfaceArgs
{
NetworkIp = addrPeer.IPAddress,
Subnetwork = subnetwork.SelfLink,
},
},
});
var hub = new Gcp.NetworkConnectivity.Hub("hub", new()
{
Name = "my-router-hub",
});
var spoke = new Gcp.NetworkConnectivity.Spoke("spoke", new()
{
Name = "my-router-spoke",
Location = subnetwork.Region,
Hub = hub.Id,
LinkedRouterApplianceInstances = new Gcp.NetworkConnectivity.Inputs.SpokeLinkedRouterApplianceInstancesArgs
{
Instances = new[]
{
new Gcp.NetworkConnectivity.Inputs.SpokeLinkedRouterApplianceInstancesInstanceArgs
{
VirtualMachine = instance.SelfLink,
IpAddress = addrPeer.IPAddress,
},
},
SiteToSiteDataTransfer = false,
},
});
var router = new Gcp.Compute.Router("router", new()
{
Name = "my-router-router",
Region = subnetwork.Region,
Network = network.SelfLink,
Bgp = new Gcp.Compute.Inputs.RouterBgpArgs
{
Asn = 64514,
},
});
var interfaceRedundant = new Gcp.Compute.RouterInterface("interface_redundant", new()
{
Name = "my-router-intf-red",
Region = router.Region,
Router = router.Name,
Subnetwork = subnetwork.SelfLink,
PrivateIpAddress = addrIntfRedundant.IPAddress,
});
var @interface = new Gcp.Compute.RouterInterface("interface", new()
{
Name = "my-router-intf",
Region = router.Region,
Router = router.Name,
Subnetwork = subnetwork.SelfLink,
PrivateIpAddress = addrIntf.IPAddress,
RedundantInterface = interfaceRedundant.Name,
});
var peer = new Gcp.Compute.RouterPeer("peer", new()
{
Name = "my-router-peer",
Router = router.Name,
Region = router.Region,
Interface = @interface.Name,
RouterApplianceInstance = instance.SelfLink,
PeerAsn = 65513,
PeerIpAddress = addrPeer.IPAddress,
});
});
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 com.pulumi.gcp.compute.Subnetwork;
import com.pulumi.gcp.compute.SubnetworkArgs;
import com.pulumi.gcp.compute.Address;
import com.pulumi.gcp.compute.AddressArgs;
import com.pulumi.gcp.compute.Instance;
import com.pulumi.gcp.compute.InstanceArgs;
import com.pulumi.gcp.compute.inputs.InstanceBootDiskArgs;
import com.pulumi.gcp.compute.inputs.InstanceBootDiskInitializeParamsArgs;
import com.pulumi.gcp.compute.inputs.InstanceNetworkInterfaceArgs;
import com.pulumi.gcp.networkconnectivity.Hub;
import com.pulumi.gcp.networkconnectivity.HubArgs;
import com.pulumi.gcp.networkconnectivity.Spoke;
import com.pulumi.gcp.networkconnectivity.SpokeArgs;
import com.pulumi.gcp.networkconnectivity.inputs.SpokeLinkedRouterApplianceInstancesArgs;
import com.pulumi.gcp.compute.Router;
import com.pulumi.gcp.compute.RouterArgs;
import com.pulumi.gcp.compute.inputs.RouterBgpArgs;
import com.pulumi.gcp.compute.RouterInterface;
import com.pulumi.gcp.compute.RouterInterfaceArgs;
import com.pulumi.gcp.compute.RouterPeer;
import com.pulumi.gcp.compute.RouterPeerArgs;
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 network = new Network("network", NetworkArgs.builder()
.name("my-router-net")
.autoCreateSubnetworks(false)
.build());
var subnetwork = new Subnetwork("subnetwork", SubnetworkArgs.builder()
.name("my-router-sub")
.network(network.selfLink())
.ipCidrRange("10.0.0.0/16")
.region("us-central1")
.build());
var addrIntf = new Address("addrIntf", AddressArgs.builder()
.name("my-router-addr-intf")
.region(subnetwork.region())
.subnetwork(subnetwork.id())
.addressType("INTERNAL")
.build());
var addrIntfRedundant = new Address("addrIntfRedundant", AddressArgs.builder()
.name("my-router-addr-intf-red")
.region(subnetwork.region())
.subnetwork(subnetwork.id())
.addressType("INTERNAL")
.build());
var addrPeer = new Address("addrPeer", AddressArgs.builder()
.name("my-router-addr-peer")
.region(subnetwork.region())
.subnetwork(subnetwork.id())
.addressType("INTERNAL")
.build());
var instance = new Instance("instance", InstanceArgs.builder()
.name("router-appliance")
.zone("us-central1-a")
.machineType("e2-medium")
.canIpForward(true)
.bootDisk(InstanceBootDiskArgs.builder()
.initializeParams(InstanceBootDiskInitializeParamsArgs.builder()
.image("debian-cloud/debian-11")
.build())
.build())
.networkInterfaces(InstanceNetworkInterfaceArgs.builder()
.networkIp(addrPeer.address())
.subnetwork(subnetwork.selfLink())
.build())
.build());
var hub = new Hub("hub", HubArgs.builder()
.name("my-router-hub")
.build());
var spoke = new Spoke("spoke", SpokeArgs.builder()
.name("my-router-spoke")
.location(subnetwork.region())
.hub(hub.id())
.linkedRouterApplianceInstances(SpokeLinkedRouterApplianceInstancesArgs.builder()
.instances(SpokeLinkedRouterApplianceInstancesInstanceArgs.builder()
.virtualMachine(instance.selfLink())
.ipAddress(addrPeer.address())
.build())
.siteToSiteDataTransfer(false)
.build())
.build());
var router = new Router("router", RouterArgs.builder()
.name("my-router-router")
.region(subnetwork.region())
.network(network.selfLink())
.bgp(RouterBgpArgs.builder()
.asn(64514)
.build())
.build());
var interfaceRedundant = new RouterInterface("interfaceRedundant", RouterInterfaceArgs.builder()
.name("my-router-intf-red")
.region(router.region())
.router(router.name())
.subnetwork(subnetwork.selfLink())
.privateIpAddress(addrIntfRedundant.address())
.build());
var interface_ = new RouterInterface("interface", RouterInterfaceArgs.builder()
.name("my-router-intf")
.region(router.region())
.router(router.name())
.subnetwork(subnetwork.selfLink())
.privateIpAddress(addrIntf.address())
.redundantInterface(interfaceRedundant.name())
.build());
var peer = new RouterPeer("peer", RouterPeerArgs.builder()
.name("my-router-peer")
.router(router.name())
.region(router.region())
.interface_(interface_.name())
.routerApplianceInstance(instance.selfLink())
.peerAsn(65513)
.peerIpAddress(addrPeer.address())
.build());
}
}
resources:
network:
type: gcp:compute:Network
properties:
name: my-router-net
autoCreateSubnetworks: false
subnetwork:
type: gcp:compute:Subnetwork
properties:
name: my-router-sub
network: ${network.selfLink}
ipCidrRange: 10.0.0.0/16
region: us-central1
addrIntf:
type: gcp:compute:Address
name: addr_intf
properties:
name: my-router-addr-intf
region: ${subnetwork.region}
subnetwork: ${subnetwork.id}
addressType: INTERNAL
addrIntfRedundant:
type: gcp:compute:Address
name: addr_intf_redundant
properties:
name: my-router-addr-intf-red
region: ${subnetwork.region}
subnetwork: ${subnetwork.id}
addressType: INTERNAL
addrPeer:
type: gcp:compute:Address
name: addr_peer
properties:
name: my-router-addr-peer
region: ${subnetwork.region}
subnetwork: ${subnetwork.id}
addressType: INTERNAL
instance:
type: gcp:compute:Instance
properties:
name: router-appliance
zone: us-central1-a
machineType: e2-medium
canIpForward: true
bootDisk:
initializeParams:
image: debian-cloud/debian-11
networkInterfaces:
- networkIp: ${addrPeer.address}
subnetwork: ${subnetwork.selfLink}
hub:
type: gcp:networkconnectivity:Hub
properties:
name: my-router-hub
spoke:
type: gcp:networkconnectivity:Spoke
properties:
name: my-router-spoke
location: ${subnetwork.region}
hub: ${hub.id}
linkedRouterApplianceInstances:
instances:
- virtualMachine: ${instance.selfLink}
ipAddress: ${addrPeer.address}
siteToSiteDataTransfer: false
router:
type: gcp:compute:Router
properties:
name: my-router-router
region: ${subnetwork.region}
network: ${network.selfLink}
bgp:
asn: 64514
interfaceRedundant:
type: gcp:compute:RouterInterface
name: interface_redundant
properties:
name: my-router-intf-red
region: ${router.region}
router: ${router.name}
subnetwork: ${subnetwork.selfLink}
privateIpAddress: ${addrIntfRedundant.address}
interface:
type: gcp:compute:RouterInterface
properties:
name: my-router-intf
region: ${router.region}
router: ${router.name}
subnetwork: ${subnetwork.selfLink}
privateIpAddress: ${addrIntf.address}
redundantInterface: ${interfaceRedundant.name}
peer:
type: gcp:compute:RouterPeer
properties:
name: my-router-peer
router: ${router.name}
region: ${router.region}
interface: ${interface.name}
routerApplianceInstance: ${instance.selfLink}
peerAsn: 65513
peerIpAddress: ${addrPeer.address}
Router Peer Md5 Authentication Key
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const foobar = new gcp.compute.RouterPeer("foobar", {
name: "%s-peer",
router: foobarGoogleComputeRouter.name,
region: foobarGoogleComputeRouter.region,
peerAsn: 65515,
advertisedRoutePriority: 100,
"interface": foobarGoogleComputeRouterInterface.name,
peerIpAddress: "169.254.3.2",
md5AuthenticationKey: {
name: "%s-peer-key",
key: "%s-peer-key-value",
},
});
import pulumi
import pulumi_gcp as gcp
foobar = gcp.compute.RouterPeer("foobar",
name="%s-peer",
router=foobar_google_compute_router["name"],
region=foobar_google_compute_router["region"],
peer_asn=65515,
advertised_route_priority=100,
interface=foobar_google_compute_router_interface["name"],
peer_ip_address="169.254.3.2",
md5_authentication_key=gcp.compute.RouterPeerMd5AuthenticationKeyArgs(
name="%s-peer-key",
key="%s-peer-key-value",
))
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/compute"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := compute.NewRouterPeer(ctx, "foobar", &compute.RouterPeerArgs{
Name: pulumi.String("%s-peer"),
Router: pulumi.Any(foobarGoogleComputeRouter.Name),
Region: pulumi.Any(foobarGoogleComputeRouter.Region),
PeerAsn: pulumi.Int(65515),
AdvertisedRoutePriority: pulumi.Int(100),
Interface: pulumi.Any(foobarGoogleComputeRouterInterface.Name),
PeerIpAddress: pulumi.String("169.254.3.2"),
Md5AuthenticationKey: &compute.RouterPeerMd5AuthenticationKeyArgs{
Name: pulumi.String("%s-peer-key"),
Key: pulumi.String("%s-peer-key-value"),
},
})
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 foobar = new Gcp.Compute.RouterPeer("foobar", new()
{
Name = "%s-peer",
Router = foobarGoogleComputeRouter.Name,
Region = foobarGoogleComputeRouter.Region,
PeerAsn = 65515,
AdvertisedRoutePriority = 100,
Interface = foobarGoogleComputeRouterInterface.Name,
PeerIpAddress = "169.254.3.2",
Md5AuthenticationKey = new Gcp.Compute.Inputs.RouterPeerMd5AuthenticationKeyArgs
{
Name = "%s-peer-key",
Key = "%s-peer-key-value",
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.RouterPeer;
import com.pulumi.gcp.compute.RouterPeerArgs;
import com.pulumi.gcp.compute.inputs.RouterPeerMd5AuthenticationKeyArgs;
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 foobar = new RouterPeer("foobar", RouterPeerArgs.builder()
.name("%s-peer")
.router(foobarGoogleComputeRouter.name())
.region(foobarGoogleComputeRouter.region())
.peerAsn(65515)
.advertisedRoutePriority(100)
.interface_(foobarGoogleComputeRouterInterface.name())
.peerIpAddress("169.254.3.2")
.md5AuthenticationKey(RouterPeerMd5AuthenticationKeyArgs.builder()
.name("%s-peer-key")
.key("%s-peer-key-value")
.build())
.build());
}
}
resources:
foobar:
type: gcp:compute:RouterPeer
properties:
name: '%s-peer'
router: ${foobarGoogleComputeRouter.name}
region: ${foobarGoogleComputeRouter.region}
peerAsn: 65515
advertisedRoutePriority: 100
interface: ${foobarGoogleComputeRouterInterface.name}
peerIpAddress: 169.254.3.2
md5AuthenticationKey:
name: '%s-peer-key'
key: '%s-peer-key-value'
Create RouterPeer Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new RouterPeer(name: string, args: RouterPeerArgs, opts?: CustomResourceOptions);
@overload
def RouterPeer(resource_name: str,
args: RouterPeerArgs,
opts: Optional[ResourceOptions] = None)
@overload
def RouterPeer(resource_name: str,
opts: Optional[ResourceOptions] = None,
interface: Optional[str] = None,
router: Optional[str] = None,
peer_asn: Optional[int] = None,
ipv4_nexthop_address: Optional[str] = None,
md5_authentication_key: Optional[RouterPeerMd5AuthenticationKeyArgs] = None,
enable: Optional[bool] = None,
enable_ipv4: Optional[bool] = None,
enable_ipv6: Optional[bool] = None,
advertised_route_priority: Optional[int] = None,
ip_address: Optional[str] = None,
advertise_mode: Optional[str] = None,
ipv6_nexthop_address: Optional[str] = None,
bfd: Optional[RouterPeerBfdArgs] = None,
name: Optional[str] = None,
advertised_ip_ranges: Optional[Sequence[RouterPeerAdvertisedIpRangeArgs]] = None,
peer_ip_address: Optional[str] = None,
peer_ipv4_nexthop_address: Optional[str] = None,
peer_ipv6_nexthop_address: Optional[str] = None,
project: Optional[str] = None,
region: Optional[str] = None,
advertised_groups: Optional[Sequence[str]] = None,
router_appliance_instance: Optional[str] = None)
func NewRouterPeer(ctx *Context, name string, args RouterPeerArgs, opts ...ResourceOption) (*RouterPeer, error)
public RouterPeer(string name, RouterPeerArgs args, CustomResourceOptions? opts = null)
public RouterPeer(String name, RouterPeerArgs args)
public RouterPeer(String name, RouterPeerArgs args, CustomResourceOptions options)
type: gcp:compute:RouterPeer
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 RouterPeerArgs
- 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 RouterPeerArgs
- 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 RouterPeerArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args RouterPeerArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args RouterPeerArgs
- 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 routerPeerResource = new Gcp.Compute.RouterPeer("routerPeerResource", new()
{
Interface = "string",
Router = "string",
PeerAsn = 0,
Ipv4NexthopAddress = "string",
Md5AuthenticationKey = new Gcp.Compute.Inputs.RouterPeerMd5AuthenticationKeyArgs
{
Key = "string",
Name = "string",
},
Enable = false,
EnableIpv4 = false,
EnableIpv6 = false,
AdvertisedRoutePriority = 0,
IpAddress = "string",
AdvertiseMode = "string",
Ipv6NexthopAddress = "string",
Bfd = new Gcp.Compute.Inputs.RouterPeerBfdArgs
{
SessionInitializationMode = "string",
MinReceiveInterval = 0,
MinTransmitInterval = 0,
Multiplier = 0,
},
Name = "string",
AdvertisedIpRanges = new[]
{
new Gcp.Compute.Inputs.RouterPeerAdvertisedIpRangeArgs
{
Range = "string",
Description = "string",
},
},
PeerIpAddress = "string",
PeerIpv4NexthopAddress = "string",
PeerIpv6NexthopAddress = "string",
Project = "string",
Region = "string",
AdvertisedGroups = new[]
{
"string",
},
RouterApplianceInstance = "string",
});
example, err := compute.NewRouterPeer(ctx, "routerPeerResource", &compute.RouterPeerArgs{
Interface: pulumi.String("string"),
Router: pulumi.String("string"),
PeerAsn: pulumi.Int(0),
Ipv4NexthopAddress: pulumi.String("string"),
Md5AuthenticationKey: &compute.RouterPeerMd5AuthenticationKeyArgs{
Key: pulumi.String("string"),
Name: pulumi.String("string"),
},
Enable: pulumi.Bool(false),
EnableIpv4: pulumi.Bool(false),
EnableIpv6: pulumi.Bool(false),
AdvertisedRoutePriority: pulumi.Int(0),
IpAddress: pulumi.String("string"),
AdvertiseMode: pulumi.String("string"),
Ipv6NexthopAddress: pulumi.String("string"),
Bfd: &compute.RouterPeerBfdArgs{
SessionInitializationMode: pulumi.String("string"),
MinReceiveInterval: pulumi.Int(0),
MinTransmitInterval: pulumi.Int(0),
Multiplier: pulumi.Int(0),
},
Name: pulumi.String("string"),
AdvertisedIpRanges: compute.RouterPeerAdvertisedIpRangeArray{
&compute.RouterPeerAdvertisedIpRangeArgs{
Range: pulumi.String("string"),
Description: pulumi.String("string"),
},
},
PeerIpAddress: pulumi.String("string"),
PeerIpv4NexthopAddress: pulumi.String("string"),
PeerIpv6NexthopAddress: pulumi.String("string"),
Project: pulumi.String("string"),
Region: pulumi.String("string"),
AdvertisedGroups: pulumi.StringArray{
pulumi.String("string"),
},
RouterApplianceInstance: pulumi.String("string"),
})
var routerPeerResource = new RouterPeer("routerPeerResource", RouterPeerArgs.builder()
.interface_("string")
.router("string")
.peerAsn(0)
.ipv4NexthopAddress("string")
.md5AuthenticationKey(RouterPeerMd5AuthenticationKeyArgs.builder()
.key("string")
.name("string")
.build())
.enable(false)
.enableIpv4(false)
.enableIpv6(false)
.advertisedRoutePriority(0)
.ipAddress("string")
.advertiseMode("string")
.ipv6NexthopAddress("string")
.bfd(RouterPeerBfdArgs.builder()
.sessionInitializationMode("string")
.minReceiveInterval(0)
.minTransmitInterval(0)
.multiplier(0)
.build())
.name("string")
.advertisedIpRanges(RouterPeerAdvertisedIpRangeArgs.builder()
.range("string")
.description("string")
.build())
.peerIpAddress("string")
.peerIpv4NexthopAddress("string")
.peerIpv6NexthopAddress("string")
.project("string")
.region("string")
.advertisedGroups("string")
.routerApplianceInstance("string")
.build());
router_peer_resource = gcp.compute.RouterPeer("routerPeerResource",
interface="string",
router="string",
peer_asn=0,
ipv4_nexthop_address="string",
md5_authentication_key=gcp.compute.RouterPeerMd5AuthenticationKeyArgs(
key="string",
name="string",
),
enable=False,
enable_ipv4=False,
enable_ipv6=False,
advertised_route_priority=0,
ip_address="string",
advertise_mode="string",
ipv6_nexthop_address="string",
bfd=gcp.compute.RouterPeerBfdArgs(
session_initialization_mode="string",
min_receive_interval=0,
min_transmit_interval=0,
multiplier=0,
),
name="string",
advertised_ip_ranges=[gcp.compute.RouterPeerAdvertisedIpRangeArgs(
range="string",
description="string",
)],
peer_ip_address="string",
peer_ipv4_nexthop_address="string",
peer_ipv6_nexthop_address="string",
project="string",
region="string",
advertised_groups=["string"],
router_appliance_instance="string")
const routerPeerResource = new gcp.compute.RouterPeer("routerPeerResource", {
"interface": "string",
router: "string",
peerAsn: 0,
ipv4NexthopAddress: "string",
md5AuthenticationKey: {
key: "string",
name: "string",
},
enable: false,
enableIpv4: false,
enableIpv6: false,
advertisedRoutePriority: 0,
ipAddress: "string",
advertiseMode: "string",
ipv6NexthopAddress: "string",
bfd: {
sessionInitializationMode: "string",
minReceiveInterval: 0,
minTransmitInterval: 0,
multiplier: 0,
},
name: "string",
advertisedIpRanges: [{
range: "string",
description: "string",
}],
peerIpAddress: "string",
peerIpv4NexthopAddress: "string",
peerIpv6NexthopAddress: "string",
project: "string",
region: "string",
advertisedGroups: ["string"],
routerApplianceInstance: "string",
});
type: gcp:compute:RouterPeer
properties:
advertiseMode: string
advertisedGroups:
- string
advertisedIpRanges:
- description: string
range: string
advertisedRoutePriority: 0
bfd:
minReceiveInterval: 0
minTransmitInterval: 0
multiplier: 0
sessionInitializationMode: string
enable: false
enableIpv4: false
enableIpv6: false
interface: string
ipAddress: string
ipv4NexthopAddress: string
ipv6NexthopAddress: string
md5AuthenticationKey:
key: string
name: string
name: string
peerAsn: 0
peerIpAddress: string
peerIpv4NexthopAddress: string
peerIpv6NexthopAddress: string
project: string
region: string
router: string
routerApplianceInstance: string
RouterPeer Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The RouterPeer resource accepts the following input properties:
- Interface string
- Name of the interface the BGP peer is associated with.
- Peer
Asn int - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- Router string
- The name of the Cloud Router in which this BgpPeer will be configured.
- Advertise
Mode string - User-specified flag to indicate which mode to use for advertisement.
Valid values of this enum field are:
DEFAULT
,CUSTOM
Default value isDEFAULT
. Possible values are:DEFAULT
,CUSTOM
. - Advertised
Groups List<string> User-specified list of prefix groups to advertise in custom mode, which currently supports the following option:
ALL_SUBNETS
: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering.
Note that this field can only be populated if advertiseMode is
CUSTOM
and overrides the list defined for the router (in the "bgp" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.- Advertised
Ip List<RouterRanges Peer Advertised Ip Range> - User-specified list of individual IP ranges to advertise in
custom mode. This field can only be populated if advertiseMode
is
CUSTOM
and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. Structure is documented below. - Advertised
Route intPriority - The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win.
- Bfd
Router
Peer Bfd - BFD configuration for the BGP peering. Structure is documented below.
- Enable bool
- The status of the BGP peer connection. If set to false, any active session with the peer is terminated and all associated routing information is removed. If set to true, the peer connection can be established with routing information. The default is true.
- Enable
Ipv4 bool - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- Enable
Ipv6 bool - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- Ip
Address string - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- Ipv4Nexthop
Address string - IPv4 address of the interface inside Google Cloud Platform.
- Ipv6Nexthop
Address string - IPv6 address of the interface inside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- Md5Authentication
Key RouterPeer Md5Authentication Key - Configuration for MD5 authentication on the BGP session. Structure is documented below.
- Name string
- Name of this BGP peer. 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. - Peer
Ip stringAddress - IP address of the BGP interface outside Google Cloud Platform.
Only IPv4 is supported. Required if
ip_address
is set. - Peer
Ipv4Nexthop stringAddress - IPv4 address of the BGP interface outside Google Cloud Platform.
- Peer
Ipv6Nexthop stringAddress - IPv6 address of the BGP interface outside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
- Region where the router and BgpPeer reside. If it is not provided, the provider region is used.
- Router
Appliance stringInstance - The URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session.
- Interface string
- Name of the interface the BGP peer is associated with.
- Peer
Asn int - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- Router string
- The name of the Cloud Router in which this BgpPeer will be configured.
- Advertise
Mode string - User-specified flag to indicate which mode to use for advertisement.
Valid values of this enum field are:
DEFAULT
,CUSTOM
Default value isDEFAULT
. Possible values are:DEFAULT
,CUSTOM
. - Advertised
Groups []string User-specified list of prefix groups to advertise in custom mode, which currently supports the following option:
ALL_SUBNETS
: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering.
Note that this field can only be populated if advertiseMode is
CUSTOM
and overrides the list defined for the router (in the "bgp" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.- Advertised
Ip []RouterRanges Peer Advertised Ip Range Args - User-specified list of individual IP ranges to advertise in
custom mode. This field can only be populated if advertiseMode
is
CUSTOM
and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. Structure is documented below. - Advertised
Route intPriority - The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win.
- Bfd
Router
Peer Bfd Args - BFD configuration for the BGP peering. Structure is documented below.
- Enable bool
- The status of the BGP peer connection. If set to false, any active session with the peer is terminated and all associated routing information is removed. If set to true, the peer connection can be established with routing information. The default is true.
- Enable
Ipv4 bool - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- Enable
Ipv6 bool - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- Ip
Address string - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- Ipv4Nexthop
Address string - IPv4 address of the interface inside Google Cloud Platform.
- Ipv6Nexthop
Address string - IPv6 address of the interface inside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- Md5Authentication
Key RouterPeer Md5Authentication Key Args - Configuration for MD5 authentication on the BGP session. Structure is documented below.
- Name string
- Name of this BGP peer. 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. - Peer
Ip stringAddress - IP address of the BGP interface outside Google Cloud Platform.
Only IPv4 is supported. Required if
ip_address
is set. - Peer
Ipv4Nexthop stringAddress - IPv4 address of the BGP interface outside Google Cloud Platform.
- Peer
Ipv6Nexthop stringAddress - IPv6 address of the BGP interface outside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
- Region where the router and BgpPeer reside. If it is not provided, the provider region is used.
- Router
Appliance stringInstance - The URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session.
- interface_ String
- Name of the interface the BGP peer is associated with.
- peer
Asn Integer - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- router String
- The name of the Cloud Router in which this BgpPeer will be configured.
- advertise
Mode String - User-specified flag to indicate which mode to use for advertisement.
Valid values of this enum field are:
DEFAULT
,CUSTOM
Default value isDEFAULT
. Possible values are:DEFAULT
,CUSTOM
. - advertised
Groups List<String> User-specified list of prefix groups to advertise in custom mode, which currently supports the following option:
ALL_SUBNETS
: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering.
Note that this field can only be populated if advertiseMode is
CUSTOM
and overrides the list defined for the router (in the "bgp" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.- advertised
Ip List<RouterRanges Peer Advertised Ip Range> - User-specified list of individual IP ranges to advertise in
custom mode. This field can only be populated if advertiseMode
is
CUSTOM
and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. Structure is documented below. - advertised
Route IntegerPriority - The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win.
- bfd
Router
Peer Bfd - BFD configuration for the BGP peering. Structure is documented below.
- enable Boolean
- The status of the BGP peer connection. If set to false, any active session with the peer is terminated and all associated routing information is removed. If set to true, the peer connection can be established with routing information. The default is true.
- enable
Ipv4 Boolean - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- enable
Ipv6 Boolean - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- ip
Address String - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- ipv4Nexthop
Address String - IPv4 address of the interface inside Google Cloud Platform.
- ipv6Nexthop
Address String - IPv6 address of the interface inside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- md5Authentication
Key RouterPeer Md5Authentication Key - Configuration for MD5 authentication on the BGP session. Structure is documented below.
- name String
- Name of this BGP peer. 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. - peer
Ip StringAddress - IP address of the BGP interface outside Google Cloud Platform.
Only IPv4 is supported. Required if
ip_address
is set. - peer
Ipv4Nexthop StringAddress - IPv4 address of the BGP interface outside Google Cloud Platform.
- peer
Ipv6Nexthop StringAddress - IPv6 address of the BGP interface outside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region String
- Region where the router and BgpPeer reside. If it is not provided, the provider region is used.
- router
Appliance StringInstance - The URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session.
- interface string
- Name of the interface the BGP peer is associated with.
- peer
Asn number - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- router string
- The name of the Cloud Router in which this BgpPeer will be configured.
- advertise
Mode string - User-specified flag to indicate which mode to use for advertisement.
Valid values of this enum field are:
DEFAULT
,CUSTOM
Default value isDEFAULT
. Possible values are:DEFAULT
,CUSTOM
. - advertised
Groups string[] User-specified list of prefix groups to advertise in custom mode, which currently supports the following option:
ALL_SUBNETS
: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering.
Note that this field can only be populated if advertiseMode is
CUSTOM
and overrides the list defined for the router (in the "bgp" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.- advertised
Ip RouterRanges Peer Advertised Ip Range[] - User-specified list of individual IP ranges to advertise in
custom mode. This field can only be populated if advertiseMode
is
CUSTOM
and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. Structure is documented below. - advertised
Route numberPriority - The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win.
- bfd
Router
Peer Bfd - BFD configuration for the BGP peering. Structure is documented below.
- enable boolean
- The status of the BGP peer connection. If set to false, any active session with the peer is terminated and all associated routing information is removed. If set to true, the peer connection can be established with routing information. The default is true.
- enable
Ipv4 boolean - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- enable
Ipv6 boolean - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- ip
Address string - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- ipv4Nexthop
Address string - IPv4 address of the interface inside Google Cloud Platform.
- ipv6Nexthop
Address string - IPv6 address of the interface inside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- md5Authentication
Key RouterPeer Md5Authentication Key - Configuration for MD5 authentication on the BGP session. Structure is documented below.
- name string
- Name of this BGP peer. 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. - peer
Ip stringAddress - IP address of the BGP interface outside Google Cloud Platform.
Only IPv4 is supported. Required if
ip_address
is set. - peer
Ipv4Nexthop stringAddress - IPv4 address of the BGP interface outside Google Cloud Platform.
- peer
Ipv6Nexthop stringAddress - IPv6 address of the BGP interface outside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region string
- Region where the router and BgpPeer reside. If it is not provided, the provider region is used.
- router
Appliance stringInstance - The URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session.
- interface str
- Name of the interface the BGP peer is associated with.
- peer_
asn int - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- router str
- The name of the Cloud Router in which this BgpPeer will be configured.
- advertise_
mode str - User-specified flag to indicate which mode to use for advertisement.
Valid values of this enum field are:
DEFAULT
,CUSTOM
Default value isDEFAULT
. Possible values are:DEFAULT
,CUSTOM
. - advertised_
groups Sequence[str] User-specified list of prefix groups to advertise in custom mode, which currently supports the following option:
ALL_SUBNETS
: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering.
Note that this field can only be populated if advertiseMode is
CUSTOM
and overrides the list defined for the router (in the "bgp" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.- advertised_
ip_ Sequence[Routerranges Peer Advertised Ip Range Args] - User-specified list of individual IP ranges to advertise in
custom mode. This field can only be populated if advertiseMode
is
CUSTOM
and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. Structure is documented below. - advertised_
route_ intpriority - The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win.
- bfd
Router
Peer Bfd Args - BFD configuration for the BGP peering. Structure is documented below.
- enable bool
- The status of the BGP peer connection. If set to false, any active session with the peer is terminated and all associated routing information is removed. If set to true, the peer connection can be established with routing information. The default is true.
- enable_
ipv4 bool - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- enable_
ipv6 bool - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- ip_
address str - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- ipv4_
nexthop_ straddress - IPv4 address of the interface inside Google Cloud Platform.
- ipv6_
nexthop_ straddress - IPv6 address of the interface inside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- md5_
authentication_ Routerkey Peer Md5Authentication Key Args - Configuration for MD5 authentication on the BGP session. Structure is documented below.
- name str
- Name of this BGP peer. 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. - peer_
ip_ straddress - IP address of the BGP interface outside Google Cloud Platform.
Only IPv4 is supported. Required if
ip_address
is set. - peer_
ipv4_ strnexthop_ address - IPv4 address of the BGP interface outside Google Cloud Platform.
- peer_
ipv6_ strnexthop_ address - IPv6 address of the BGP interface outside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- project str
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region str
- Region where the router and BgpPeer reside. If it is not provided, the provider region is used.
- router_
appliance_ strinstance - The URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session.
- interface String
- Name of the interface the BGP peer is associated with.
- peer
Asn Number - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- router String
- The name of the Cloud Router in which this BgpPeer will be configured.
- advertise
Mode String - User-specified flag to indicate which mode to use for advertisement.
Valid values of this enum field are:
DEFAULT
,CUSTOM
Default value isDEFAULT
. Possible values are:DEFAULT
,CUSTOM
. - advertised
Groups List<String> User-specified list of prefix groups to advertise in custom mode, which currently supports the following option:
ALL_SUBNETS
: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering.
Note that this field can only be populated if advertiseMode is
CUSTOM
and overrides the list defined for the router (in the "bgp" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.- advertised
Ip List<Property Map>Ranges - User-specified list of individual IP ranges to advertise in
custom mode. This field can only be populated if advertiseMode
is
CUSTOM
and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. Structure is documented below. - advertised
Route NumberPriority - The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win.
- bfd Property Map
- BFD configuration for the BGP peering. Structure is documented below.
- enable Boolean
- The status of the BGP peer connection. If set to false, any active session with the peer is terminated and all associated routing information is removed. If set to true, the peer connection can be established with routing information. The default is true.
- enable
Ipv4 Boolean - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- enable
Ipv6 Boolean - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- ip
Address String - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- ipv4Nexthop
Address String - IPv4 address of the interface inside Google Cloud Platform.
- ipv6Nexthop
Address String - IPv6 address of the interface inside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- md5Authentication
Key Property Map - Configuration for MD5 authentication on the BGP session. Structure is documented below.
- name String
- Name of this BGP peer. 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. - peer
Ip StringAddress - IP address of the BGP interface outside Google Cloud Platform.
Only IPv4 is supported. Required if
ip_address
is set. - peer
Ipv4Nexthop StringAddress - IPv4 address of the BGP interface outside Google Cloud Platform.
- peer
Ipv6Nexthop StringAddress - IPv6 address of the BGP interface outside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region String
- Region where the router and BgpPeer reside. If it is not provided, the provider region is used.
- router
Appliance StringInstance - The URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session.
Outputs
All input properties are implicitly available as output properties. Additionally, the RouterPeer resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Management
Type string - The resource that configures and manages this BGP peer.
MANAGED_BY_USER
is the default value and can be managed by you or other usersMANAGED_BY_ATTACHMENT
is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted.
- Id string
- The provider-assigned unique ID for this managed resource.
- Management
Type string - The resource that configures and manages this BGP peer.
MANAGED_BY_USER
is the default value and can be managed by you or other usersMANAGED_BY_ATTACHMENT
is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted.
- id String
- The provider-assigned unique ID for this managed resource.
- management
Type String - The resource that configures and manages this BGP peer.
MANAGED_BY_USER
is the default value and can be managed by you or other usersMANAGED_BY_ATTACHMENT
is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted.
- id string
- The provider-assigned unique ID for this managed resource.
- management
Type string - The resource that configures and manages this BGP peer.
MANAGED_BY_USER
is the default value and can be managed by you or other usersMANAGED_BY_ATTACHMENT
is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted.
- id str
- The provider-assigned unique ID for this managed resource.
- management_
type str - The resource that configures and manages this BGP peer.
MANAGED_BY_USER
is the default value and can be managed by you or other usersMANAGED_BY_ATTACHMENT
is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted.
- id String
- The provider-assigned unique ID for this managed resource.
- management
Type String - The resource that configures and manages this BGP peer.
MANAGED_BY_USER
is the default value and can be managed by you or other usersMANAGED_BY_ATTACHMENT
is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted.
Look up Existing RouterPeer Resource
Get an existing RouterPeer 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?: RouterPeerState, opts?: CustomResourceOptions): RouterPeer
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
advertise_mode: Optional[str] = None,
advertised_groups: Optional[Sequence[str]] = None,
advertised_ip_ranges: Optional[Sequence[RouterPeerAdvertisedIpRangeArgs]] = None,
advertised_route_priority: Optional[int] = None,
bfd: Optional[RouterPeerBfdArgs] = None,
enable: Optional[bool] = None,
enable_ipv4: Optional[bool] = None,
enable_ipv6: Optional[bool] = None,
interface: Optional[str] = None,
ip_address: Optional[str] = None,
ipv4_nexthop_address: Optional[str] = None,
ipv6_nexthop_address: Optional[str] = None,
management_type: Optional[str] = None,
md5_authentication_key: Optional[RouterPeerMd5AuthenticationKeyArgs] = None,
name: Optional[str] = None,
peer_asn: Optional[int] = None,
peer_ip_address: Optional[str] = None,
peer_ipv4_nexthop_address: Optional[str] = None,
peer_ipv6_nexthop_address: Optional[str] = None,
project: Optional[str] = None,
region: Optional[str] = None,
router: Optional[str] = None,
router_appliance_instance: Optional[str] = None) -> RouterPeer
func GetRouterPeer(ctx *Context, name string, id IDInput, state *RouterPeerState, opts ...ResourceOption) (*RouterPeer, error)
public static RouterPeer Get(string name, Input<string> id, RouterPeerState? state, CustomResourceOptions? opts = null)
public static RouterPeer get(String name, Output<String> id, RouterPeerState 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.
- Advertise
Mode string - User-specified flag to indicate which mode to use for advertisement.
Valid values of this enum field are:
DEFAULT
,CUSTOM
Default value isDEFAULT
. Possible values are:DEFAULT
,CUSTOM
. - Advertised
Groups List<string> User-specified list of prefix groups to advertise in custom mode, which currently supports the following option:
ALL_SUBNETS
: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering.
Note that this field can only be populated if advertiseMode is
CUSTOM
and overrides the list defined for the router (in the "bgp" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.- Advertised
Ip List<RouterRanges Peer Advertised Ip Range> - User-specified list of individual IP ranges to advertise in
custom mode. This field can only be populated if advertiseMode
is
CUSTOM
and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. Structure is documented below. - Advertised
Route intPriority - The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win.
- Bfd
Router
Peer Bfd - BFD configuration for the BGP peering. Structure is documented below.
- Enable bool
- The status of the BGP peer connection. If set to false, any active session with the peer is terminated and all associated routing information is removed. If set to true, the peer connection can be established with routing information. The default is true.
- Enable
Ipv4 bool - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- Enable
Ipv6 bool - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- Interface string
- Name of the interface the BGP peer is associated with.
- Ip
Address string - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- Ipv4Nexthop
Address string - IPv4 address of the interface inside Google Cloud Platform.
- Ipv6Nexthop
Address string - IPv6 address of the interface inside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- Management
Type string - The resource that configures and manages this BGP peer.
MANAGED_BY_USER
is the default value and can be managed by you or other usersMANAGED_BY_ATTACHMENT
is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted.
- Md5Authentication
Key RouterPeer Md5Authentication Key - Configuration for MD5 authentication on the BGP session. Structure is documented below.
- Name string
- Name of this BGP peer. 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. - Peer
Asn int - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- Peer
Ip stringAddress - IP address of the BGP interface outside Google Cloud Platform.
Only IPv4 is supported. Required if
ip_address
is set. - Peer
Ipv4Nexthop stringAddress - IPv4 address of the BGP interface outside Google Cloud Platform.
- Peer
Ipv6Nexthop stringAddress - IPv6 address of the BGP interface outside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
- Region where the router and BgpPeer reside. If it is not provided, the provider region is used.
- Router string
- The name of the Cloud Router in which this BgpPeer will be configured.
- Router
Appliance stringInstance - The URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session.
- Advertise
Mode string - User-specified flag to indicate which mode to use for advertisement.
Valid values of this enum field are:
DEFAULT
,CUSTOM
Default value isDEFAULT
. Possible values are:DEFAULT
,CUSTOM
. - Advertised
Groups []string User-specified list of prefix groups to advertise in custom mode, which currently supports the following option:
ALL_SUBNETS
: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering.
Note that this field can only be populated if advertiseMode is
CUSTOM
and overrides the list defined for the router (in the "bgp" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.- Advertised
Ip []RouterRanges Peer Advertised Ip Range Args - User-specified list of individual IP ranges to advertise in
custom mode. This field can only be populated if advertiseMode
is
CUSTOM
and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. Structure is documented below. - Advertised
Route intPriority - The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win.
- Bfd
Router
Peer Bfd Args - BFD configuration for the BGP peering. Structure is documented below.
- Enable bool
- The status of the BGP peer connection. If set to false, any active session with the peer is terminated and all associated routing information is removed. If set to true, the peer connection can be established with routing information. The default is true.
- Enable
Ipv4 bool - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- Enable
Ipv6 bool - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- Interface string
- Name of the interface the BGP peer is associated with.
- Ip
Address string - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- Ipv4Nexthop
Address string - IPv4 address of the interface inside Google Cloud Platform.
- Ipv6Nexthop
Address string - IPv6 address of the interface inside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- Management
Type string - The resource that configures and manages this BGP peer.
MANAGED_BY_USER
is the default value and can be managed by you or other usersMANAGED_BY_ATTACHMENT
is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted.
- Md5Authentication
Key RouterPeer Md5Authentication Key Args - Configuration for MD5 authentication on the BGP session. Structure is documented below.
- Name string
- Name of this BGP peer. 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. - Peer
Asn int - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- Peer
Ip stringAddress - IP address of the BGP interface outside Google Cloud Platform.
Only IPv4 is supported. Required if
ip_address
is set. - Peer
Ipv4Nexthop stringAddress - IPv4 address of the BGP interface outside Google Cloud Platform.
- Peer
Ipv6Nexthop stringAddress - IPv6 address of the BGP interface outside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
- Region where the router and BgpPeer reside. If it is not provided, the provider region is used.
- Router string
- The name of the Cloud Router in which this BgpPeer will be configured.
- Router
Appliance stringInstance - The URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session.
- advertise
Mode String - User-specified flag to indicate which mode to use for advertisement.
Valid values of this enum field are:
DEFAULT
,CUSTOM
Default value isDEFAULT
. Possible values are:DEFAULT
,CUSTOM
. - advertised
Groups List<String> User-specified list of prefix groups to advertise in custom mode, which currently supports the following option:
ALL_SUBNETS
: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering.
Note that this field can only be populated if advertiseMode is
CUSTOM
and overrides the list defined for the router (in the "bgp" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.- advertised
Ip List<RouterRanges Peer Advertised Ip Range> - User-specified list of individual IP ranges to advertise in
custom mode. This field can only be populated if advertiseMode
is
CUSTOM
and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. Structure is documented below. - advertised
Route IntegerPriority - The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win.
- bfd
Router
Peer Bfd - BFD configuration for the BGP peering. Structure is documented below.
- enable Boolean
- The status of the BGP peer connection. If set to false, any active session with the peer is terminated and all associated routing information is removed. If set to true, the peer connection can be established with routing information. The default is true.
- enable
Ipv4 Boolean - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- enable
Ipv6 Boolean - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- interface_ String
- Name of the interface the BGP peer is associated with.
- ip
Address String - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- ipv4Nexthop
Address String - IPv4 address of the interface inside Google Cloud Platform.
- ipv6Nexthop
Address String - IPv6 address of the interface inside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- management
Type String - The resource that configures and manages this BGP peer.
MANAGED_BY_USER
is the default value and can be managed by you or other usersMANAGED_BY_ATTACHMENT
is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted.
- md5Authentication
Key RouterPeer Md5Authentication Key - Configuration for MD5 authentication on the BGP session. Structure is documented below.
- name String
- Name of this BGP peer. 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. - peer
Asn Integer - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- peer
Ip StringAddress - IP address of the BGP interface outside Google Cloud Platform.
Only IPv4 is supported. Required if
ip_address
is set. - peer
Ipv4Nexthop StringAddress - IPv4 address of the BGP interface outside Google Cloud Platform.
- peer
Ipv6Nexthop StringAddress - IPv6 address of the BGP interface outside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region String
- Region where the router and BgpPeer reside. If it is not provided, the provider region is used.
- router String
- The name of the Cloud Router in which this BgpPeer will be configured.
- router
Appliance StringInstance - The URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session.
- advertise
Mode string - User-specified flag to indicate which mode to use for advertisement.
Valid values of this enum field are:
DEFAULT
,CUSTOM
Default value isDEFAULT
. Possible values are:DEFAULT
,CUSTOM
. - advertised
Groups string[] User-specified list of prefix groups to advertise in custom mode, which currently supports the following option:
ALL_SUBNETS
: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering.
Note that this field can only be populated if advertiseMode is
CUSTOM
and overrides the list defined for the router (in the "bgp" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.- advertised
Ip RouterRanges Peer Advertised Ip Range[] - User-specified list of individual IP ranges to advertise in
custom mode. This field can only be populated if advertiseMode
is
CUSTOM
and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. Structure is documented below. - advertised
Route numberPriority - The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win.
- bfd
Router
Peer Bfd - BFD configuration for the BGP peering. Structure is documented below.
- enable boolean
- The status of the BGP peer connection. If set to false, any active session with the peer is terminated and all associated routing information is removed. If set to true, the peer connection can be established with routing information. The default is true.
- enable
Ipv4 boolean - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- enable
Ipv6 boolean - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- interface string
- Name of the interface the BGP peer is associated with.
- ip
Address string - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- ipv4Nexthop
Address string - IPv4 address of the interface inside Google Cloud Platform.
- ipv6Nexthop
Address string - IPv6 address of the interface inside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- management
Type string - The resource that configures and manages this BGP peer.
MANAGED_BY_USER
is the default value and can be managed by you or other usersMANAGED_BY_ATTACHMENT
is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted.
- md5Authentication
Key RouterPeer Md5Authentication Key - Configuration for MD5 authentication on the BGP session. Structure is documented below.
- name string
- Name of this BGP peer. 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. - peer
Asn number - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- peer
Ip stringAddress - IP address of the BGP interface outside Google Cloud Platform.
Only IPv4 is supported. Required if
ip_address
is set. - peer
Ipv4Nexthop stringAddress - IPv4 address of the BGP interface outside Google Cloud Platform.
- peer
Ipv6Nexthop stringAddress - IPv6 address of the BGP interface outside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region string
- Region where the router and BgpPeer reside. If it is not provided, the provider region is used.
- router string
- The name of the Cloud Router in which this BgpPeer will be configured.
- router
Appliance stringInstance - The URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session.
- advertise_
mode str - User-specified flag to indicate which mode to use for advertisement.
Valid values of this enum field are:
DEFAULT
,CUSTOM
Default value isDEFAULT
. Possible values are:DEFAULT
,CUSTOM
. - advertised_
groups Sequence[str] User-specified list of prefix groups to advertise in custom mode, which currently supports the following option:
ALL_SUBNETS
: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering.
Note that this field can only be populated if advertiseMode is
CUSTOM
and overrides the list defined for the router (in the "bgp" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.- advertised_
ip_ Sequence[Routerranges Peer Advertised Ip Range Args] - User-specified list of individual IP ranges to advertise in
custom mode. This field can only be populated if advertiseMode
is
CUSTOM
and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. Structure is documented below. - advertised_
route_ intpriority - The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win.
- bfd
Router
Peer Bfd Args - BFD configuration for the BGP peering. Structure is documented below.
- enable bool
- The status of the BGP peer connection. If set to false, any active session with the peer is terminated and all associated routing information is removed. If set to true, the peer connection can be established with routing information. The default is true.
- enable_
ipv4 bool - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- enable_
ipv6 bool - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- interface str
- Name of the interface the BGP peer is associated with.
- ip_
address str - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- ipv4_
nexthop_ straddress - IPv4 address of the interface inside Google Cloud Platform.
- ipv6_
nexthop_ straddress - IPv6 address of the interface inside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- management_
type str - The resource that configures and manages this BGP peer.
MANAGED_BY_USER
is the default value and can be managed by you or other usersMANAGED_BY_ATTACHMENT
is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted.
- md5_
authentication_ Routerkey Peer Md5Authentication Key Args - Configuration for MD5 authentication on the BGP session. Structure is documented below.
- name str
- Name of this BGP peer. 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. - peer_
asn int - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- peer_
ip_ straddress - IP address of the BGP interface outside Google Cloud Platform.
Only IPv4 is supported. Required if
ip_address
is set. - peer_
ipv4_ strnexthop_ address - IPv4 address of the BGP interface outside Google Cloud Platform.
- peer_
ipv6_ strnexthop_ address - IPv6 address of the BGP interface outside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- project str
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region str
- Region where the router and BgpPeer reside. If it is not provided, the provider region is used.
- router str
- The name of the Cloud Router in which this BgpPeer will be configured.
- router_
appliance_ strinstance - The URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session.
- advertise
Mode String - User-specified flag to indicate which mode to use for advertisement.
Valid values of this enum field are:
DEFAULT
,CUSTOM
Default value isDEFAULT
. Possible values are:DEFAULT
,CUSTOM
. - advertised
Groups List<String> User-specified list of prefix groups to advertise in custom mode, which currently supports the following option:
ALL_SUBNETS
: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering.
Note that this field can only be populated if advertiseMode is
CUSTOM
and overrides the list defined for the router (in the "bgp" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.- advertised
Ip List<Property Map>Ranges - User-specified list of individual IP ranges to advertise in
custom mode. This field can only be populated if advertiseMode
is
CUSTOM
and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges. Structure is documented below. - advertised
Route NumberPriority - The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win.
- bfd Property Map
- BFD configuration for the BGP peering. Structure is documented below.
- enable Boolean
- The status of the BGP peer connection. If set to false, any active session with the peer is terminated and all associated routing information is removed. If set to true, the peer connection can be established with routing information. The default is true.
- enable
Ipv4 Boolean - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- enable
Ipv6 Boolean - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- interface String
- Name of the interface the BGP peer is associated with.
- ip
Address String - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- ipv4Nexthop
Address String - IPv4 address of the interface inside Google Cloud Platform.
- ipv6Nexthop
Address String - IPv6 address of the interface inside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- management
Type String - The resource that configures and manages this BGP peer.
MANAGED_BY_USER
is the default value and can be managed by you or other usersMANAGED_BY_ATTACHMENT
is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted.
- md5Authentication
Key Property Map - Configuration for MD5 authentication on the BGP session. Structure is documented below.
- name String
- Name of this BGP peer. 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. - peer
Asn Number - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- peer
Ip StringAddress - IP address of the BGP interface outside Google Cloud Platform.
Only IPv4 is supported. Required if
ip_address
is set. - peer
Ipv4Nexthop StringAddress - IPv4 address of the BGP interface outside Google Cloud Platform.
- peer
Ipv6Nexthop StringAddress - IPv6 address of the BGP interface outside Google Cloud Platform. The address must be in the range 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64. If you do not specify the next hop addresses, Google Cloud automatically assigns unused addresses from the 2600:2d00:0:2::/64 or 2600:2d00:0:3::/64 range for you.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region String
- Region where the router and BgpPeer reside. If it is not provided, the provider region is used.
- router String
- The name of the Cloud Router in which this BgpPeer will be configured.
- router
Appliance StringInstance - The URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session.
Supporting Types
RouterPeerAdvertisedIpRange, RouterPeerAdvertisedIpRangeArgs
- Range string
- The IP range to advertise. The value must be a CIDR-formatted string.
- Description string
- User-specified description for the IP range.
- Range string
- The IP range to advertise. The value must be a CIDR-formatted string.
- Description string
- User-specified description for the IP range.
- range String
- The IP range to advertise. The value must be a CIDR-formatted string.
- description String
- User-specified description for the IP range.
- range string
- The IP range to advertise. The value must be a CIDR-formatted string.
- description string
- User-specified description for the IP range.
- range str
- The IP range to advertise. The value must be a CIDR-formatted string.
- description str
- User-specified description for the IP range.
- range String
- The IP range to advertise. The value must be a CIDR-formatted string.
- description String
- User-specified description for the IP range.
RouterPeerBfd, RouterPeerBfdArgs
- Session
Initialization stringMode - The BFD session initialization mode for this BGP peer.
If set to
ACTIVE
, the Cloud Router will initiate the BFD session for this BGP peer. If set toPASSIVE
, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set toDISABLED
, BFD is disabled for this BGP peer. Possible values are:ACTIVE
,DISABLED
,PASSIVE
. - Min
Receive intInterval - The minimum interval, in milliseconds, between BFD control packets received from the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the transmit interval of the other router. If set, this value must be between 1000 and 30000.
- Min
Transmit intInterval - The minimum interval, in milliseconds, between BFD control packets transmitted to the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the corresponding receive interval of the other router. If set, this value must be between 1000 and 30000.
- Multiplier int
The number of consecutive BFD packets that must be missed before BFD declares that a peer is unavailable. If set, the value must be a value between 5 and 16.
The
md5_authentication_key
block supports:
- Session
Initialization stringMode - The BFD session initialization mode for this BGP peer.
If set to
ACTIVE
, the Cloud Router will initiate the BFD session for this BGP peer. If set toPASSIVE
, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set toDISABLED
, BFD is disabled for this BGP peer. Possible values are:ACTIVE
,DISABLED
,PASSIVE
. - Min
Receive intInterval - The minimum interval, in milliseconds, between BFD control packets received from the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the transmit interval of the other router. If set, this value must be between 1000 and 30000.
- Min
Transmit intInterval - The minimum interval, in milliseconds, between BFD control packets transmitted to the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the corresponding receive interval of the other router. If set, this value must be between 1000 and 30000.
- Multiplier int
The number of consecutive BFD packets that must be missed before BFD declares that a peer is unavailable. If set, the value must be a value between 5 and 16.
The
md5_authentication_key
block supports:
- session
Initialization StringMode - The BFD session initialization mode for this BGP peer.
If set to
ACTIVE
, the Cloud Router will initiate the BFD session for this BGP peer. If set toPASSIVE
, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set toDISABLED
, BFD is disabled for this BGP peer. Possible values are:ACTIVE
,DISABLED
,PASSIVE
. - min
Receive IntegerInterval - The minimum interval, in milliseconds, between BFD control packets received from the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the transmit interval of the other router. If set, this value must be between 1000 and 30000.
- min
Transmit IntegerInterval - The minimum interval, in milliseconds, between BFD control packets transmitted to the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the corresponding receive interval of the other router. If set, this value must be between 1000 and 30000.
- multiplier Integer
The number of consecutive BFD packets that must be missed before BFD declares that a peer is unavailable. If set, the value must be a value between 5 and 16.
The
md5_authentication_key
block supports:
- session
Initialization stringMode - The BFD session initialization mode for this BGP peer.
If set to
ACTIVE
, the Cloud Router will initiate the BFD session for this BGP peer. If set toPASSIVE
, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set toDISABLED
, BFD is disabled for this BGP peer. Possible values are:ACTIVE
,DISABLED
,PASSIVE
. - min
Receive numberInterval - The minimum interval, in milliseconds, between BFD control packets received from the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the transmit interval of the other router. If set, this value must be between 1000 and 30000.
- min
Transmit numberInterval - The minimum interval, in milliseconds, between BFD control packets transmitted to the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the corresponding receive interval of the other router. If set, this value must be between 1000 and 30000.
- multiplier number
The number of consecutive BFD packets that must be missed before BFD declares that a peer is unavailable. If set, the value must be a value between 5 and 16.
The
md5_authentication_key
block supports:
- session_
initialization_ strmode - The BFD session initialization mode for this BGP peer.
If set to
ACTIVE
, the Cloud Router will initiate the BFD session for this BGP peer. If set toPASSIVE
, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set toDISABLED
, BFD is disabled for this BGP peer. Possible values are:ACTIVE
,DISABLED
,PASSIVE
. - min_
receive_ intinterval - The minimum interval, in milliseconds, between BFD control packets received from the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the transmit interval of the other router. If set, this value must be between 1000 and 30000.
- min_
transmit_ intinterval - The minimum interval, in milliseconds, between BFD control packets transmitted to the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the corresponding receive interval of the other router. If set, this value must be between 1000 and 30000.
- multiplier int
The number of consecutive BFD packets that must be missed before BFD declares that a peer is unavailable. If set, the value must be a value between 5 and 16.
The
md5_authentication_key
block supports:
- session
Initialization StringMode - The BFD session initialization mode for this BGP peer.
If set to
ACTIVE
, the Cloud Router will initiate the BFD session for this BGP peer. If set toPASSIVE
, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set toDISABLED
, BFD is disabled for this BGP peer. Possible values are:ACTIVE
,DISABLED
,PASSIVE
. - min
Receive NumberInterval - The minimum interval, in milliseconds, between BFD control packets received from the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the transmit interval of the other router. If set, this value must be between 1000 and 30000.
- min
Transmit NumberInterval - The minimum interval, in milliseconds, between BFD control packets transmitted to the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the corresponding receive interval of the other router. If set, this value must be between 1000 and 30000.
- multiplier Number
The number of consecutive BFD packets that must be missed before BFD declares that a peer is unavailable. If set, the value must be a value between 5 and 16.
The
md5_authentication_key
block supports:
RouterPeerMd5AuthenticationKey, RouterPeerMd5AuthenticationKeyArgs
- Key string
- Value of the key.
- Name string
- Name of this BGP peer. 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.
- Key string
- Value of the key.
- Name string
- Name of this BGP peer. 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.
- key String
- Value of the key.
- name String
- Name of this BGP peer. 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.
- key string
- Value of the key.
- name string
- Name of this BGP peer. 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.
- key str
- Value of the key.
- name str
- Name of this BGP peer. 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.
- key String
- Value of the key.
- name String
- Name of this BGP peer. 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.
Import
RouterBgpPeer can be imported using any of these accepted formats:
projects/{{project}}/regions/{{region}}/routers/{{router}}/{{name}}
{{project}}/{{region}}/{{router}}/{{name}}
{{region}}/{{router}}/{{name}}
{{router}}/{{name}}
When using the pulumi import
command, RouterBgpPeer can be imported using one of the formats above. For example:
$ pulumi import gcp:compute/routerPeer:RouterPeer default projects/{{project}}/regions/{{region}}/routers/{{router}}/{{name}}
$ pulumi import gcp:compute/routerPeer:RouterPeer default {{project}}/{{region}}/{{router}}/{{name}}
$ pulumi import gcp:compute/routerPeer:RouterPeer default {{region}}/{{router}}/{{name}}
$ pulumi import gcp:compute/routerPeer:RouterPeer default {{router}}/{{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.