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)

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

RFC3339 世界標準時間「Zulu」格式的時間戳記，解析度達奈秒單位，最多九個小數位數。例如："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

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

RFC3339 世界標準時間「Zulu」格式的時間戳記，解析度達奈秒單位，最多九個小數位數。例如："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
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,
  "linkedInterconnectAttachment": string,
  "subnetwork": string,
  "loopbackIpAddresses": [
    string
  ]
}
欄位
name

string

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

string

介面的 IP 位址和範圍。只有在設定 linkedInterconnectAttachment 時，系統才會使用這個值。
linkedInterconnectAttachment

string

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

string

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

string

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

BgpPeer

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

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

string

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

string

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

string

Google 內介面的 IP 範圍。
peerIpv4Cidr

string

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

integer (uint32 format)

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

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

 更新單一路由器的參數。