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.

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

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

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
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,
  "ipv6Cidr": 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.
ipv6Cidr

string

IPv6 address and range of the interface.
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,
  "interfaceIpv6Cidr": string,
  "peerIpv4Cidr": string,
  "peerIpv6Cidr": string,
  "peerAsn": integer,
  "localAsn": 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.
interfaceIpv6Cidr

string

IPv6 range of the interface within Google.
peerIpv4Cidr

string

IP range of the BGP interface outside Google.
peerIpv6Cidr

string

IPv6 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.
localAsn

integer (uint32 format)

Output only. Local BGP Autonomous System Number (ASN). This field is ST_NOT_REQUIRED because it stores private ASNs, which are meaningless outside the zone in which they are being used.

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.