Google Cloud Native is in preview. Google Cloud Classic is fully supported.
Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi
google-native.compute/beta.getRouter
Explore with Pulumi AI
Google Cloud Native is in preview. Google Cloud Classic is fully supported.
Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi
Returns the specified Router resource.
Using getRouter
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getRouter(args: GetRouterArgs, opts?: InvokeOptions): Promise<GetRouterResult>
function getRouterOutput(args: GetRouterOutputArgs, opts?: InvokeOptions): Output<GetRouterResult>
def get_router(project: Optional[str] = None,
region: Optional[str] = None,
router: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetRouterResult
def get_router_output(project: Optional[pulumi.Input[str]] = None,
region: Optional[pulumi.Input[str]] = None,
router: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetRouterResult]
func LookupRouter(ctx *Context, args *LookupRouterArgs, opts ...InvokeOption) (*LookupRouterResult, error)
func LookupRouterOutput(ctx *Context, args *LookupRouterOutputArgs, opts ...InvokeOption) LookupRouterResultOutput
> Note: This function is named LookupRouter
in the Go SDK.
public static class GetRouter
{
public static Task<GetRouterResult> InvokeAsync(GetRouterArgs args, InvokeOptions? opts = null)
public static Output<GetRouterResult> Invoke(GetRouterInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetRouterResult> getRouter(GetRouterArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: google-native:compute/beta:getRouter
arguments:
# arguments dictionary
The following arguments are supported:
getRouter Result
The following output properties are available:
- Bgp
Pulumi.
Google Native. Compute. Beta. Outputs. Router Bgp Response - BGP information specific to this router.
- Bgp
Peers List<Pulumi.Google Native. Compute. Beta. Outputs. Router Bgp Peer Response> - 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.
- Creation
Timestamp string - Creation timestamp in RFC3339 text format.
- Description string
- An optional description of this resource. Provide this property when you create the resource.
- Encrypted
Interconnect boolRouter - Indicates if a router is dedicated for use with encrypted VLAN attachments (interconnectAttachments).
- Interfaces
List<Pulumi.
Google Native. Compute. Beta. Outputs. Router Interface Response> - Router interfaces. To create a BGP peer that uses a router interface, the interface must have one of the following fields specified: - linkedVpnTunnel - linkedInterconnectAttachment - subnetwork You can create a router interface without any of these fields specified. However, you cannot create a BGP peer that uses that interface.
- Kind string
- Type of resource. Always compute#router for routers.
- Md5Authentication
Keys List<Pulumi.Google Native. Compute. Beta. Outputs. Router Md5Authentication Key Response> - Keys used for MD5 authentication.
- Name string
- Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression
[a-z]([-a-z0-9]*[a-z0-9])?
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. - Nats
List<Pulumi.
Google Native. Compute. Beta. Outputs. Router Nat Response> - A list of NAT services created in this router.
- Network string
- URI of the network to which this router belongs.
- Region string
- URI of the region where the router resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
- Self
Link string - Server-defined URL for the resource.
- Bgp
Router
Bgp Response - BGP information specific to this router.
- Bgp
Peers []RouterBgp Peer Response - 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.
- Creation
Timestamp string - Creation timestamp in RFC3339 text format.
- Description string
- An optional description of this resource. Provide this property when you create the resource.
- Encrypted
Interconnect boolRouter - Indicates if a router is dedicated for use with encrypted VLAN attachments (interconnectAttachments).
- Interfaces
[]Router
Interface Response - Router interfaces. To create a BGP peer that uses a router interface, the interface must have one of the following fields specified: - linkedVpnTunnel - linkedInterconnectAttachment - subnetwork You can create a router interface without any of these fields specified. However, you cannot create a BGP peer that uses that interface.
- Kind string
- Type of resource. Always compute#router for routers.
- Md5Authentication
Keys []RouterMd5Authentication Key Response - Keys used for MD5 authentication.
- Name string
- Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression
[a-z]([-a-z0-9]*[a-z0-9])?
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. - Nats
[]Router
Nat Response - A list of NAT services created in this router.
- Network string
- URI of the network to which this router belongs.
- Region string
- URI of the region where the router resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
- Self
Link string - Server-defined URL for the resource.
- bgp
Router
Bgp Response - BGP information specific to this router.
- bgp
Peers List<RouterBgp Peer Response> - 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.
- creation
Timestamp String - Creation timestamp in RFC3339 text format.
- description String
- An optional description of this resource. Provide this property when you create the resource.
- encrypted
Interconnect BooleanRouter - Indicates if a router is dedicated for use with encrypted VLAN attachments (interconnectAttachments).
- interfaces
List<Router
Interface Response> - Router interfaces. To create a BGP peer that uses a router interface, the interface must have one of the following fields specified: - linkedVpnTunnel - linkedInterconnectAttachment - subnetwork You can create a router interface without any of these fields specified. However, you cannot create a BGP peer that uses that interface.
- kind String
- Type of resource. Always compute#router for routers.
- md5Authentication
Keys List<RouterMd5Authentication Key Response> - Keys used for MD5 authentication.
- name String
- Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression
[a-z]([-a-z0-9]*[a-z0-9])?
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. - nats
List<Router
Nat Response> - A list of NAT services created in this router.
- network String
- URI of the network to which this router belongs.
- region String
- URI of the region where the router resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
- self
Link String - Server-defined URL for the resource.
- bgp
Router
Bgp Response - BGP information specific to this router.
- bgp
Peers RouterBgp Peer Response[] - 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.
- creation
Timestamp string - Creation timestamp in RFC3339 text format.
- description string
- An optional description of this resource. Provide this property when you create the resource.
- encrypted
Interconnect booleanRouter - Indicates if a router is dedicated for use with encrypted VLAN attachments (interconnectAttachments).
- interfaces
Router
Interface Response[] - Router interfaces. To create a BGP peer that uses a router interface, the interface must have one of the following fields specified: - linkedVpnTunnel - linkedInterconnectAttachment - subnetwork You can create a router interface without any of these fields specified. However, you cannot create a BGP peer that uses that interface.
- kind string
- Type of resource. Always compute#router for routers.
- md5Authentication
Keys RouterMd5Authentication Key Response[] - Keys used for MD5 authentication.
- name string
- Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression
[a-z]([-a-z0-9]*[a-z0-9])?
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. - nats
Router
Nat Response[] - A list of NAT services created in this router.
- network string
- URI of the network to which this router belongs.
- region string
- URI of the region where the router resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
- self
Link string - Server-defined URL for the resource.
- bgp
Router
Bgp Response - BGP information specific to this router.
- bgp_
peers Sequence[RouterBgp Peer Response] - 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.
- creation_
timestamp str - Creation timestamp in RFC3339 text format.
- description str
- An optional description of this resource. Provide this property when you create the resource.
- encrypted_
interconnect_ boolrouter - Indicates if a router is dedicated for use with encrypted VLAN attachments (interconnectAttachments).
- interfaces
Sequence[Router
Interface Response] - Router interfaces. To create a BGP peer that uses a router interface, the interface must have one of the following fields specified: - linkedVpnTunnel - linkedInterconnectAttachment - subnetwork You can create a router interface without any of these fields specified. However, you cannot create a BGP peer that uses that interface.
- kind str
- Type of resource. Always compute#router for routers.
- md5_
authentication_ Sequence[Routerkeys Md5Authentication Key Response] - Keys used for MD5 authentication.
- name str
- Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression
[a-z]([-a-z0-9]*[a-z0-9])?
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. - nats
Sequence[Router
Nat Response] - A list of NAT services created in this router.
- network str
- URI of the network to which this router belongs.
- region str
- URI of the region where the router resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
- self_
link str - Server-defined URL for the resource.
- bgp Property Map
- BGP information specific to this router.
- bgp
Peers List<Property Map> - 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.
- creation
Timestamp String - Creation timestamp in RFC3339 text format.
- description String
- An optional description of this resource. Provide this property when you create the resource.
- encrypted
Interconnect BooleanRouter - Indicates if a router is dedicated for use with encrypted VLAN attachments (interconnectAttachments).
- interfaces List<Property Map>
- Router interfaces. To create a BGP peer that uses a router interface, the interface must have one of the following fields specified: - linkedVpnTunnel - linkedInterconnectAttachment - subnetwork You can create a router interface without any of these fields specified. However, you cannot create a BGP peer that uses that interface.
- kind String
- Type of resource. Always compute#router for routers.
- md5Authentication
Keys List<Property Map> - Keys used for MD5 authentication.
- name String
- Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression
[a-z]([-a-z0-9]*[a-z0-9])?
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. - nats List<Property Map>
- A list of NAT services created in this router.
- network String
- URI of the network to which this router belongs.
- region String
- URI of the region where the router resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
- self
Link String - Server-defined URL for the resource.
Supporting Types
RouterAdvertisedIpRangeResponse
- Description
This property is required. string - User-specified description for the IP range.
- Range
This property is required. string - The IP range to advertise. The value must be a CIDR-formatted string.
- Description
This property is required. string - User-specified description for the IP range.
- Range
This property is required. string - The IP range to advertise. The value must be a CIDR-formatted string.
- description
This property is required. String - User-specified description for the IP range.
- range
This property is required. String - The IP range to advertise. The value must be a CIDR-formatted string.
- description
This property is required. string - User-specified description for the IP range.
- range
This property is required. string - The IP range to advertise. The value must be a CIDR-formatted string.
- description
This property is required. str - User-specified description for the IP range.
- range
This property is required. str - The IP range to advertise. The value must be a CIDR-formatted string.
- description
This property is required. String - User-specified description for the IP range.
- range
This property is required. String - The IP range to advertise. The value must be a CIDR-formatted string.
RouterBgpPeerBfdResponse
- Min
Receive Interval This property is required. int - 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. The default is 1000.
- Min
Transmit Interval This property is required. int - 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. The default is 1000.
- Multiplier
This property is required. 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 default is 5.
- Session
Initialization Mode This property is required. string - 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 to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. The default is DISABLED.
- Min
Receive Interval This property is required. int - 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. The default is 1000.
- Min
Transmit Interval This property is required. int - 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. The default is 1000.
- Multiplier
This property is required. 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 default is 5.
- Session
Initialization Mode This property is required. string - 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 to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. The default is DISABLED.
- min
Receive Interval This property is required. Integer - 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. The default is 1000.
- min
Transmit Interval This property is required. Integer - 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. The default is 1000.
- multiplier
This property is required. 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 default is 5.
- session
Initialization Mode This property is required. String - 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 to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. The default is DISABLED.
- min
Receive Interval This property is required. number - 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. The default is 1000.
- min
Transmit Interval This property is required. number - 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. The default is 1000.
- multiplier
This property is required. 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 default is 5.
- session
Initialization Mode This property is required. string - 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 to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. The default is DISABLED.
- min_
receive_ interval This property is required. int - 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. The default is 1000.
- min_
transmit_ interval This property is required. int - 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. The default is 1000.
- multiplier
This property is required. 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 default is 5.
- session_
initialization_ mode This property is required. str - 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 to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. The default is DISABLED.
- min
Receive Interval This property is required. Number - 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. The default is 1000.
- min
Transmit Interval This property is required. Number - 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. The default is 1000.
- multiplier
This property is required. 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 default is 5.
- session
Initialization Mode This property is required. String - 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 to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. The default is DISABLED.
RouterBgpPeerCustomLearnedIpRangeResponse
- Range
This property is required. string - The custom learned route IP address range. Must be a valid CIDR-formatted prefix. If an IP address is provided without a subnet mask, it is interpreted as, for IPv4, a
/32
singular IP address range, and, for IPv6,/128
.
- Range
This property is required. string - The custom learned route IP address range. Must be a valid CIDR-formatted prefix. If an IP address is provided without a subnet mask, it is interpreted as, for IPv4, a
/32
singular IP address range, and, for IPv6,/128
.
- range
This property is required. String - The custom learned route IP address range. Must be a valid CIDR-formatted prefix. If an IP address is provided without a subnet mask, it is interpreted as, for IPv4, a
/32
singular IP address range, and, for IPv6,/128
.
- range
This property is required. string - The custom learned route IP address range. Must be a valid CIDR-formatted prefix. If an IP address is provided without a subnet mask, it is interpreted as, for IPv4, a
/32
singular IP address range, and, for IPv6,/128
.
- range
This property is required. str - The custom learned route IP address range. Must be a valid CIDR-formatted prefix. If an IP address is provided without a subnet mask, it is interpreted as, for IPv4, a
/32
singular IP address range, and, for IPv6,/128
.
- range
This property is required. String - The custom learned route IP address range. Must be a valid CIDR-formatted prefix. If an IP address is provided without a subnet mask, it is interpreted as, for IPv4, a
/32
singular IP address range, and, for IPv6,/128
.
RouterBgpPeerResponse
- Advertise
Mode This property is required. string - User-specified flag to indicate which mode to use for advertisement.
- Advertised
Groups This property is required. 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 advertise_mode 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 Ranges This property is required. List<Pulumi.Google Native. Compute. Beta. Inputs. Router Advertised Ip Range Response> - User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the "bgp" message). These IP ranges are advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges.
- Advertised
Route Priority This property is required. int - 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
This property is required. Pulumi.Google Native. Compute. Beta. Inputs. Router Bgp Peer Bfd Response - BFD configuration for the BGP peering.
- Custom
Learned Ip Ranges This property is required. List<Pulumi.Google Native. Compute. Beta. Inputs. Router Bgp Peer Custom Learned Ip Range Response> - A list of user-defined custom learned route IP address ranges for a BGP session.
- Custom
Learned Route Priority This property is required. int - The user-defined custom learned route priority for a BGP session. This value is applied to all custom learned route ranges for the session. You can choose a value from
0
to65335
. If you don't provide a value, Google Cloud assigns a priority of100
to the ranges. - Enable
This property is required. string - 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 This property is required. bool - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- Enable
Ipv6 This property is required. bool - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- Interface
Name This property is required. string - Name of the interface the BGP peer is associated with.
- Ip
Address This property is required. string - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- Ipv4Nexthop
Address This property is required. string - IPv4 address of the interface inside Google Cloud Platform.
- Ipv6Nexthop
Address This property is required. string - IPv6 address of the interface inside Google Cloud Platform.
- Management
Type This property is required. 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 users - MANAGED_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 Name This property is required. string - Present if MD5 authentication is enabled for the peering. Must be the name of one of the entries in the Router.md5_authentication_keys. The field must comply with RFC1035.
- Name
This property is required. 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]([-a-z0-9]*[a-z0-9])?
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 This property is required. int - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- Peer
Ip Address This property is required. string - IP address of the BGP interface outside Google Cloud Platform. Only IPv4 is supported.
- Peer
Ipv4Nexthop Address This property is required. string - IPv4 address of the BGP interface outside Google Cloud Platform.
- Peer
Ipv6Nexthop Address This property is required. string - IPv6 address of the BGP interface outside Google Cloud Platform.
- Router
Appliance Instance This property is required. string - 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 This property is required. string - User-specified flag to indicate which mode to use for advertisement.
- Advertised
Groups This property is required. []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 advertise_mode 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 Ranges This property is required. []RouterAdvertised Ip Range Response - User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the "bgp" message). These IP ranges are advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges.
- Advertised
Route Priority This property is required. int - 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
This property is required. RouterBgp Peer Bfd Response - BFD configuration for the BGP peering.
- Custom
Learned Ip Ranges This property is required. []RouterBgp Peer Custom Learned Ip Range Response - A list of user-defined custom learned route IP address ranges for a BGP session.
- Custom
Learned Route Priority This property is required. int - The user-defined custom learned route priority for a BGP session. This value is applied to all custom learned route ranges for the session. You can choose a value from
0
to65335
. If you don't provide a value, Google Cloud assigns a priority of100
to the ranges. - Enable
This property is required. string - 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 This property is required. bool - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- Enable
Ipv6 This property is required. bool - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- Interface
Name This property is required. string - Name of the interface the BGP peer is associated with.
- Ip
Address This property is required. string - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- Ipv4Nexthop
Address This property is required. string - IPv4 address of the interface inside Google Cloud Platform.
- Ipv6Nexthop
Address This property is required. string - IPv6 address of the interface inside Google Cloud Platform.
- Management
Type This property is required. 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 users - MANAGED_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 Name This property is required. string - Present if MD5 authentication is enabled for the peering. Must be the name of one of the entries in the Router.md5_authentication_keys. The field must comply with RFC1035.
- Name
This property is required. 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]([-a-z0-9]*[a-z0-9])?
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 This property is required. int - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- Peer
Ip Address This property is required. string - IP address of the BGP interface outside Google Cloud Platform. Only IPv4 is supported.
- Peer
Ipv4Nexthop Address This property is required. string - IPv4 address of the BGP interface outside Google Cloud Platform.
- Peer
Ipv6Nexthop Address This property is required. string - IPv6 address of the BGP interface outside Google Cloud Platform.
- Router
Appliance Instance This property is required. string - 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 This property is required. String - User-specified flag to indicate which mode to use for advertisement.
- advertised
Groups This property is required. 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 advertise_mode 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 Ranges This property is required. List<RouterAdvertised Ip Range Response> - User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the "bgp" message). These IP ranges are advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges.
- advertised
Route Priority This property is required. Integer - 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
This property is required. RouterBgp Peer Bfd Response - BFD configuration for the BGP peering.
- custom
Learned Ip Ranges This property is required. List<RouterBgp Peer Custom Learned Ip Range Response> - A list of user-defined custom learned route IP address ranges for a BGP session.
- custom
Learned Route Priority This property is required. Integer - The user-defined custom learned route priority for a BGP session. This value is applied to all custom learned route ranges for the session. You can choose a value from
0
to65335
. If you don't provide a value, Google Cloud assigns a priority of100
to the ranges. - enable
This property is required. String - 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 This property is required. Boolean - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- enable
Ipv6 This property is required. Boolean - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- interface
Name This property is required. String - Name of the interface the BGP peer is associated with.
- ip
Address This property is required. String - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- ipv4Nexthop
Address This property is required. String - IPv4 address of the interface inside Google Cloud Platform.
- ipv6Nexthop
Address This property is required. String - IPv6 address of the interface inside Google Cloud Platform.
- management
Type This property is required. 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 users - MANAGED_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 Name This property is required. String - Present if MD5 authentication is enabled for the peering. Must be the name of one of the entries in the Router.md5_authentication_keys. The field must comply with RFC1035.
- name
This property is required. 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]([-a-z0-9]*[a-z0-9])?
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 This property is required. Integer - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- peer
Ip Address This property is required. String - IP address of the BGP interface outside Google Cloud Platform. Only IPv4 is supported.
- peer
Ipv4Nexthop Address This property is required. String - IPv4 address of the BGP interface outside Google Cloud Platform.
- peer
Ipv6Nexthop Address This property is required. String - IPv6 address of the BGP interface outside Google Cloud Platform.
- router
Appliance Instance This property is required. String - 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 This property is required. string - User-specified flag to indicate which mode to use for advertisement.
- advertised
Groups This property is required. 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 advertise_mode 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 Ranges This property is required. RouterAdvertised Ip Range Response[] - User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the "bgp" message). These IP ranges are advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges.
- advertised
Route Priority This property is required. number - 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
This property is required. RouterBgp Peer Bfd Response - BFD configuration for the BGP peering.
- custom
Learned Ip Ranges This property is required. RouterBgp Peer Custom Learned Ip Range Response[] - A list of user-defined custom learned route IP address ranges for a BGP session.
- custom
Learned Route Priority This property is required. number - The user-defined custom learned route priority for a BGP session. This value is applied to all custom learned route ranges for the session. You can choose a value from
0
to65335
. If you don't provide a value, Google Cloud assigns a priority of100
to the ranges. - enable
This property is required. string - 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 This property is required. boolean - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- enable
Ipv6 This property is required. boolean - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- interface
Name This property is required. string - Name of the interface the BGP peer is associated with.
- ip
Address This property is required. string - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- ipv4Nexthop
Address This property is required. string - IPv4 address of the interface inside Google Cloud Platform.
- ipv6Nexthop
Address This property is required. string - IPv6 address of the interface inside Google Cloud Platform.
- management
Type This property is required. 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 users - MANAGED_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 Name This property is required. string - Present if MD5 authentication is enabled for the peering. Must be the name of one of the entries in the Router.md5_authentication_keys. The field must comply with RFC1035.
- name
This property is required. 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]([-a-z0-9]*[a-z0-9])?
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 This property is required. number - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- peer
Ip Address This property is required. string - IP address of the BGP interface outside Google Cloud Platform. Only IPv4 is supported.
- peer
Ipv4Nexthop Address This property is required. string - IPv4 address of the BGP interface outside Google Cloud Platform.
- peer
Ipv6Nexthop Address This property is required. string - IPv6 address of the BGP interface outside Google Cloud Platform.
- router
Appliance Instance This property is required. string - 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 This property is required. str - User-specified flag to indicate which mode to use for advertisement.
- advertised_
groups This property is required. 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 advertise_mode 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_ ranges This property is required. Sequence[RouterAdvertised Ip Range Response] - User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the "bgp" message). These IP ranges are advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges.
- advertised_
route_ priority This property is required. int - 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
This property is required. RouterBgp Peer Bfd Response - BFD configuration for the BGP peering.
- custom_
learned_ ip_ ranges This property is required. Sequence[RouterBgp Peer Custom Learned Ip Range Response] - A list of user-defined custom learned route IP address ranges for a BGP session.
- custom_
learned_ route_ priority This property is required. int - The user-defined custom learned route priority for a BGP session. This value is applied to all custom learned route ranges for the session. You can choose a value from
0
to65335
. If you don't provide a value, Google Cloud assigns a priority of100
to the ranges. - enable
This property is required. str - 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 This property is required. bool - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- enable_
ipv6 This property is required. bool - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- interface_
name This property is required. str - Name of the interface the BGP peer is associated with.
- ip_
address This property is required. str - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- ipv4_
nexthop_ address This property is required. str - IPv4 address of the interface inside Google Cloud Platform.
- ipv6_
nexthop_ address This property is required. str - IPv6 address of the interface inside Google Cloud Platform.
- management_
type This property is required. 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 users - MANAGED_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_ key_ name This property is required. str - Present if MD5 authentication is enabled for the peering. Must be the name of one of the entries in the Router.md5_authentication_keys. The field must comply with RFC1035.
- name
This property is required. 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]([-a-z0-9]*[a-z0-9])?
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 This property is required. int - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- peer_
ip_ address This property is required. str - IP address of the BGP interface outside Google Cloud Platform. Only IPv4 is supported.
- peer_
ipv4_ nexthop_ address This property is required. str - IPv4 address of the BGP interface outside Google Cloud Platform.
- peer_
ipv6_ nexthop_ address This property is required. str - IPv6 address of the BGP interface outside Google Cloud Platform.
- router_
appliance_ instance This property is required. str - 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 This property is required. String - User-specified flag to indicate which mode to use for advertisement.
- advertised
Groups This property is required. 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 advertise_mode 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 Ranges This property is required. List<Property Map> - User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the "bgp" message). These IP ranges are advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges.
- advertised
Route Priority This property is required. Number - 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
This property is required. Property Map - BFD configuration for the BGP peering.
- custom
Learned Ip Ranges This property is required. List<Property Map> - A list of user-defined custom learned route IP address ranges for a BGP session.
- custom
Learned Route Priority This property is required. Number - The user-defined custom learned route priority for a BGP session. This value is applied to all custom learned route ranges for the session. You can choose a value from
0
to65335
. If you don't provide a value, Google Cloud assigns a priority of100
to the ranges. - enable
This property is required. String - 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 This property is required. Boolean - Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.
- enable
Ipv6 This property is required. Boolean - Enable IPv6 traffic over BGP Peer. If not specified, it is disabled by default.
- interface
Name This property is required. String - Name of the interface the BGP peer is associated with.
- ip
Address This property is required. String - IP address of the interface inside Google Cloud Platform. Only IPv4 is supported.
- ipv4Nexthop
Address This property is required. String - IPv4 address of the interface inside Google Cloud Platform.
- ipv6Nexthop
Address This property is required. String - IPv6 address of the interface inside Google Cloud Platform.
- management
Type This property is required. 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 users - MANAGED_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 Name This property is required. String - Present if MD5 authentication is enabled for the peering. Must be the name of one of the entries in the Router.md5_authentication_keys. The field must comply with RFC1035.
- name
This property is required. 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]([-a-z0-9]*[a-z0-9])?
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 This property is required. Number - Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.
- peer
Ip Address This property is required. String - IP address of the BGP interface outside Google Cloud Platform. Only IPv4 is supported.
- peer
Ipv4Nexthop Address This property is required. String - IPv4 address of the BGP interface outside Google Cloud Platform.
- peer
Ipv6Nexthop Address This property is required. String - IPv6 address of the BGP interface outside Google Cloud Platform.
- router
Appliance Instance This property is required. String - 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.
RouterBgpResponse
- Advertise
Mode This property is required. string - User-specified flag to indicate which mode to use for advertisement. The options are DEFAULT or CUSTOM.
- Advertised
Groups This property is required. List<string> - User-specified list of prefix groups to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These groups will be advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.
- Advertised
Ip Ranges This property is required. List<Pulumi.Google Native. Compute. Beta. Inputs. Router Advertised Ip Range Response> - User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode 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.
- Asn
This property is required. int - Local BGP Autonomous System Number (ASN). Must be an RFC6996 private ASN, either 16-bit or 32-bit. The value will be fixed for this router resource. All VPN tunnels that link to this router will have the same local ASN.
- Identifier
Range This property is required. string - Explicitly specifies a range of valid BGP Identifiers for this Router. It is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at least /30, even if the BGP sessions are over IPv6. It must not overlap with any IPv4 BGP session ranges. Other vendors commonly call this "router ID".
- Keepalive
Interval This property is required. int - The interval in seconds between BGP keepalive messages that are sent to the peer. Hold time is three times the interval at which keepalive messages are sent, and the hold time is the maximum number of seconds allowed to elapse between successive keepalive messages that BGP receives from a peer. BGP will use the smaller of either the local hold time value or the peer's hold time value as the hold time for the BGP connection between the two peers. If set, this value must be between 20 and 60. The default is 20.
- Advertise
Mode This property is required. string - User-specified flag to indicate which mode to use for advertisement. The options are DEFAULT or CUSTOM.
- Advertised
Groups This property is required. []string - User-specified list of prefix groups to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These groups will be advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.
- Advertised
Ip Ranges This property is required. []RouterAdvertised Ip Range Response - User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode 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.
- Asn
This property is required. int - Local BGP Autonomous System Number (ASN). Must be an RFC6996 private ASN, either 16-bit or 32-bit. The value will be fixed for this router resource. All VPN tunnels that link to this router will have the same local ASN.
- Identifier
Range This property is required. string - Explicitly specifies a range of valid BGP Identifiers for this Router. It is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at least /30, even if the BGP sessions are over IPv6. It must not overlap with any IPv4 BGP session ranges. Other vendors commonly call this "router ID".
- Keepalive
Interval This property is required. int - The interval in seconds between BGP keepalive messages that are sent to the peer. Hold time is three times the interval at which keepalive messages are sent, and the hold time is the maximum number of seconds allowed to elapse between successive keepalive messages that BGP receives from a peer. BGP will use the smaller of either the local hold time value or the peer's hold time value as the hold time for the BGP connection between the two peers. If set, this value must be between 20 and 60. The default is 20.
- advertise
Mode This property is required. String - User-specified flag to indicate which mode to use for advertisement. The options are DEFAULT or CUSTOM.
- advertised
Groups This property is required. List<String> - User-specified list of prefix groups to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These groups will be advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.
- advertised
Ip Ranges This property is required. List<RouterAdvertised Ip Range Response> - User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode 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.
- asn
This property is required. Integer - Local BGP Autonomous System Number (ASN). Must be an RFC6996 private ASN, either 16-bit or 32-bit. The value will be fixed for this router resource. All VPN tunnels that link to this router will have the same local ASN.
- identifier
Range This property is required. String - Explicitly specifies a range of valid BGP Identifiers for this Router. It is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at least /30, even if the BGP sessions are over IPv6. It must not overlap with any IPv4 BGP session ranges. Other vendors commonly call this "router ID".
- keepalive
Interval This property is required. Integer - The interval in seconds between BGP keepalive messages that are sent to the peer. Hold time is three times the interval at which keepalive messages are sent, and the hold time is the maximum number of seconds allowed to elapse between successive keepalive messages that BGP receives from a peer. BGP will use the smaller of either the local hold time value or the peer's hold time value as the hold time for the BGP connection between the two peers. If set, this value must be between 20 and 60. The default is 20.
- advertise
Mode This property is required. string - User-specified flag to indicate which mode to use for advertisement. The options are DEFAULT or CUSTOM.
- advertised
Groups This property is required. string[] - User-specified list of prefix groups to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These groups will be advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.
- advertised
Ip Ranges This property is required. RouterAdvertised Ip Range Response[] - User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode 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.
- asn
This property is required. number - Local BGP Autonomous System Number (ASN). Must be an RFC6996 private ASN, either 16-bit or 32-bit. The value will be fixed for this router resource. All VPN tunnels that link to this router will have the same local ASN.
- identifier
Range This property is required. string - Explicitly specifies a range of valid BGP Identifiers for this Router. It is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at least /30, even if the BGP sessions are over IPv6. It must not overlap with any IPv4 BGP session ranges. Other vendors commonly call this "router ID".
- keepalive
Interval This property is required. number - The interval in seconds between BGP keepalive messages that are sent to the peer. Hold time is three times the interval at which keepalive messages are sent, and the hold time is the maximum number of seconds allowed to elapse between successive keepalive messages that BGP receives from a peer. BGP will use the smaller of either the local hold time value or the peer's hold time value as the hold time for the BGP connection between the two peers. If set, this value must be between 20 and 60. The default is 20.
- advertise_
mode This property is required. str - User-specified flag to indicate which mode to use for advertisement. The options are DEFAULT or CUSTOM.
- advertised_
groups This property is required. Sequence[str] - User-specified list of prefix groups to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These groups will be advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.
- advertised_
ip_ ranges This property is required. Sequence[RouterAdvertised Ip Range Response] - User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode 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.
- asn
This property is required. int - Local BGP Autonomous System Number (ASN). Must be an RFC6996 private ASN, either 16-bit or 32-bit. The value will be fixed for this router resource. All VPN tunnels that link to this router will have the same local ASN.
- identifier_
range This property is required. str - Explicitly specifies a range of valid BGP Identifiers for this Router. It is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at least /30, even if the BGP sessions are over IPv6. It must not overlap with any IPv4 BGP session ranges. Other vendors commonly call this "router ID".
- keepalive_
interval This property is required. int - The interval in seconds between BGP keepalive messages that are sent to the peer. Hold time is three times the interval at which keepalive messages are sent, and the hold time is the maximum number of seconds allowed to elapse between successive keepalive messages that BGP receives from a peer. BGP will use the smaller of either the local hold time value or the peer's hold time value as the hold time for the BGP connection between the two peers. If set, this value must be between 20 and 60. The default is 20.
- advertise
Mode This property is required. String - User-specified flag to indicate which mode to use for advertisement. The options are DEFAULT or CUSTOM.
- advertised
Groups This property is required. List<String> - User-specified list of prefix groups to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These groups will be advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.
- advertised
Ip Ranges This property is required. List<Property Map> - User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode 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.
- asn
This property is required. Number - Local BGP Autonomous System Number (ASN). Must be an RFC6996 private ASN, either 16-bit or 32-bit. The value will be fixed for this router resource. All VPN tunnels that link to this router will have the same local ASN.
- identifier
Range This property is required. String - Explicitly specifies a range of valid BGP Identifiers for this Router. It is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at least /30, even if the BGP sessions are over IPv6. It must not overlap with any IPv4 BGP session ranges. Other vendors commonly call this "router ID".
- keepalive
Interval This property is required. Number - The interval in seconds between BGP keepalive messages that are sent to the peer. Hold time is three times the interval at which keepalive messages are sent, and the hold time is the maximum number of seconds allowed to elapse between successive keepalive messages that BGP receives from a peer. BGP will use the smaller of either the local hold time value or the peer's hold time value as the hold time for the BGP connection between the two peers. If set, this value must be between 20 and 60. The default is 20.
RouterInterfaceResponse
- Ip
Range This property is required. string - IP address and range of the interface. The IP range must be in the RFC3927 link-local IP address space. The value must be a CIDR-formatted string, for example: 169.254.0.1/30. NOTE: Do not truncate the address as it represents the IP address of the interface.
- Ip
Version This property is required. string - IP version of this interface.
- Linked
Interconnect Attachment This property is required. string - URI of the linked Interconnect attachment. It must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork.
- Linked
Vpn Tunnel This property is required. string - URI of the linked VPN tunnel, which must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork.
- Management
Type This property is required. string - The resource that configures and manages this interface. - MANAGED_BY_USER is the default value and can be managed directly by users. - MANAGED_BY_ATTACHMENT is an interface that is configured and managed by Cloud Interconnect, specifically, by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of interface when the PARTNER InterconnectAttachment is created, updated, or deleted.
- Name
This property is required. string - Name of this interface entry. 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]([-a-z0-9]*[a-z0-9])?
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. - Private
Ip Address This property is required. string - The regional private internal IP address that is used to establish BGP sessions to a VM instance acting as a third-party Router Appliance, such as a Next Gen Firewall, a Virtual Router, or an SD-WAN VM.
- Redundant
Interface This property is required. string - Name of the interface that will be redundant with the current interface you are creating. The redundantInterface must belong to the same Cloud Router as the interface here. To establish the BGP session to a Router Appliance VM, you must create two BGP peers. The two BGP peers must be attached to two separate interfaces that are redundant with each other. The redundant_interface must be 1-63 characters long, and comply with RFC1035. Specifically, the redundant_interface must be 1-63 characters long and match the regular expression
[a-z]([-a-z0-9]*[a-z0-9])?
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. - Subnetwork
This property is required. string - The URI of the subnetwork resource that this interface belongs to, which must be in the same region as the Cloud Router. When you establish a BGP session to a VM instance using this interface, the VM instance must belong to the same subnetwork as the subnetwork specified here.
- Ip
Range This property is required. string - IP address and range of the interface. The IP range must be in the RFC3927 link-local IP address space. The value must be a CIDR-formatted string, for example: 169.254.0.1/30. NOTE: Do not truncate the address as it represents the IP address of the interface.
- Ip
Version This property is required. string - IP version of this interface.
- Linked
Interconnect Attachment This property is required. string - URI of the linked Interconnect attachment. It must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork.
- Linked
Vpn Tunnel This property is required. string - URI of the linked VPN tunnel, which must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork.
- Management
Type This property is required. string - The resource that configures and manages this interface. - MANAGED_BY_USER is the default value and can be managed directly by users. - MANAGED_BY_ATTACHMENT is an interface that is configured and managed by Cloud Interconnect, specifically, by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of interface when the PARTNER InterconnectAttachment is created, updated, or deleted.
- Name
This property is required. string - Name of this interface entry. 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]([-a-z0-9]*[a-z0-9])?
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. - Private
Ip Address This property is required. string - The regional private internal IP address that is used to establish BGP sessions to a VM instance acting as a third-party Router Appliance, such as a Next Gen Firewall, a Virtual Router, or an SD-WAN VM.
- Redundant
Interface This property is required. string - Name of the interface that will be redundant with the current interface you are creating. The redundantInterface must belong to the same Cloud Router as the interface here. To establish the BGP session to a Router Appliance VM, you must create two BGP peers. The two BGP peers must be attached to two separate interfaces that are redundant with each other. The redundant_interface must be 1-63 characters long, and comply with RFC1035. Specifically, the redundant_interface must be 1-63 characters long and match the regular expression
[a-z]([-a-z0-9]*[a-z0-9])?
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. - Subnetwork
This property is required. string - The URI of the subnetwork resource that this interface belongs to, which must be in the same region as the Cloud Router. When you establish a BGP session to a VM instance using this interface, the VM instance must belong to the same subnetwork as the subnetwork specified here.
- ip
Range This property is required. String - IP address and range of the interface. The IP range must be in the RFC3927 link-local IP address space. The value must be a CIDR-formatted string, for example: 169.254.0.1/30. NOTE: Do not truncate the address as it represents the IP address of the interface.
- ip
Version This property is required. String - IP version of this interface.
- linked
Interconnect Attachment This property is required. String - URI of the linked Interconnect attachment. It must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork.
- linked
Vpn Tunnel This property is required. String - URI of the linked VPN tunnel, which must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork.
- management
Type This property is required. String - The resource that configures and manages this interface. - MANAGED_BY_USER is the default value and can be managed directly by users. - MANAGED_BY_ATTACHMENT is an interface that is configured and managed by Cloud Interconnect, specifically, by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of interface when the PARTNER InterconnectAttachment is created, updated, or deleted.
- name
This property is required. String - Name of this interface entry. 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]([-a-z0-9]*[a-z0-9])?
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. - private
Ip Address This property is required. String - The regional private internal IP address that is used to establish BGP sessions to a VM instance acting as a third-party Router Appliance, such as a Next Gen Firewall, a Virtual Router, or an SD-WAN VM.
- redundant
Interface This property is required. String - Name of the interface that will be redundant with the current interface you are creating. The redundantInterface must belong to the same Cloud Router as the interface here. To establish the BGP session to a Router Appliance VM, you must create two BGP peers. The two BGP peers must be attached to two separate interfaces that are redundant with each other. The redundant_interface must be 1-63 characters long, and comply with RFC1035. Specifically, the redundant_interface must be 1-63 characters long and match the regular expression
[a-z]([-a-z0-9]*[a-z0-9])?
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. - subnetwork
This property is required. String - The URI of the subnetwork resource that this interface belongs to, which must be in the same region as the Cloud Router. When you establish a BGP session to a VM instance using this interface, the VM instance must belong to the same subnetwork as the subnetwork specified here.
- ip
Range This property is required. string - IP address and range of the interface. The IP range must be in the RFC3927 link-local IP address space. The value must be a CIDR-formatted string, for example: 169.254.0.1/30. NOTE: Do not truncate the address as it represents the IP address of the interface.
- ip
Version This property is required. string - IP version of this interface.
- linked
Interconnect Attachment This property is required. string - URI of the linked Interconnect attachment. It must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork.
- linked
Vpn Tunnel This property is required. string - URI of the linked VPN tunnel, which must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork.
- management
Type This property is required. string - The resource that configures and manages this interface. - MANAGED_BY_USER is the default value and can be managed directly by users. - MANAGED_BY_ATTACHMENT is an interface that is configured and managed by Cloud Interconnect, specifically, by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of interface when the PARTNER InterconnectAttachment is created, updated, or deleted.
- name
This property is required. string - Name of this interface entry. 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]([-a-z0-9]*[a-z0-9])?
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. - private
Ip Address This property is required. string - The regional private internal IP address that is used to establish BGP sessions to a VM instance acting as a third-party Router Appliance, such as a Next Gen Firewall, a Virtual Router, or an SD-WAN VM.
- redundant
Interface This property is required. string - Name of the interface that will be redundant with the current interface you are creating. The redundantInterface must belong to the same Cloud Router as the interface here. To establish the BGP session to a Router Appliance VM, you must create two BGP peers. The two BGP peers must be attached to two separate interfaces that are redundant with each other. The redundant_interface must be 1-63 characters long, and comply with RFC1035. Specifically, the redundant_interface must be 1-63 characters long and match the regular expression
[a-z]([-a-z0-9]*[a-z0-9])?
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. - subnetwork
This property is required. string - The URI of the subnetwork resource that this interface belongs to, which must be in the same region as the Cloud Router. When you establish a BGP session to a VM instance using this interface, the VM instance must belong to the same subnetwork as the subnetwork specified here.
- ip_
range This property is required. str - IP address and range of the interface. The IP range must be in the RFC3927 link-local IP address space. The value must be a CIDR-formatted string, for example: 169.254.0.1/30. NOTE: Do not truncate the address as it represents the IP address of the interface.
- ip_
version This property is required. str - IP version of this interface.
- linked_
interconnect_ attachment This property is required. str - URI of the linked Interconnect attachment. It must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork.
- linked_
vpn_ tunnel This property is required. str - URI of the linked VPN tunnel, which must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork.
- management_
type This property is required. str - The resource that configures and manages this interface. - MANAGED_BY_USER is the default value and can be managed directly by users. - MANAGED_BY_ATTACHMENT is an interface that is configured and managed by Cloud Interconnect, specifically, by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of interface when the PARTNER InterconnectAttachment is created, updated, or deleted.
- name
This property is required. str - Name of this interface entry. 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]([-a-z0-9]*[a-z0-9])?
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. - private_
ip_ address This property is required. str - The regional private internal IP address that is used to establish BGP sessions to a VM instance acting as a third-party Router Appliance, such as a Next Gen Firewall, a Virtual Router, or an SD-WAN VM.
- redundant_
interface This property is required. str - Name of the interface that will be redundant with the current interface you are creating. The redundantInterface must belong to the same Cloud Router as the interface here. To establish the BGP session to a Router Appliance VM, you must create two BGP peers. The two BGP peers must be attached to two separate interfaces that are redundant with each other. The redundant_interface must be 1-63 characters long, and comply with RFC1035. Specifically, the redundant_interface must be 1-63 characters long and match the regular expression
[a-z]([-a-z0-9]*[a-z0-9])?
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. - subnetwork
This property is required. str - The URI of the subnetwork resource that this interface belongs to, which must be in the same region as the Cloud Router. When you establish a BGP session to a VM instance using this interface, the VM instance must belong to the same subnetwork as the subnetwork specified here.
- ip
Range This property is required. String - IP address and range of the interface. The IP range must be in the RFC3927 link-local IP address space. The value must be a CIDR-formatted string, for example: 169.254.0.1/30. NOTE: Do not truncate the address as it represents the IP address of the interface.
- ip
Version This property is required. String - IP version of this interface.
- linked
Interconnect Attachment This property is required. String - URI of the linked Interconnect attachment. It must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork.
- linked
Vpn Tunnel This property is required. String - URI of the linked VPN tunnel, which must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork.
- management
Type This property is required. String - The resource that configures and manages this interface. - MANAGED_BY_USER is the default value and can be managed directly by users. - MANAGED_BY_ATTACHMENT is an interface that is configured and managed by Cloud Interconnect, specifically, by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of interface when the PARTNER InterconnectAttachment is created, updated, or deleted.
- name
This property is required. String - Name of this interface entry. 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]([-a-z0-9]*[a-z0-9])?
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. - private
Ip Address This property is required. String - The regional private internal IP address that is used to establish BGP sessions to a VM instance acting as a third-party Router Appliance, such as a Next Gen Firewall, a Virtual Router, or an SD-WAN VM.
- redundant
Interface This property is required. String - Name of the interface that will be redundant with the current interface you are creating. The redundantInterface must belong to the same Cloud Router as the interface here. To establish the BGP session to a Router Appliance VM, you must create two BGP peers. The two BGP peers must be attached to two separate interfaces that are redundant with each other. The redundant_interface must be 1-63 characters long, and comply with RFC1035. Specifically, the redundant_interface must be 1-63 characters long and match the regular expression
[a-z]([-a-z0-9]*[a-z0-9])?
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. - subnetwork
This property is required. String - The URI of the subnetwork resource that this interface belongs to, which must be in the same region as the Cloud Router. When you establish a BGP session to a VM instance using this interface, the VM instance must belong to the same subnetwork as the subnetwork specified here.
RouterMd5AuthenticationKeyResponse
- Key
This property is required. string - [Input only] Value of the key. For patch and update calls, it can be skipped to copy the value from the previous configuration. This is allowed if the key with the same name existed before the operation. Maximum length is 80 characters. Can only contain printable ASCII characters.
- Name
This property is required. string - Name used to identify the key. Must be unique within a router. Must be referenced by exactly one bgpPeer. Must comply with RFC1035.
- Key
This property is required. string - [Input only] Value of the key. For patch and update calls, it can be skipped to copy the value from the previous configuration. This is allowed if the key with the same name existed before the operation. Maximum length is 80 characters. Can only contain printable ASCII characters.
- Name
This property is required. string - Name used to identify the key. Must be unique within a router. Must be referenced by exactly one bgpPeer. Must comply with RFC1035.
- key
This property is required. String - [Input only] Value of the key. For patch and update calls, it can be skipped to copy the value from the previous configuration. This is allowed if the key with the same name existed before the operation. Maximum length is 80 characters. Can only contain printable ASCII characters.
- name
This property is required. String - Name used to identify the key. Must be unique within a router. Must be referenced by exactly one bgpPeer. Must comply with RFC1035.
- key
This property is required. string - [Input only] Value of the key. For patch and update calls, it can be skipped to copy the value from the previous configuration. This is allowed if the key with the same name existed before the operation. Maximum length is 80 characters. Can only contain printable ASCII characters.
- name
This property is required. string - Name used to identify the key. Must be unique within a router. Must be referenced by exactly one bgpPeer. Must comply with RFC1035.
- key
This property is required. str - [Input only] Value of the key. For patch and update calls, it can be skipped to copy the value from the previous configuration. This is allowed if the key with the same name existed before the operation. Maximum length is 80 characters. Can only contain printable ASCII characters.
- name
This property is required. str - Name used to identify the key. Must be unique within a router. Must be referenced by exactly one bgpPeer. Must comply with RFC1035.
- key
This property is required. String - [Input only] Value of the key. For patch and update calls, it can be skipped to copy the value from the previous configuration. This is allowed if the key with the same name existed before the operation. Maximum length is 80 characters. Can only contain printable ASCII characters.
- name
This property is required. String - Name used to identify the key. Must be unique within a router. Must be referenced by exactly one bgpPeer. Must comply with RFC1035.
RouterNatLogConfigResponse
- Enable
This property is required. bool - Indicates whether or not to export logs. This is false by default.
- Filter
This property is required. string - Specify the desired filtering of logs on this NAT. If unspecified, logs are exported for all connections handled by this NAT. This option can take one of the following values: - ERRORS_ONLY: Export logs only for connection failures. - TRANSLATIONS_ONLY: Export logs only for successful connections. - ALL: Export logs for all connections, successful and unsuccessful.
- Enable
This property is required. bool - Indicates whether or not to export logs. This is false by default.
- Filter
This property is required. string - Specify the desired filtering of logs on this NAT. If unspecified, logs are exported for all connections handled by this NAT. This option can take one of the following values: - ERRORS_ONLY: Export logs only for connection failures. - TRANSLATIONS_ONLY: Export logs only for successful connections. - ALL: Export logs for all connections, successful and unsuccessful.
- enable
This property is required. Boolean - Indicates whether or not to export logs. This is false by default.
- filter
This property is required. String - Specify the desired filtering of logs on this NAT. If unspecified, logs are exported for all connections handled by this NAT. This option can take one of the following values: - ERRORS_ONLY: Export logs only for connection failures. - TRANSLATIONS_ONLY: Export logs only for successful connections. - ALL: Export logs for all connections, successful and unsuccessful.
- enable
This property is required. boolean - Indicates whether or not to export logs. This is false by default.
- filter
This property is required. string - Specify the desired filtering of logs on this NAT. If unspecified, logs are exported for all connections handled by this NAT. This option can take one of the following values: - ERRORS_ONLY: Export logs only for connection failures. - TRANSLATIONS_ONLY: Export logs only for successful connections. - ALL: Export logs for all connections, successful and unsuccessful.
- enable
This property is required. bool - Indicates whether or not to export logs. This is false by default.
- filter
This property is required. str - Specify the desired filtering of logs on this NAT. If unspecified, logs are exported for all connections handled by this NAT. This option can take one of the following values: - ERRORS_ONLY: Export logs only for connection failures. - TRANSLATIONS_ONLY: Export logs only for successful connections. - ALL: Export logs for all connections, successful and unsuccessful.
- enable
This property is required. Boolean - Indicates whether or not to export logs. This is false by default.
- filter
This property is required. String - Specify the desired filtering of logs on this NAT. If unspecified, logs are exported for all connections handled by this NAT. This option can take one of the following values: - ERRORS_ONLY: Export logs only for connection failures. - TRANSLATIONS_ONLY: Export logs only for successful connections. - ALL: Export logs for all connections, successful and unsuccessful.
RouterNatResponse
- Auto
Network Tier This property is required. string - The network tier to use when automatically reserving NAT IP addresses. Must be one of: PREMIUM, STANDARD. If not specified, then the current project-level default tier is used.
- Drain
Nat Ips This property is required. List<string> - A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT only.
- Enable
Dynamic Port Allocation This property is required. bool - Enable Dynamic Port Allocation. If not specified, it is disabled by default. If set to true, - Dynamic Port Allocation will be enabled on this NAT config. - enableEndpointIndependentMapping cannot be set to true. - If minPorts is set, minPortsPerVm must be set to a power of two greater than or equal to 32. If minPortsPerVm is not set, a minimum of 32 ports will be allocated to a VM from this NAT config.
- Enable
Endpoint Independent Mapping This property is required. bool - Endpoint
Types This property is required. List<string> - List of NAT-ted endpoint types supported by the Nat Gateway. If the list is empty, then it will be equivalent to include ENDPOINT_TYPE_VM
- Icmp
Idle Timeout Sec This property is required. int - Timeout (in seconds) for ICMP connections. Defaults to 30s if not set.
- Log
Config This property is required. Pulumi.Google Native. Compute. Beta. Inputs. Router Nat Log Config Response - Configure logging on this NAT.
- Max
Ports Per Vm This property is required. int - Maximum number of ports allocated to a VM from this NAT config when Dynamic Port Allocation is enabled. If Dynamic Port Allocation is not enabled, this field has no effect. If Dynamic Port Allocation is enabled, and this field is set, it must be set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm is not set. If Dynamic Port Allocation is enabled and this field is not set, a maximum of 65536 ports will be allocated to a VM from this NAT config.
- Min
Ports Per Vm This property is required. int - Minimum number of ports allocated to a VM from this NAT config. If not set, a default number of ports is allocated to a VM. This is rounded up to the nearest power of 2. For example, if the value of this field is 50, at least 64 ports are allocated to a VM.
- Name
This property is required. string - Unique name of this Nat service. The name must be 1-63 characters long and comply with RFC1035.
- Nat
Ip Allocate Option This property is required. string - Specify the NatIpAllocateOption, which can take one of the following values: - MANUAL_ONLY: Uses only Nat IP addresses provided by customers. When there are not enough specified Nat IPs, the Nat service fails for new VMs. - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should be empty.
- Nat
Ips This property is required. List<string> - A list of URLs of the IP resources used for this Nat service. These IP addresses must be valid static external IP addresses assigned to the project.
- Rules
This property is required. List<Pulumi.Google Native. Compute. Beta. Inputs. Router Nat Rule Response> - A list of rules associated with this NAT.
- Source
Subnetwork Ip Ranges To Nat This property is required. string - Specify the Nat option, which can take one of the following values: - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every Subnetwork are allowed to Nat. - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field subnetwork below) The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there should not be any other Router.Nat section in any Router for this network in this region.
- Subnetworks
This property is required. List<Pulumi.Google Native. Compute. Beta. Inputs. Router Nat Subnetwork To Nat Response> - A list of Subnetwork resources whose traffic should be translated by NAT Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the SubnetworkIpRangeToNatOption above.
- Tcp
Established Idle Timeout Sec This property is required. int - Timeout (in seconds) for TCP established connections. Defaults to 1200s if not set.
- Tcp
Time Wait Timeout Sec This property is required. int - Timeout (in seconds) for TCP connections that are in TIME_WAIT state. Defaults to 120s if not set.
- Tcp
Transitory Idle Timeout Sec This property is required. int - Timeout (in seconds) for TCP transitory connections. Defaults to 30s if not set.
- Type
This property is required. string - Indicates whether this NAT is used for public or private IP translation. If unspecified, it defaults to PUBLIC.
- Udp
Idle Timeout Sec This property is required. int - Timeout (in seconds) for UDP connections. Defaults to 30s if not set.
- Auto
Network Tier This property is required. string - The network tier to use when automatically reserving NAT IP addresses. Must be one of: PREMIUM, STANDARD. If not specified, then the current project-level default tier is used.
- Drain
Nat Ips This property is required. []string - A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT only.
- Enable
Dynamic Port Allocation This property is required. bool - Enable Dynamic Port Allocation. If not specified, it is disabled by default. If set to true, - Dynamic Port Allocation will be enabled on this NAT config. - enableEndpointIndependentMapping cannot be set to true. - If minPorts is set, minPortsPerVm must be set to a power of two greater than or equal to 32. If minPortsPerVm is not set, a minimum of 32 ports will be allocated to a VM from this NAT config.
- Enable
Endpoint Independent Mapping This property is required. bool - Endpoint
Types This property is required. []string - List of NAT-ted endpoint types supported by the Nat Gateway. If the list is empty, then it will be equivalent to include ENDPOINT_TYPE_VM
- Icmp
Idle Timeout Sec This property is required. int - Timeout (in seconds) for ICMP connections. Defaults to 30s if not set.
- Log
Config This property is required. RouterNat Log Config Response - Configure logging on this NAT.
- Max
Ports Per Vm This property is required. int - Maximum number of ports allocated to a VM from this NAT config when Dynamic Port Allocation is enabled. If Dynamic Port Allocation is not enabled, this field has no effect. If Dynamic Port Allocation is enabled, and this field is set, it must be set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm is not set. If Dynamic Port Allocation is enabled and this field is not set, a maximum of 65536 ports will be allocated to a VM from this NAT config.
- Min
Ports Per Vm This property is required. int - Minimum number of ports allocated to a VM from this NAT config. If not set, a default number of ports is allocated to a VM. This is rounded up to the nearest power of 2. For example, if the value of this field is 50, at least 64 ports are allocated to a VM.
- Name
This property is required. string - Unique name of this Nat service. The name must be 1-63 characters long and comply with RFC1035.
- Nat
Ip Allocate Option This property is required. string - Specify the NatIpAllocateOption, which can take one of the following values: - MANUAL_ONLY: Uses only Nat IP addresses provided by customers. When there are not enough specified Nat IPs, the Nat service fails for new VMs. - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should be empty.
- Nat
Ips This property is required. []string - A list of URLs of the IP resources used for this Nat service. These IP addresses must be valid static external IP addresses assigned to the project.
- Rules
This property is required. []RouterNat Rule Response - A list of rules associated with this NAT.
- Source
Subnetwork Ip Ranges To Nat This property is required. string - Specify the Nat option, which can take one of the following values: - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every Subnetwork are allowed to Nat. - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field subnetwork below) The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there should not be any other Router.Nat section in any Router for this network in this region.
- Subnetworks
This property is required. []RouterNat Subnetwork To Nat Response - A list of Subnetwork resources whose traffic should be translated by NAT Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the SubnetworkIpRangeToNatOption above.
- Tcp
Established Idle Timeout Sec This property is required. int - Timeout (in seconds) for TCP established connections. Defaults to 1200s if not set.
- Tcp
Time Wait Timeout Sec This property is required. int - Timeout (in seconds) for TCP connections that are in TIME_WAIT state. Defaults to 120s if not set.
- Tcp
Transitory Idle Timeout Sec This property is required. int - Timeout (in seconds) for TCP transitory connections. Defaults to 30s if not set.
- Type
This property is required. string - Indicates whether this NAT is used for public or private IP translation. If unspecified, it defaults to PUBLIC.
- Udp
Idle Timeout Sec This property is required. int - Timeout (in seconds) for UDP connections. Defaults to 30s if not set.
- auto
Network Tier This property is required. String - The network tier to use when automatically reserving NAT IP addresses. Must be one of: PREMIUM, STANDARD. If not specified, then the current project-level default tier is used.
- drain
Nat Ips This property is required. List<String> - A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT only.
- enable
Dynamic Port Allocation This property is required. Boolean - Enable Dynamic Port Allocation. If not specified, it is disabled by default. If set to true, - Dynamic Port Allocation will be enabled on this NAT config. - enableEndpointIndependentMapping cannot be set to true. - If minPorts is set, minPortsPerVm must be set to a power of two greater than or equal to 32. If minPortsPerVm is not set, a minimum of 32 ports will be allocated to a VM from this NAT config.
- enable
Endpoint Independent Mapping This property is required. Boolean - endpoint
Types This property is required. List<String> - List of NAT-ted endpoint types supported by the Nat Gateway. If the list is empty, then it will be equivalent to include ENDPOINT_TYPE_VM
- icmp
Idle Timeout Sec This property is required. Integer - Timeout (in seconds) for ICMP connections. Defaults to 30s if not set.
- log
Config This property is required. RouterNat Log Config Response - Configure logging on this NAT.
- max
Ports Per Vm This property is required. Integer - Maximum number of ports allocated to a VM from this NAT config when Dynamic Port Allocation is enabled. If Dynamic Port Allocation is not enabled, this field has no effect. If Dynamic Port Allocation is enabled, and this field is set, it must be set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm is not set. If Dynamic Port Allocation is enabled and this field is not set, a maximum of 65536 ports will be allocated to a VM from this NAT config.
- min
Ports Per Vm This property is required. Integer - Minimum number of ports allocated to a VM from this NAT config. If not set, a default number of ports is allocated to a VM. This is rounded up to the nearest power of 2. For example, if the value of this field is 50, at least 64 ports are allocated to a VM.
- name
This property is required. String - Unique name of this Nat service. The name must be 1-63 characters long and comply with RFC1035.
- nat
Ip Allocate Option This property is required. String - Specify the NatIpAllocateOption, which can take one of the following values: - MANUAL_ONLY: Uses only Nat IP addresses provided by customers. When there are not enough specified Nat IPs, the Nat service fails for new VMs. - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should be empty.
- nat
Ips This property is required. List<String> - A list of URLs of the IP resources used for this Nat service. These IP addresses must be valid static external IP addresses assigned to the project.
- rules
This property is required. List<RouterNat Rule Response> - A list of rules associated with this NAT.
- source
Subnetwork Ip Ranges To Nat This property is required. String - Specify the Nat option, which can take one of the following values: - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every Subnetwork are allowed to Nat. - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field subnetwork below) The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there should not be any other Router.Nat section in any Router for this network in this region.
- subnetworks
This property is required. List<RouterNat Subnetwork To Nat Response> - A list of Subnetwork resources whose traffic should be translated by NAT Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the SubnetworkIpRangeToNatOption above.
- tcp
Established Idle Timeout Sec This property is required. Integer - Timeout (in seconds) for TCP established connections. Defaults to 1200s if not set.
- tcp
Time Wait Timeout Sec This property is required. Integer - Timeout (in seconds) for TCP connections that are in TIME_WAIT state. Defaults to 120s if not set.
- tcp
Transitory Idle Timeout Sec This property is required. Integer - Timeout (in seconds) for TCP transitory connections. Defaults to 30s if not set.
- type
This property is required. String - Indicates whether this NAT is used for public or private IP translation. If unspecified, it defaults to PUBLIC.
- udp
Idle Timeout Sec This property is required. Integer - Timeout (in seconds) for UDP connections. Defaults to 30s if not set.
- auto
Network Tier This property is required. string - The network tier to use when automatically reserving NAT IP addresses. Must be one of: PREMIUM, STANDARD. If not specified, then the current project-level default tier is used.
- drain
Nat Ips This property is required. string[] - A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT only.
- enable
Dynamic Port Allocation This property is required. boolean - Enable Dynamic Port Allocation. If not specified, it is disabled by default. If set to true, - Dynamic Port Allocation will be enabled on this NAT config. - enableEndpointIndependentMapping cannot be set to true. - If minPorts is set, minPortsPerVm must be set to a power of two greater than or equal to 32. If minPortsPerVm is not set, a minimum of 32 ports will be allocated to a VM from this NAT config.
- enable
Endpoint Independent Mapping This property is required. boolean - endpoint
Types This property is required. string[] - List of NAT-ted endpoint types supported by the Nat Gateway. If the list is empty, then it will be equivalent to include ENDPOINT_TYPE_VM
- icmp
Idle Timeout Sec This property is required. number - Timeout (in seconds) for ICMP connections. Defaults to 30s if not set.
- log
Config This property is required. RouterNat Log Config Response - Configure logging on this NAT.
- max
Ports Per Vm This property is required. number - Maximum number of ports allocated to a VM from this NAT config when Dynamic Port Allocation is enabled. If Dynamic Port Allocation is not enabled, this field has no effect. If Dynamic Port Allocation is enabled, and this field is set, it must be set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm is not set. If Dynamic Port Allocation is enabled and this field is not set, a maximum of 65536 ports will be allocated to a VM from this NAT config.
- min
Ports Per Vm This property is required. number - Minimum number of ports allocated to a VM from this NAT config. If not set, a default number of ports is allocated to a VM. This is rounded up to the nearest power of 2. For example, if the value of this field is 50, at least 64 ports are allocated to a VM.
- name
This property is required. string - Unique name of this Nat service. The name must be 1-63 characters long and comply with RFC1035.
- nat
Ip Allocate Option This property is required. string - Specify the NatIpAllocateOption, which can take one of the following values: - MANUAL_ONLY: Uses only Nat IP addresses provided by customers. When there are not enough specified Nat IPs, the Nat service fails for new VMs. - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should be empty.
- nat
Ips This property is required. string[] - A list of URLs of the IP resources used for this Nat service. These IP addresses must be valid static external IP addresses assigned to the project.
- rules
This property is required. RouterNat Rule Response[] - A list of rules associated with this NAT.
- source
Subnetwork Ip Ranges To Nat This property is required. string - Specify the Nat option, which can take one of the following values: - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every Subnetwork are allowed to Nat. - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field subnetwork below) The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there should not be any other Router.Nat section in any Router for this network in this region.
- subnetworks
This property is required. RouterNat Subnetwork To Nat Response[] - A list of Subnetwork resources whose traffic should be translated by NAT Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the SubnetworkIpRangeToNatOption above.
- tcp
Established Idle Timeout Sec This property is required. number - Timeout (in seconds) for TCP established connections. Defaults to 1200s if not set.
- tcp
Time Wait Timeout Sec This property is required. number - Timeout (in seconds) for TCP connections that are in TIME_WAIT state. Defaults to 120s if not set.
- tcp
Transitory Idle Timeout Sec This property is required. number - Timeout (in seconds) for TCP transitory connections. Defaults to 30s if not set.
- type
This property is required. string - Indicates whether this NAT is used for public or private IP translation. If unspecified, it defaults to PUBLIC.
- udp
Idle Timeout Sec This property is required. number - Timeout (in seconds) for UDP connections. Defaults to 30s if not set.
- auto_
network_ tier This property is required. str - The network tier to use when automatically reserving NAT IP addresses. Must be one of: PREMIUM, STANDARD. If not specified, then the current project-level default tier is used.
- drain_
nat_ ips This property is required. Sequence[str] - A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT only.
- enable_
dynamic_ port_ allocation This property is required. bool - Enable Dynamic Port Allocation. If not specified, it is disabled by default. If set to true, - Dynamic Port Allocation will be enabled on this NAT config. - enableEndpointIndependentMapping cannot be set to true. - If minPorts is set, minPortsPerVm must be set to a power of two greater than or equal to 32. If minPortsPerVm is not set, a minimum of 32 ports will be allocated to a VM from this NAT config.
- enable_
endpoint_ independent_ mapping This property is required. bool - endpoint_
types This property is required. Sequence[str] - List of NAT-ted endpoint types supported by the Nat Gateway. If the list is empty, then it will be equivalent to include ENDPOINT_TYPE_VM
- icmp_
idle_ timeout_ sec This property is required. int - Timeout (in seconds) for ICMP connections. Defaults to 30s if not set.
- log_
config This property is required. RouterNat Log Config Response - Configure logging on this NAT.
- max_
ports_ per_ vm This property is required. int - Maximum number of ports allocated to a VM from this NAT config when Dynamic Port Allocation is enabled. If Dynamic Port Allocation is not enabled, this field has no effect. If Dynamic Port Allocation is enabled, and this field is set, it must be set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm is not set. If Dynamic Port Allocation is enabled and this field is not set, a maximum of 65536 ports will be allocated to a VM from this NAT config.
- min_
ports_ per_ vm This property is required. int - Minimum number of ports allocated to a VM from this NAT config. If not set, a default number of ports is allocated to a VM. This is rounded up to the nearest power of 2. For example, if the value of this field is 50, at least 64 ports are allocated to a VM.
- name
This property is required. str - Unique name of this Nat service. The name must be 1-63 characters long and comply with RFC1035.
- nat_
ip_ allocate_ option This property is required. str - Specify the NatIpAllocateOption, which can take one of the following values: - MANUAL_ONLY: Uses only Nat IP addresses provided by customers. When there are not enough specified Nat IPs, the Nat service fails for new VMs. - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should be empty.
- nat_
ips This property is required. Sequence[str] - A list of URLs of the IP resources used for this Nat service. These IP addresses must be valid static external IP addresses assigned to the project.
- rules
This property is required. Sequence[RouterNat Rule Response] - A list of rules associated with this NAT.
- source_
subnetwork_ ip_ ranges_ to_ nat This property is required. str - Specify the Nat option, which can take one of the following values: - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every Subnetwork are allowed to Nat. - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field subnetwork below) The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there should not be any other Router.Nat section in any Router for this network in this region.
- subnetworks
This property is required. Sequence[RouterNat Subnetwork To Nat Response] - A list of Subnetwork resources whose traffic should be translated by NAT Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the SubnetworkIpRangeToNatOption above.
- tcp_
established_ idle_ timeout_ sec This property is required. int - Timeout (in seconds) for TCP established connections. Defaults to 1200s if not set.
- tcp_
time_ wait_ timeout_ sec This property is required. int - Timeout (in seconds) for TCP connections that are in TIME_WAIT state. Defaults to 120s if not set.
- tcp_
transitory_ idle_ timeout_ sec This property is required. int - Timeout (in seconds) for TCP transitory connections. Defaults to 30s if not set.
- type
This property is required. str - Indicates whether this NAT is used for public or private IP translation. If unspecified, it defaults to PUBLIC.
- udp_
idle_ timeout_ sec This property is required. int - Timeout (in seconds) for UDP connections. Defaults to 30s if not set.
- auto
Network Tier This property is required. String - The network tier to use when automatically reserving NAT IP addresses. Must be one of: PREMIUM, STANDARD. If not specified, then the current project-level default tier is used.
- drain
Nat Ips This property is required. List<String> - A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT only.
- enable
Dynamic Port Allocation This property is required. Boolean - Enable Dynamic Port Allocation. If not specified, it is disabled by default. If set to true, - Dynamic Port Allocation will be enabled on this NAT config. - enableEndpointIndependentMapping cannot be set to true. - If minPorts is set, minPortsPerVm must be set to a power of two greater than or equal to 32. If minPortsPerVm is not set, a minimum of 32 ports will be allocated to a VM from this NAT config.
- enable
Endpoint Independent Mapping This property is required. Boolean - endpoint
Types This property is required. List<String> - List of NAT-ted endpoint types supported by the Nat Gateway. If the list is empty, then it will be equivalent to include ENDPOINT_TYPE_VM
- icmp
Idle Timeout Sec This property is required. Number - Timeout (in seconds) for ICMP connections. Defaults to 30s if not set.
- log
Config This property is required. Property Map - Configure logging on this NAT.
- max
Ports Per Vm This property is required. Number - Maximum number of ports allocated to a VM from this NAT config when Dynamic Port Allocation is enabled. If Dynamic Port Allocation is not enabled, this field has no effect. If Dynamic Port Allocation is enabled, and this field is set, it must be set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm is not set. If Dynamic Port Allocation is enabled and this field is not set, a maximum of 65536 ports will be allocated to a VM from this NAT config.
- min
Ports Per Vm This property is required. Number - Minimum number of ports allocated to a VM from this NAT config. If not set, a default number of ports is allocated to a VM. This is rounded up to the nearest power of 2. For example, if the value of this field is 50, at least 64 ports are allocated to a VM.
- name
This property is required. String - Unique name of this Nat service. The name must be 1-63 characters long and comply with RFC1035.
- nat
Ip Allocate Option This property is required. String - Specify the NatIpAllocateOption, which can take one of the following values: - MANUAL_ONLY: Uses only Nat IP addresses provided by customers. When there are not enough specified Nat IPs, the Nat service fails for new VMs. - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should be empty.
- nat
Ips This property is required. List<String> - A list of URLs of the IP resources used for this Nat service. These IP addresses must be valid static external IP addresses assigned to the project.
- rules
This property is required. List<Property Map> - A list of rules associated with this NAT.
- source
Subnetwork Ip Ranges To Nat This property is required. String - Specify the Nat option, which can take one of the following values: - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every Subnetwork are allowed to Nat. - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field subnetwork below) The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there should not be any other Router.Nat section in any Router for this network in this region.
- subnetworks
This property is required. List<Property Map> - A list of Subnetwork resources whose traffic should be translated by NAT Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the SubnetworkIpRangeToNatOption above.
- tcp
Established Idle Timeout Sec This property is required. Number - Timeout (in seconds) for TCP established connections. Defaults to 1200s if not set.
- tcp
Time Wait Timeout Sec This property is required. Number - Timeout (in seconds) for TCP connections that are in TIME_WAIT state. Defaults to 120s if not set.
- tcp
Transitory Idle Timeout Sec This property is required. Number - Timeout (in seconds) for TCP transitory connections. Defaults to 30s if not set.
- type
This property is required. String - Indicates whether this NAT is used for public or private IP translation. If unspecified, it defaults to PUBLIC.
- udp
Idle Timeout Sec This property is required. Number - Timeout (in seconds) for UDP connections. Defaults to 30s if not set.
RouterNatRuleActionResponse
- Source
Nat Active Ips This property is required. List<string> - A list of URLs of the IP resources used for this NAT rule. These IP addresses must be valid static external IP addresses assigned to the project. This field is used for public NAT.
- Source
Nat Active Ranges This property is required. List<string> - A list of URLs of the subnetworks used as source ranges for this NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. This field is used for private NAT.
- Source
Nat Drain Ips This property is required. List<string> - A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT rule only. This field is used for public NAT.
- Source
Nat Drain Ranges This property is required. List<string> - A list of URLs of subnetworks representing source ranges to be drained. This is only supported on patch/update, and these subnetworks must have previously been used as active ranges in this NAT Rule. This field is used for private NAT.
- Source
Nat Active Ips This property is required. []string - A list of URLs of the IP resources used for this NAT rule. These IP addresses must be valid static external IP addresses assigned to the project. This field is used for public NAT.
- Source
Nat Active Ranges This property is required. []string - A list of URLs of the subnetworks used as source ranges for this NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. This field is used for private NAT.
- Source
Nat Drain Ips This property is required. []string - A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT rule only. This field is used for public NAT.
- Source
Nat Drain Ranges This property is required. []string - A list of URLs of subnetworks representing source ranges to be drained. This is only supported on patch/update, and these subnetworks must have previously been used as active ranges in this NAT Rule. This field is used for private NAT.
- source
Nat Active Ips This property is required. List<String> - A list of URLs of the IP resources used for this NAT rule. These IP addresses must be valid static external IP addresses assigned to the project. This field is used for public NAT.
- source
Nat Active Ranges This property is required. List<String> - A list of URLs of the subnetworks used as source ranges for this NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. This field is used for private NAT.
- source
Nat Drain Ips This property is required. List<String> - A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT rule only. This field is used for public NAT.
- source
Nat Drain Ranges This property is required. List<String> - A list of URLs of subnetworks representing source ranges to be drained. This is only supported on patch/update, and these subnetworks must have previously been used as active ranges in this NAT Rule. This field is used for private NAT.
- source
Nat Active Ips This property is required. string[] - A list of URLs of the IP resources used for this NAT rule. These IP addresses must be valid static external IP addresses assigned to the project. This field is used for public NAT.
- source
Nat Active Ranges This property is required. string[] - A list of URLs of the subnetworks used as source ranges for this NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. This field is used for private NAT.
- source
Nat Drain Ips This property is required. string[] - A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT rule only. This field is used for public NAT.
- source
Nat Drain Ranges This property is required. string[] - A list of URLs of subnetworks representing source ranges to be drained. This is only supported on patch/update, and these subnetworks must have previously been used as active ranges in this NAT Rule. This field is used for private NAT.
- source_
nat_ active_ ips This property is required. Sequence[str] - A list of URLs of the IP resources used for this NAT rule. These IP addresses must be valid static external IP addresses assigned to the project. This field is used for public NAT.
- source_
nat_ active_ ranges This property is required. Sequence[str] - A list of URLs of the subnetworks used as source ranges for this NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. This field is used for private NAT.
- source_
nat_ drain_ ips This property is required. Sequence[str] - A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT rule only. This field is used for public NAT.
- source_
nat_ drain_ ranges This property is required. Sequence[str] - A list of URLs of subnetworks representing source ranges to be drained. This is only supported on patch/update, and these subnetworks must have previously been used as active ranges in this NAT Rule. This field is used for private NAT.
- source
Nat Active Ips This property is required. List<String> - A list of URLs of the IP resources used for this NAT rule. These IP addresses must be valid static external IP addresses assigned to the project. This field is used for public NAT.
- source
Nat Active Ranges This property is required. List<String> - A list of URLs of the subnetworks used as source ranges for this NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. This field is used for private NAT.
- source
Nat Drain Ips This property is required. List<String> - A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT rule only. This field is used for public NAT.
- source
Nat Drain Ranges This property is required. List<String> - A list of URLs of subnetworks representing source ranges to be drained. This is only supported on patch/update, and these subnetworks must have previously been used as active ranges in this NAT Rule. This field is used for private NAT.
RouterNatRuleResponse
- Action
This property is required. Pulumi.Google Native. Compute. Beta. Inputs. Router Nat Rule Action Response - The action to be enforced for traffic that matches this rule.
- Description
This property is required. string - An optional description of this rule.
- Match
This property is required. string - CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding
action
is enforced. The following examples are valid match expressions for public NAT: "inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')" "destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'" The following example is a valid match expression for private NAT: "nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'" - Rule
Number This property is required. int - An integer uniquely identifying a rule in the list. The rule number must be a positive value between 0 and 65000, and must be unique among rules within a NAT.
- Action
This property is required. RouterNat Rule Action Response - The action to be enforced for traffic that matches this rule.
- Description
This property is required. string - An optional description of this rule.
- Match
This property is required. string - CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding
action
is enforced. The following examples are valid match expressions for public NAT: "inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')" "destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'" The following example is a valid match expression for private NAT: "nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'" - Rule
Number This property is required. int - An integer uniquely identifying a rule in the list. The rule number must be a positive value between 0 and 65000, and must be unique among rules within a NAT.
- action
This property is required. RouterNat Rule Action Response - The action to be enforced for traffic that matches this rule.
- description
This property is required. String - An optional description of this rule.
- match
This property is required. String - CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding
action
is enforced. The following examples are valid match expressions for public NAT: "inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')" "destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'" The following example is a valid match expression for private NAT: "nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'" - rule
Number This property is required. Integer - An integer uniquely identifying a rule in the list. The rule number must be a positive value between 0 and 65000, and must be unique among rules within a NAT.
- action
This property is required. RouterNat Rule Action Response - The action to be enforced for traffic that matches this rule.
- description
This property is required. string - An optional description of this rule.
- match
This property is required. string - CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding
action
is enforced. The following examples are valid match expressions for public NAT: "inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')" "destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'" The following example is a valid match expression for private NAT: "nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'" - rule
Number This property is required. number - An integer uniquely identifying a rule in the list. The rule number must be a positive value between 0 and 65000, and must be unique among rules within a NAT.
- action
This property is required. RouterNat Rule Action Response - The action to be enforced for traffic that matches this rule.
- description
This property is required. str - An optional description of this rule.
- match
This property is required. str - CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding
action
is enforced. The following examples are valid match expressions for public NAT: "inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')" "destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'" The following example is a valid match expression for private NAT: "nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'" - rule_
number This property is required. int - An integer uniquely identifying a rule in the list. The rule number must be a positive value between 0 and 65000, and must be unique among rules within a NAT.
- action
This property is required. Property Map - The action to be enforced for traffic that matches this rule.
- description
This property is required. String - An optional description of this rule.
- match
This property is required. String - CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding
action
is enforced. The following examples are valid match expressions for public NAT: "inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')" "destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'" The following example is a valid match expression for private NAT: "nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'" - rule
Number This property is required. Number - An integer uniquely identifying a rule in the list. The rule number must be a positive value between 0 and 65000, and must be unique among rules within a NAT.
RouterNatSubnetworkToNatResponse
- Name
This property is required. string - URL for the subnetwork resource that will use NAT.
- Secondary
Ip Range Names This property is required. List<string> - A list of the secondary ranges of the Subnetwork that are allowed to use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" is one of the values in source_ip_ranges_to_nat.
- Source
Ip Ranges To Nat This property is required. List<string> - Specify the options for NAT ranges in the Subnetwork. All options of a single value are valid except NAT_IP_RANGE_OPTION_UNSPECIFIED. The only valid option with multiple values is: ["PRIMARY_IP_RANGE", "LIST_OF_SECONDARY_IP_RANGES"] Default: [ALL_IP_RANGES]
- Name
This property is required. string - URL for the subnetwork resource that will use NAT.
- Secondary
Ip Range Names This property is required. []string - A list of the secondary ranges of the Subnetwork that are allowed to use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" is one of the values in source_ip_ranges_to_nat.
- Source
Ip Ranges To Nat This property is required. []string - Specify the options for NAT ranges in the Subnetwork. All options of a single value are valid except NAT_IP_RANGE_OPTION_UNSPECIFIED. The only valid option with multiple values is: ["PRIMARY_IP_RANGE", "LIST_OF_SECONDARY_IP_RANGES"] Default: [ALL_IP_RANGES]
- name
This property is required. String - URL for the subnetwork resource that will use NAT.
- secondary
Ip Range Names This property is required. List<String> - A list of the secondary ranges of the Subnetwork that are allowed to use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" is one of the values in source_ip_ranges_to_nat.
- source
Ip Ranges To Nat This property is required. List<String> - Specify the options for NAT ranges in the Subnetwork. All options of a single value are valid except NAT_IP_RANGE_OPTION_UNSPECIFIED. The only valid option with multiple values is: ["PRIMARY_IP_RANGE", "LIST_OF_SECONDARY_IP_RANGES"] Default: [ALL_IP_RANGES]
- name
This property is required. string - URL for the subnetwork resource that will use NAT.
- secondary
Ip Range Names This property is required. string[] - A list of the secondary ranges of the Subnetwork that are allowed to use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" is one of the values in source_ip_ranges_to_nat.
- source
Ip Ranges To Nat This property is required. string[] - Specify the options for NAT ranges in the Subnetwork. All options of a single value are valid except NAT_IP_RANGE_OPTION_UNSPECIFIED. The only valid option with multiple values is: ["PRIMARY_IP_RANGE", "LIST_OF_SECONDARY_IP_RANGES"] Default: [ALL_IP_RANGES]
- name
This property is required. str - URL for the subnetwork resource that will use NAT.
- secondary_
ip_ range_ names This property is required. Sequence[str] - A list of the secondary ranges of the Subnetwork that are allowed to use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" is one of the values in source_ip_ranges_to_nat.
- source_
ip_ ranges_ to_ nat This property is required. Sequence[str] - Specify the options for NAT ranges in the Subnetwork. All options of a single value are valid except NAT_IP_RANGE_OPTION_UNSPECIFIED. The only valid option with multiple values is: ["PRIMARY_IP_RANGE", "LIST_OF_SECONDARY_IP_RANGES"] Default: [ALL_IP_RANGES]
- name
This property is required. String - URL for the subnetwork resource that will use NAT.
- secondary
Ip Range Names This property is required. List<String> - A list of the secondary ranges of the Subnetwork that are allowed to use NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" is one of the values in source_ip_ranges_to_nat.
- source
Ip Ranges To Nat This property is required. List<String> - Specify the options for NAT ranges in the Subnetwork. All options of a single value are valid except NAT_IP_RANGE_OPTION_UNSPECIFIED. The only valid option with multiple values is: ["PRIMARY_IP_RANGE", "LIST_OF_SECONDARY_IP_RANGES"] Default: [ALL_IP_RANGES]
Package Details
- Repository
- Google Cloud Native pulumi/pulumi-google-native
- License
- Apache-2.0
Google Cloud Native is in preview. Google Cloud Classic is fully supported.
Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi