REST Resource: projects.locations.zones.routers

資源：Router

描述 Router 物件的訊息

JSON 表示法 
{
  "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
  ]
}
欄位
name

string

這是必要旗標，路由器的標準資源名稱。
createTime

string (Timestamp format)

僅供輸出。建立路由器時的時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

僅供輸出。上次更新路由器韌體的時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
labels

map (key: string, value: string)

與這個資源相關聯的標籤。

包含 "key": value 組合清單的物件，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
description

string

選用。資源的自由格式文字說明。長度上限為 1024 個字元。
network

string

這是必要旗標，這個路由器所屬網路的標準名稱。名稱格式為 projects/{project}/locations/{location}/zones/{zone}/networks/{network}。
interface[]

object (Interface)

路由器介面。
bgpPeer[]

object (BgpPeer)

BGP 對等互連。
bgp

object (Bgp)

這個路由器專屬的 BGP 資訊。
state

enum (ResourceState)

僅供輸出。透過設定推送將資源傳送至裝置的目前階段。
routeAdvertisements[]

string

選用。以 IP/長度格式表示的 CIDR 清單，可從這個路由器向北通告為靜態路徑。

介面

路由器介面會定義 GDCE 區域端的第 3 層資訊，用於建構 BGP 工作階段。

JSON 表示法 
{
  "name": string,
  "ipv4Cidr": string,
  "ipv6Cidr": string,
  "linkedInterconnectAttachment": string,
  "subnetwork": string,
  "loopbackIpAddresses": [
    string
  ]
}
欄位
name

string

這個介面項目的名稱。在「區域」資源中必須是唯一值。
ipv4Cidr

string

介面的 IP 位址和範圍。
ipv6Cidr

string

介面的 IPv6 位址和範圍。
linkedInterconnectAttachment

string

已連結互連網路附件的標準名稱。
subnetwork

string

這個介面所屬子網路資源的標準名稱。
loopbackIpAddresses[]

string

指定時，在路由器中建立迴路介面。IP 位址數量必須與 TOR 裝置數量相符。

BgpPeer

BGPPeer 會定義對等互連端的第 3 層資訊，用於建立 BGP 工作階段。

JSON 表示法 
{
  "name": string,
  "interface": string,
  "interfaceIpv4Cidr": string,
  "interfaceIpv6Cidr": string,
  "peerIpv4Cidr": string,
  "peerIpv6Cidr": string,
  "peerAsn": integer,
  "localAsn": integer
}
欄位
name

string

這個 BGP 對等互連的名稱。在「區域」資源中必須是唯一值。
interface

string

與 BGP 對等互連相關聯的 RouterInterface 名稱。
interfaceIpv4Cidr

string

Google 內介面的 IP 範圍。
interfaceIpv6Cidr

string

Google 內介面的 IPv6 範圍。
peerIpv4Cidr

string

Google 外部 BGP 介面的 IP 範圍。
peerIpv6Cidr

string

Google 外部 BGP 介面的 IPv6 範圍。
peerAsn

integer (uint32 format)

對等互連 BGP 自治系統編號 (ASN)。每個 BGP 介面可能使用不同的值。
localAsn

integer (uint32 format)

僅供輸出。本機 BGP 自治系統編號 (ASN)。這個欄位是 ST_NOT_REQUIRED，因為儲存的私人 ASN 在使用區域以外毫無意義。

Bgp

這個路由器專屬的 BGP 資訊。

JSON 表示法 
{
  "asn": integer,
  "keepaliveIntervalInSeconds": integer
}
欄位
asn

integer (uint32 format)

本機指派的 BGP ASN。
keepaliveIntervalInSeconds

integer (uint32 format)

此為向對等點傳送邊界閘道通訊協定 (BGP) 保持運作訊息的時間間隔 (單位為秒)。預設值為 20，值介於 20 到 60 之間。

方法

create

 在指定專案和位置建立新的路由器。

delete

 刪除單一路由器。

diagnose

 取得單一路由器資源的診斷資訊。

get

 取得單一路由器詳細資料。

list

 列出指定專案和位置中的路由器。

patch

 更新單一路由器的參數。