REST Resource: projects.locations.zones.routers

Ressource: Router

Nachricht, die das Router-Objekt beschreibt

JSON-Darstellung
{
  "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
  ]
}
Felder
name

string

Erforderlich. Der kanonische Ressourcenname des Routers.

createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der Router erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der Router zuletzt aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

labels

map (key: string, value: string)

Mit dieser Ressource verknüpfte Labels.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

description

string

Optional. Eine Textbeschreibung der Ressource. Maximale Länge: 1.024 Zeichen.

network

string

Erforderlich. Der kanonische Name des Netzwerks, zu dem dieser Router gehört. Der Name hat das Format projects/{project}/locations/{location}/zones/{zone}/networks/{network}.

interface[]

object (Interface)

Router-Schnittstellen.

bgpPeer[]

object (BgpPeer)

BGP-Peers.

bgp

object (Bgp)

BGP-Informationen, die für diesen Router spezifisch sind.

state

enum (ResourceState)

Nur Ausgabe. Aktuelle Phase der Ressource auf dem Gerät per Konfigurations-Push.

routeAdvertisements[]

string

Optional. Eine Liste von CIDRs im IP/Länge-Format, die von diesem Router als statische Routen nach Norden beworben werden sollen.

Schnittstelle

Die Routerschnittstelle definiert die Layer-3-Informationen auf der GDCE-Zonenseite für den Aufbau der BGP-Sitzung.

JSON-Darstellung
{
  "name": string,
  "ipv4Cidr": string,
  "ipv6Cidr": string,
  "linkedInterconnectAttachment": string,
  "subnetwork": string,
  "loopbackIpAddresses": [
    string
  ]
}
Felder
name

string

Name dieses Schnittstelleneintrags. Eindeutig innerhalb der Ressource „Zones“.

ipv4Cidr

string

IP-Adresse und Bereich der Schnittstelle.

ipv6Cidr

string

IPv6-Adresse und -Bereich der Schnittstelle.

linkedInterconnectAttachment

string

Der kanonische Name des verknüpften Interconnect-Anhang.

subnetwork

string

Der kanonische Name der Subnetzwerkressource, zu der diese Schnittstelle gehört.

loopbackIpAddresses[]

string

Erstellen Sie eine Loopback-Schnittstelle im Router, falls angegeben. Die Anzahl der IP-Adressen muss mit der Anzahl der TOR-Geräte übereinstimmen.

BgpPeer

BGPPeer definiert die Layer-3-Informationen auf der Peer-Seite zum Erstellen der BGP-Sitzung.

JSON-Darstellung
{
  "name": string,
  "interface": string,
  "interfaceIpv4Cidr": string,
  "interfaceIpv6Cidr": string,
  "peerIpv4Cidr": string,
  "peerIpv6Cidr": string,
  "peerAsn": integer,
  "localAsn": integer
}
Felder
name

string

Name dieses BGP-Peers. Eindeutig innerhalb der Ressource „Zones“.

interface

string

Name der RouterInterface, mit der der BGP-Peer verknüpft ist.

interfaceIpv4Cidr

string

IP-Bereich der Schnittstelle innerhalb von Google.

interfaceIpv6Cidr

string

IPv6-Bereich der Schnittstelle innerhalb von Google.

peerIpv4Cidr

string

IP-Bereich der BGP-Schnittstelle außerhalb von Google.

peerIpv6Cidr

string

IPv6-Bereich der BGP-Schnittstelle außerhalb von Google.

peerAsn

integer (uint32 format)

Autonome Systemnummer (ASN) des BGP-Peers. Für jede BGP-Schnittstelle kann ein anderer Wert verwendet werden.

localAsn

integer (uint32 format)

Nur Ausgabe. Lokale autonome Systemnummer (ASN) des BGP. Dieses Feld ist ST_NOT_REQUIRED, da es private ASNs speichert, die außerhalb der Zone, in der sie verwendet werden, keine Bedeutung haben.

Bgp

BGP-Informationen, die für diesen Router spezifisch sind.

JSON-Darstellung
{
  "asn": integer,
  "keepaliveIntervalInSeconds": integer
}
Felder
asn

integer (uint32 format)

Lokal zugewiesene BGP-ASN.

keepaliveIntervalInSeconds

integer (uint32 format)

Das Intervall in Sekunden zwischen BGP-Keepalive-Nachrichten, die an den Peer gesendet werden. Der Standardwert ist 20, der Wert liegt zwischen 20 und 60.

Methoden

create

Erstellt einen neuen Router in einem bestimmten Projekt und an einem bestimmten Standort.

delete

Löscht einen einzelnen Router.

diagnose

Diagnose einer einzelnen Routerressource abrufen.

get

Ruft Details zu einem einzelnen Router ab.

list

Listet Router in einem bestimmten Projekt und an einem bestimmten Standort auf.

patch

Aktualisiert die Parameter eines einzelnen Routers.