REST Resource: projects.locations.zones.routers

Resource: Router

Message describing Router object

JSON representation
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "description": string,
  "network": string,
  "interface": [
    {
      object (Interface)
    }
  ],
  "bgpPeer": [
    {
      object (BgpPeer)
    }
  ],
  "bgp": {
    object (Bgp)
  },
  "state": enum (ResourceState),
  "routeAdvertisements": [
    string
  ]
}
Fields
name

string

Required. The canonical resource name of the router.

createTime

string (Timestamp format)

Output only. The time when the router was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. The time when the router was last updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

labels

map (key: string, value: string)

Labels associated with this resource.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

description

string

Optional. A free-text description of the resource. Max length 1024 characters.

network

string

Required. The canonical name of the network to which this router belongs. The name is in the form of projects/{project}/locations/{location}/zones/{zone}/networks/{network}.

interface[]

object (Interface)

Router interfaces.

bgpPeer[]

object (BgpPeer)

BGP peers.

bgp

object (Bgp)

BGP information specific to this router.

state

enum (ResourceState)

Output only. Current stage of the resource to the device by config push.

routeAdvertisements[]

string

Optional. A list of CIDRs in IP/Length format to advertise northbound as static routes from this router.

Interface

Router Interface defines the GDCE zone side layer-3 information for building the BGP session.

JSON representation
{
  "name": string,
  "ipv4Cidr": string,
  "linkedInterconnectAttachment": string,
  "subnetwork": string,
  "loopbackIpAddresses": [
    string
  ]
}
Fields
name

string

Name of this interface entry. Unique within the Zones resource.

ipv4Cidr

string

IP address and range of the interface. This value is only used when linkedInterconnectAttachment is set.

linkedInterconnectAttachment

string

The canonical name of the linked Interconnect attachment.

subnetwork

string

The canonical name of the subnetwork resource that this interface belongs to.

loopbackIpAddresses[]

string

Create loopback interface in the router when specified. The number of IP addresses must match the number of TOR devices.

BgpPeer

BGPPeer defines the peer side layer-3 information for building the BGP session.

JSON representation
{
  "name": string,
  "interface": string,
  "interfaceIpv4Cidr": string,
  "peerIpv4Cidr": string,
  "peerAsn": integer
}
Fields
name

string

Name of this BGP peer. Unique within the Zones resource.

interface

string

Name of the RouterInterface the BGP peer is associated with.

interfaceIpv4Cidr

string

IP range of the interface within Google.

peerIpv4Cidr

string

IP range of the BGP interface outside Google.

peerAsn

integer (uint32 format)

Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.

Bgp

BGP information specific to this router.

JSON representation
{
  "asn": integer,
  "keepaliveIntervalInSeconds": integer
}
Fields
asn

integer (uint32 format)

Locally assigned BGP ASN.

keepaliveIntervalInSeconds

integer (uint32 format)

The interval in seconds between BGP keepalive messages that are sent to the peer. Default is 20 with value between 20 and 60.

Methods

create

Creates a new Router in a given project and location.

delete

Deletes a single Router.

diagnose

Get the diagnostics of a single router resource.

get

Gets details of a single Router.

list

Lists Routers in a given project and location.

patch

Updates the parameters of a single Router.